Como: ativar registo de erros e de desempenho

  • Artigo

Importante

As versões do Microsoft Rights Management Service SDK lançadas antes de março de 2020 são depreciadas; as aplicações que utilizam versões anteriores devem ser atualizadas para utilizar a versão de março de 2020. Para mais detalhes, consulte o aviso de depreciação.

Não estão previstas mais melhorias para o Microsoft Rights Management Service SDK. Recomendamos vivamente a adoção do Proteção de Informações da Microsoft SDK para serviços de classificação, rotulagem e proteção.

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.

Descrição Geral

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.

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.

Nota

Como exemplo, eis uma mensagem padrão que a Microsoft utiliza para notificações de registos:

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.

Irá gerir o controlo de registo através de duas propriedades.

  • Ative o registo através da propriedade IpcCustomerExperienceDataCollectionEnabled. A definição resiste às reposições do dispositivo.

  • Controle o nível de registo através da propriedade IpcLogLevel ao utilizar as seguintes definições.

    • 1 – Verboso
    • 2 – Informativo
    • 3 – Aviso
    • 4 – Erro
    • 5 – Crítico

Em cada um dos fragmentos de código de exemplo que se seguem, a aplicação de chamada pode definir ou consultar a propriedade.

Android

Ativar o registo automático

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 registo

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

iOS

Ativar o registo automático

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

Obter a definição atual do sinalizador de controlo de registo

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

Definir o controlo do nível de registo

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

Obter a definição de controlo do nível de registo

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

Windows

Ativar o registo automático

CustomerExperienceConfiguration::Option = CustomerExperienceOptions::LoggingEnabledNow;

Para obter mais informações sobre definições opcionais, consulte CustomerExperienceOptions.

Obter a definição atual do sinalizador de controlo de registo

CustomerExperienceOptions loggingOption = CustomerExperienceConfiguration::Option;

Nota – Os recortes de código Windows acima são em C++. Para C#, atualize a sintaxe com '.' em vez de ‘::’.

Linux/C++ – Este SDK possui algum registo básico que não é tão extensivo como o de outras plataformas. Para mais informações, consulte a secção Resolução de problemas do "LEIAME.md" em SDK RMS para Portable C++.