Comment : activer la journalisation des erreurs et des performancesHow to: Enable error and performance logging

Microsoft Rights Management SDK 4.2 gère le chargement des journaux de diagnostic et de performances via une propriété d’appareil unique.The Microsoft Rights Management SDK 4.2 manages diagnosis and performance logs upload through a single device property.

Vue d’ensembleOverview

## Vous pouvez améliorer l’expérience de vos utilisateurs et faciliter la résolution de leurs problèmes en activant le chargement automatique des données des journaux de diagnostic, de performances et de télémétrie vers Microsoft.You can improve your users' experience and troubleshooting by enabling automatic diagnostics, performance, and telemetry logging data upload to Microsoft.

Important

Afin de respecter la confidentialité de l’utilisateur, en tant que développeur d’applications, vous devez lui demander son consentement avant d’activer la journalisation automatique.In order to honor user privacy, you as the app developer, must ask the user to consent before enabling the automatic logging.

Note

À titre d’exemple, voici un message standard que Microsoft utilise pour la notification de journalisation :As example, here is a standard message Microsoft uses for logging notification:

En activant la journalisation des erreurs et des performances, vous acceptez d’envoyer les données des erreurs et des performances à Microsoft. Microsoft collecte les données des erreurs et des performances via Internet (« Données »). Microsoft utilise ces données pour fournir et améliorer la qualité, la sécurité et l’intégrité des produits et des services Microsoft. Par exemple, nous analysons les performances et la fiabilité, comme les fonctionnalités que vous utilisez, la rapidité de réponse des fonctionnalités, les performances de l’appareil, les interactions de l’interface utilisateur et tous les problèmes que vous rencontrez avec le produit. Les données incluent également des informations sur la configuration de votre logiciel, comme le logiciel en cours d’exécution et l’adresse IP.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 will also include information about the configuration of your software like the software you are currently running, and the IP address.

Vous allez gérer le contrôle de la journalisation via deux propriétés.You will manager logging control through two properties.

  • Activez la journalisation via la propriété IpcCustomerExperienceDataCollectionEnabled.Enable logging through the IpcCustomerExperienceDataCollectionEnabled property. Le paramètre est persistant entre les réinitialisations de l’appareil.The setting is persistent across device resets.
  • Contrôlez le niveau de journalisation via la propriété IpcLogLevel à l’aide des paramètres suivants.Control the logging level through the IpcLogLevel property using the following settings.

    • 1 : Commentaires1 - Verbose
    • 2 : Informations2 - Informational
    • 3 : Avertissement3 - Warning
    • 4 : Erreur4 - Error
    • 5 : Critique5 - Critical

Dans chacun des exemples d’extraits de code suivants, l’application appelante peut définir ou interroger la propriété.In each of the example code snippets following, the calling application can set or query the property.

AndroidAndroid

### Activer la journalisation automatiqueEnable automatic logging

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

Obtenir le paramètre d’indicateur de contrôle de la journalisation en coursGet current logging control flag setting

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

iOSiOS

## Activer la journalisation automatiqueEnable automatic logging

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

Obtenir le paramètre d’indicateur de contrôle de la journalisation en coursGet current logging control flag setting

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

Définir le contrôle de niveau de journalisationSet log level control

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

Obtenir le paramètre de contrôle de niveau de journalisationGet log level control setting

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

WindowsWindows

## Activer la journalisation automatiqueEnable automatic logging

CustomerExperienceConfiguration::Option = CustomerExperienceOptions::LoggingEnabledNow;

Pour plus d’informations sur les paramètres facultatifs, consultez CustomerExperienceOptions.For more information on optional settings, see CustomerExperienceOptions.

Obtenir le paramètre d’indicateur de contrôle de la journalisation en coursGet current logging control flag setting

CustomerExperienceOptions loggingOption = CustomerExperienceConfiguration::Option;

Remarque : Les extraits de code Windows ci-dessus sont en C++.Note - The Windows code snips above are in C++. Pour C#, mettez à jour la syntaxe avec « . »For C#, update the syntax with ‘.’ à la place de « :: ».in place of ‘::’.

Linux / C++ : Ce SDK présente une journalisation de base qui n’est pas aussi complète que celle des autres plateformes.Linux / C++ - This SDK has some basic logging that is not as extensive as that of the other platforms. Pour plus d’informations, consultez la section Dépannage de « README.md » dans RMS SDK pour C++ portable.For more information see the Troubleshooting section of the "README.md" at RMS SDK for portable C++.

CommentairesComments

Avant de transmettre vos commentaires, nous vous demandons de consulter notre règlement interne.Before commenting, we ask that you review our House rules.