Udostępnij za pośrednictwem

Instrukcje: włączanie rejestrowania błędów i wydajności

  • Artykuł

Ważne

Wersje zestawu Microsoft Rights Management Service SDK wydane przed marcem 2020 r. są przestarzałe; aplikacje korzystające z wcześniejszych wersji muszą zostać zaktualizowane w celu korzystania z wersji z marca 2020 r. Aby uzyskać szczegółowe informacje, zobacz powiadomienie o wycofaniu.

Zestaw SDK usługi Microsoft Rights Management nie planuje dalszych ulepszeń. Zdecydowanie zalecamy wdrożenie zestawu SDK Microsoft Information Protection na potrzeby klasyfikacji, etykietowania i usług ochrony.

Zestaw Microsoft Rights Management SDK 4.2 zarządza przekazywaniem dzienników diagnostyki i wydajności za pośrednictwem pojedynczej właściwości urządzenia.

Omówienie

Włączenie automatycznego przekazywania danych dzienników diagnostyki, wydajności i telemetrii do firmy Microsoft pozwala zwiększyć komfort pracy użytkowników i usprawnić rozwiązywanie problemów.

Ważne

Aby chronić prywatność użytkowników, przed włączeniem automatycznego rejestrowania deweloper aplikacji musi poprosić użytkownika o zgodę.

Uwaga

Poniżej jako przykład przedstawiamy standardową wiadomość używaną przez firmę Microsoft w przypadku powiadamiania o rejestrowaniu:

Włączając rejestrowanie błędów i wydajności, zgadzasz na wysyłanie do firmy Microsoft informacji o błędach i wydajności. Firma Microsoft będzie automatycznie zbierać dane dotyczące błędów i wydajności w Internecie („Dane”). Firma Microsoft używa tych Danych w celu zapewniania i zwiększania jakości, bezpieczeństwa i integralności swoich produktów i usług. Na przykład analizujemy wydajność i niezawodność, sprawdzając, jakich funkcji używasz, jak szybko funkcje reagują, jaka jest wydajność urządzenia, jakie są interakcje z interfejsem użytkownika oraz jakie problemy wystąpiły podczas pracy z produktem. Dane będą również zawierać informacje o konfiguracji oprogramowania, takie jak aktualnie działające oprogramowanie i adres IP.

Do zarządzania rejestrowaniem służą dwie właściwości.

  • Można włączyć rejestrowanie za pośrednictwem właściwości IpcCustomerExperienceDataCollectionEnabled. To ustawienie jest zachowywane po zresetowaniu urządzenia.

  • Poziomem rejestrowania można sterować za pośrednictwem właściwości IpcLogLevel przy użyciu poniższych ustawień.

    • 1 — pełny
    • 2 — informacyjny
    • 3 — ostrzeżenie
    • 4 — błąd
    • 5 — krytyczny

W każdym z poniższych przykładowych fragmentów kodu aplikacja wywołująca może ustawić właściwość lub wykonać zapytanie dotyczące tej właściwości.

Android

Włączanie automatycznego rejestrowania

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

Pobieranie bieżącego ustawienia flagi kontroli rejestrowania

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

iOS

Włączanie automatycznego rejestrowania

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

Pobieranie bieżącego ustawienia flagi kontroli rejestrowania

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

Ustawianie kontroli poziomu dziennika

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

Pobieranie ustawienia kontroli poziomu dziennika

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

Windows

Włączanie automatycznego rejestrowania

CustomerExperienceConfiguration::Option = CustomerExperienceOptions::LoggingEnabledNow;

Więcej informacji o ustawieniach opcjonalnych można znaleźć w sekcji dotyczącej elementu CustomerExperienceOptions.

Pobieranie bieżącego ustawienia flagi kontroli rejestrowania

CustomerExperienceOptions loggingOption = CustomerExperienceConfiguration::Option;

Uwaga: kod przedstawiony powyżej jest napisany w języku C++. W przypadku języka C# zaktualizuj składnię za pomocą znaku "". zamiast „::”.

Linux / C++: ten zestaw SDK udostępnia podstawowe funkcje rejestrowania, ale nie są one tak zaawansowane jak w przypadku innych platform. Aby uzyskać więcej informacji, zobacz sekcję dotyczącą rozwiązywania problemów związanych z plikiem „README.md” na stronie RMS SDK for portable C++ (Zestaw RMS SDK dla przenośnego kodu C++).