Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Настройте отчеты о сбоях Firebase Crashlytics

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

В этом руководстве описывается, как настроить отчеты о сбоях с помощью Firebase Crashlytics SDK. По умолчанию Crashlytics автоматически собирает отчеты о сбоях для всех пользователей вашего приложения (вы можете отключить автоматические отчеты о сбоях и вместо этого включить отчеты по подписке для своих пользователей). Crashlytics предоставляет четыре механизма ведения журнала «из коробки»: настраиваемые ключи , настраиваемые журналы , идентификаторы пользователей и перехваченные исключения .

Добавить пользовательские ключи

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

  • На панели инструментов Crashlytics вы можете искать задачи, соответствующие пользовательскому ключу.
  • Когда вы просматриваете конкретную проблему в консоли, вы можете просматривать связанные пользовательские ключи для каждого события (подвкладка « Ключи ») и даже фильтровать события по пользовательским ключам (меню « Фильтр » в верхней части страницы).

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

Crashlytics.SetCustomKey(string key, string value);

Добавить пользовательские сообщения журнала

Зарегистрированные сообщения связаны с вашими данными о сбоях и отображаются на панели инструментов Firebase Crashlytics при просмотре определенного сбоя.

Crashlytics.Log(string message);

Установить идентификаторы пользователей

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

Crashlytics.SetUserId(string identifier);

Сообщить о нефатальных исключениях

Зарегистрируйте пользовательские исключения в C#, используя следующие методы:

Crashlytics.LogException(Exception ex);

Пользовательские исключения могут быть включены в блоки try/catch вашего приложения:

try {
    myMethodThatThrows();
} catch (Exception e) {
   Crashlytics.LogException(e);
   // handle your exception here!
}

Включить отчетность по подписке

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

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

Crashlytics.IsCrashlyticsCollectionEnabled = true

Управление данными Crash Insights

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

Crash Insights использует агрегированные данные о сбоях для определения общих тенденций стабильности. Если вы предпочитаете не делиться данными своего приложения, вы можете отказаться от Crash Insights в меню Crash Insights в верхней части списка проблем Crashlytics в консоли Firebase .