Vorgehensweise: Aktivieren der Fehler- und Leistungsprotokollierung

Von Bedeutung

Versionen des Microsoft Rights Management Service SDK, das vor März 2020 veröffentlicht wurde, sind veraltet; Anwendungen, die frühere Versionen verwenden, müssen aktualisiert werden, um die Version vom März 2020 zu verwenden. Ausführliche Informationen finden Sie im Hinweis zur Außerkraftsetzung .

Für das Microsoft Rights Management Service SDK sind keine weiteren Verbesserungen geplant. Wir empfehlen dringend die Einführung des Microsoft Information Protection SDK für Klassifizierung, Bezeichnung und Schutzdienste.

Das Microsoft Rights Management SDK 4.2 verwaltet Diagnose- und Leistungsprotokolle, die über eine einzelne Geräteeigenschaft hochgeladen werden.

Überblick

Sie können die Benutzerfreundlichkeit und -problembehandlung verbessern, indem Sie automatische Diagnose-, Leistungs- und Telemetrieprotokollierungsdaten zum Hochladen an Microsoft aktivieren.

Von Bedeutung

Um den Datenschutz des Benutzers zu berücksichtigen, müssen Sie als App-Entwickler den Benutzer bitten, seine Zustimmung zu erteilen, bevor die automatische Protokollierung aktiviert wird.

Hinweis

Im Folgenden sehen Sie beispielsweise eine Standardnachricht, die Microsoft für die Protokollierungsbenachrichtigung verwendet:

Durch Aktivieren der Fehler- und Leistungsprotokollierung stimmen Sie dem Senden von Fehler- und Leistungsdaten an Microsoft zu. Microsoft erfasst Fehler- und Leistungsdaten über das Internet („Daten“). Microsoft verwendet diese Daten, um die Qualität, Sicherheit und Integrität von Microsoft-Produkten und -Diensten sicherzustellen und zu verbessern. Beispielsweise analysieren wir die Leistung und Zuverlässigkeit wie die von Ihnen verwendeten Features, deren Reaktionsschnelligkeit, die Geräteleistung, Interaktionen mit der Benutzeroberfläche und etwaige Probleme, die bei der Nutzung des Produkts auftreten. Zu den Daten gehören auch Informationen zur Konfiguration Ihrer Software, z. B. der Software, die zurzeit ausgeführt wird, und die IP-Adresse.

Sie führen die Protokollierungssteuerung über zwei Eigenschaften durch.

  • Aktivieren Sie die Protokollierung über die IpcCustomerExperienceDataCollectionEnabled-Eigenschaft . Die Einstellung bleibt bei Zurücksetzungen von Geräten bestehen.

  • Steuern Sie die Protokollierungsebene über die IpcLogLevel-Eigenschaft mithilfe der folgenden Einstellungen.

    • 1 - Ausführlich
    • 2 - Informativ
    • 3 – Warnung
    • 4 – Fehler
    • 5 – Kritisch

In jedem der folgenden Beispielcodeausschnitte kann die aufrufende Anwendung die Eigenschaft festlegen oder abfragen.

Android

Aktivieren der automatischen Protokollierung

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

Aktuelle Protokollierungssteuerungskennzeichnungseinstellung abrufen

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

Ios

Aktivieren der automatischen Protokollierung

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

Aktuelle Einstellung der Protokollierungssteuerungsflagge abrufen

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

Festlegen des Steuerelements auf Protokollebene

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

Einstellung der Steuerung auf Protokollebene abrufen

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

Fenster

Aktivieren der automatischen Protokollierung

CustomerExperienceConfiguration::Option = CustomerExperienceOptions::LoggingEnabledNow;

Weitere Informationen zu optionalen Einstellungen finden Sie unter CustomerExperienceOptions.

Aktuelle Einstellung der Protokollierungssteuerungsflagge abrufen

CustomerExperienceOptions loggingOption = CustomerExperienceConfiguration::Option;

Hinweis : Die oben genannten Windows-Code-Snips befinden sich in C++. Aktualisieren Sie für C# die Syntax mit '.' anstelle von '::'.

Linux / C++ - Dieses SDK verfügt über einige grundlegende Protokollierung, die nicht so umfangreich ist wie die der anderen Plattformen. Weitere Informationen finden Sie im Abschnitt "Problembehandlung " des "README.md" im RMS SDK für portable C++.

  • Zuletzt aktualisiert um