Поделиться через

Активация журнала ошибок и производительности

  • Статья

Важно!

Версии пакета SDK службы microsoft Rights Management, выпущенные до марта 2020 г., устарели; Для использования выпуска за март 2020 г. необходимо обновить приложения, использующие более ранние версии. Подробные сведения см. в уведомлении об устаревании.

Для пакета SDK службы Microsoft Rights Management не планируется никаких дополнительных улучшений. Настоятельно рекомендуем внедрить пакет SDK для Microsoft Information Protection для служб классификации, маркировки и защиты.

Пакет SDK 4.2 службы Microsoft Rights Management управляет отправкой журналов диагностики и производительности при помощи одного свойства устройств.

Общие сведения

Отправка данных автоматического журнала диагностики, производительности и телеметрии в корпорацию Майкрософт позволяет повысить удобство работы и эффективность устранения неполадок.

Важно!

Чтобы соблюдать конфиденциальность пользователей, разработчику приложения необходимо запрашивать у пользователя разрешение на включение автоматического ведения журнала.

Примечание

В качестве примера ниже приведено стандартное сообщение, используемое корпорацией Майкрософт для уведомления о ведении журнала:

Включая ведение журнала ошибок и производительности, вы соглашаетесь на отправку данных о производительности и ошибках в корпорацию Майкрософт. Корпорация Майкрософт собирает данные об ошибках и производительности ("Данные") через Интернет. Корпорация Майкрософт использует эти Данные для обеспечения и повышения качества, безопасности и целостности продуктов и служб корпорации Майкрософт. Например, мы осуществляем анализ производительности и надежности, включая определение компонентов, которые вы используете, скорость ответа компонентов, производительность устройства, взаимодействие пользователя с интерфейсом и любые проблемы, возникающие с продуктом. Данные также будут включать сведения о конфигурации программного обеспечения (например, сведения об используемых сейчас программах) и IP-адресе.

Управлять ведением журнала можно с использованием двух свойств.

  • Ведение журнала активируется при помощи свойства IpcCustomerExperienceDataCollectionEnabled. Этот параметр не изменяется после перезагрузки устройства.

  • Уровнем ведения журнала можно управлять с помощью свойства IpcLogLevel, используя указанные ниже параметры.

    • 1 — подробные сведения;
    • 2 — сведения;
    • 3 — предупреждение;
    • 4 — ошибка;
    • 5 — критическая ошибка.

В каждом из указанных ниже примеров фрагментов кода вызывающее приложение может задать свойство или подать запрос на него.

Android

Включение автоматического ведения журнала

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

Получение текущего параметра установки флагов управления ведением журнала

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

iOS

Включение автоматического ведения журнала

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

Получение текущего параметра установки флагов управления ведением журнала

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

Настройка управления уровнем ведения журнала

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

Получение параметра управления уровнем ведения журнала

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

Windows

Включение автоматического ведения журнала

CustomerExperienceConfiguration::Option = CustomerExperienceOptions::LoggingEnabledNow;

Подробные сведения о дополнительных параметрах см. в статье CustomerExperienceOptions.

Получение текущего параметра установки флагов управления ведением журнала

CustomerExperienceOptions loggingOption = CustomerExperienceConfiguration::Option;

Примечание. Фрагменты кода Windows, представленные выше, написаны на языке C++. Для C# обновите синтаксис на ". ".".

Linux / C++ — функция базового ведения журнала в этом пакете SDK не настолько расширена, как для других платформ. Дополнительные сведения см. в разделе Устранение неполадок файла README.md статьи RMS SDK for portable C++ (Пакет SDK службы RMS для переносимого кода C++).