Postupy: Povolení protokolování chyb a výkonu

  • Článek

Důležité

Verze sady SDK služby Microsoft Rights Management vydané před březnem 2020 jsou zastaralé; aplikace používající starší verze musí být aktualizovány, aby používaly verzi z března 2020. Úplné podrobnosti najdete v oznámení o vyřazení.

Pro sadu SDK služby Microsoft Rights Management Service se neplánují žádná další vylepšení. Důrazně doporučujeme přijmout sadu Microsoft Information Protection SDK pro klasifikaci, popisky a služby ochrany.

Sada Microsoft Rights Management SDK 4.2 spravuje nahrávání protokolů diagnostiky a výkonu prostřednictvím jedné vlastnosti zařízení.

Přehled

Práci uživatelů a řešení potíží můžete zlepšit povolením odesílání dat automatického protokolování diagnostiky, výkonu a telemetrie do Microsoftu.

Důležité

V rámci zajištění ochrany osobních údajů uživatele je nutné, abyste jako vývojáři aplikace požádali uživatele o souhlas před tím, než povolíte automatické protokolování.

Poznámka

Jako příklad tady uvádíme standardní zprávu, kterou Microsoft používá k oznámení protokolování:

By turning on Error and Performance Logging, you are agreeing to send Error and Performance Data to Microsoft. Microsoft will collect error and performance data over the internet (“Data”). Microsoft uses this Data to provide and improve the quality, security and integrity of Microsoft products and services. For example, we analyze performance and reliability, such as what features you use, how quickly the features respond, device performance, user interface interactions, and any problems you experience with the product. Data budou také zahrnovat informace o konfiguraci softwaru, například softwaru, který aktuálně používáte, a IP adresu.

Řízení protokolování budete spravovat prostřednictvím dvou vlastností.

  • Protokolování lze povolit prostřednictvím vlastnosti IpcCustomerExperienceDataCollectionEnabled. Toto nastavení přetrvá i po resetování zařízení.

  • Úroveň protokolování lze řídit prostřednictvím vlastnosti IpcLogLevel, a to pomocí následujících nastavení.

    • 1 – Podrobnosti
    • 2 – Informativní
    • 3 – Upozornění
    • 4 – Chyba
    • 5 – Kritické

V každém z následujících fragmentů kódu může volající aplikace nastavit nebo dotazovat vlastnost.

Android

Povolení automatického protokolování

SharedPreferences preferences = PreferenceManager.getDefaultSharedPreferences(context);
SharedPreferences.Editor editor = preferences.edit();
editor.putBoolean("IpcCustomerExperienceDataCollectionEnabled", true);
editor.commit();

Získání aktuálního nastavení příznaku řízení protokolování

SharedPreferences preferences = PreferenceManager.getDefaultSharedPreferences(context);
Boolean isLogUploadEnabled = preferences.getBoolean("IpcCustomerExperienceDataCollectionEnabled", false);

iOS

Povolení automatického protokolování

NSUserDefaults \*prefs = [NSUserDefaults standardUserDefaults];
    [prefs setBool:FALSE forKey:@"IpcCustomerExperienceDataCollectionEnabled"];
    [[NSUserDefaults standardUserDefaults] synchronize];

Získání aktuálního nastavení příznaku řízení protokolování

[[NSUserDefaults standardUserDefaults] boolForKey:@"IpcCustomerExperienceDataCollectionEnabled"];

Nastavení řízení úrovně protokolování

NSUserDefaults \*prefs = [NSUserDefaults standardUserDefaults];
    [prefs setInteger:1 forKey:@"IpcLogLevel"];
    [[NSUserDefaults standardUserDefaults] synchronize];

Získání nastavení řízení úrovně protokolování

[[NSUserDefaults standardUserDefaults] boolForKey:@"IpcLogLevel"];

Windows

Povolení automatického protokolování

CustomerExperienceConfiguration::Option = CustomerExperienceOptions::LoggingEnabledNow;

Další informace o volitelném nastavení naleznete v tématu CustomerExperienceOptions.

Získání aktuálního nastavení příznaku řízení protokolování

CustomerExperienceOptions loggingOption = CustomerExperienceConfiguration::Option;

Poznámka – Výše uvedené výstřižky kódu systému Windows jsou v jazyce C++. V případě jazyka C# aktualizujte syntaxi na "." namísto znaků „::“.

Linux / C++ – Tato sada SDK obsahuje určité základní protokolování, které není tak rozsáhlé jako u jiných platforem. Další informace naleznete v části Řešení potíží v „README.md“ v sadě RMS SDK pro přenosný jazyk C++.