Como: ativar registo de erros e de desempenhoHow to: Enable error and performance logging

O SDK Microsoft Rights Management 4.2 gere o carregamento de registos de diagnóstico e de desempenho através de uma propriedade de único dispositivo.The Microsoft Rights Management SDK 4.2 manages diagnosis and performance logs upload through a single device property.

Descrição GeralOverview

Pode melhorar a experiência e resolução de problemas dos utilizadores ao permitir o carregamento de diagnósticos automáticos, registos de telemetria e desempenho para a Microsoft.You can improve your users' experience and troubleshooting by enabling automatic diagnostics, performance, and telemetry logging data upload to Microsoft.

Importante

Para honrar a privacidade do utilizador, na qualidade de programador da aplicação, deve pedir consentimento ao utilizador antes de ativar o registo automático.In order to honor user privacy, you as the app developer, must ask the user to consent before enabling the automatic logging.

Nota

Como exemplo, eis uma mensagem padrão que a Microsoft utiliza para notificações de registos:As example, here is a standard message Microsoft uses for logging notification:

Ao ativar os Registos de Desempenho e de Erros, está a concordar em enviar Dados de Desempenho e de Erros para a Microsoft. A Microsoft irá recolher dados de desempenho e de erros através da Internet ("Dados"). A Microsoft utiliza estes Dados para fornecer e melhorar a qualidade, segurança e integridade dos produtos e serviços da Microsoft. Por exemplo, analisamos o desempenho e a fiabilidade, como as funcionalidades que utiliza, o tempo de resposta das funcionalidades, o desempenho do dispositivo, as interações de interface de utilizador e os problemas que possa ter com o produto. Os Dados também incluirão informações acerca da configuração do seu software, como o software que está a utilizar atualmente e o endereço 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.

Irá gerir o controlo de registo através de duas propriedades.You will manager logging control through two properties.

  • Ative o registo através da propriedade IpcCustomerExperienceDataCollectionEnabled.Enable logging through the IpcCustomerExperienceDataCollectionEnabled property. A definição resiste às reposições do dispositivo.The setting is persistent across device resets.
  • Controle o nível de registo através da propriedade IpcLogLevel ao utilizar as seguintes definições.Control the logging level through the IpcLogLevel property using the following settings.

    • 1 – Verboso1 - Verbose
    • 2 – Informativo2 - Informational
    • 3 – Aviso3 - Warning
    • 4 – Erro4 - Error
    • 5 – Crítico5 - Critical

Em cada um dos fragmentos de código de exemplo que se seguem, a aplicação de chamada pode definir ou consultar a propriedade.In each of the example code snippets following, the calling application can set or query the property.

AndroidAndroid

Ativar o registo automáticoEnable automatic logging

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

Obter a definição atual do sinalizador de controlo de registoGet current logging control flag setting

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

iOSiOS

Ativar o registo automáticoEnable automatic logging

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

Obter a definição atual do sinalizador de controlo de registoGet current logging control flag setting

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

Definir o controlo do nível de registoSet log level control

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

Obter a definição de controlo do nível de registoGet log level control setting

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

WindowsWindows

Ativar o registo automáticoEnable automatic logging

CustomerExperienceConfiguration::Option = CustomerExperienceOptions::LoggingEnabledNow;

Para obter mais informações sobre definições opcionais, consulte CustomerExperienceOptions.For more information on optional settings, see CustomerExperienceOptions.

Obter a definição atual do sinalizador de controlo de registoGet current logging control flag setting

CustomerExperienceOptions loggingOption = CustomerExperienceConfiguration::Option;

Nota – Os recortes de código Windows acima são em C++.Note - The Windows code snips above are in C++. Para C#, atualize a sintaxe com ‘.’For C#, update the syntax with ‘.’ em vez de ‘::’.in place of ‘::’.

Linux/C++ – Este SDK possui algum registo básico que não é tão extensivo como o de outras plataformas.Linux / C++ - This SDK has some basic logging that is not as extensive as that of the other platforms. Para mais informações, consulte a secção Resolução de problemas do "LEIAME.md" em SDK RMS para Portable C++.For more information see the Troubleshooting section of the "README.md" at RMS SDK for portable C++.

ComentáriosComments

Antes de inserir um comentário, pedimos-lhe que reveja as nossas Regras básicas.Before commenting, we ask that you review our House rules.