IKuznetsov: Новая страница: «= Сообщения об ошибках и сбоях = Мониторинг сбоев, ошибок '''ANR''' и других неполадок имеет решающее значение для обеспечения бесперебойной работы приложения. Эти проблемы могут привести к удалению приложения, негативным отзывам и потере доверия пользов...»

2026-08-19T16:49:02Z

Новая страница: «= Сообщения об ошибках и сбоях = Мониторинг сбоев, ошибок '''ANR''' и других неполадок имеет решающее значение для обеспечения бесперебойной работы приложения. Эти проблемы могут привести к удалению приложения, негативным отзывам и потере доверия пользов...»

Новая страница

= Сообщения об ошибках и сбоях =

Мониторинг сбоев, ошибок '''ANR''' и других неполадок имеет решающее значение для обеспечения бесперебойной работы приложения. Эти проблемы могут привести к удалению приложения, негативным отзывам и потере доверия пользователей. Проактивное обнаружение и устранение этих ошибок позволяет разработчикам повысить стабильность приложения и сохранить вовлеченность пользователей. Ключ-АСТРОМ предоставляет подробную информацию об этих ошибках, включая трассировку стека, сведения о сеансах и информацию, специфичную для устройства, что позволяет быстро выявлять первопричины и внедрять исправления.

== Автоматическая система отчетности о сбоях ==

ЕдиныйАгент перехватывает все необработанные исключения. Отчет о сбое включает время возникновения и полную трассировку стека исключения.

Как правило, информация о сбое отправляется сразу после его возникновения, поэтому пользователю не нужно перезапускать приложение. Однако в некоторых случаях приложение следует открыть повторно в течение 10 минут, чтобы отчет о сбое был отправлен. Обратите внимание, что Ключ-АСТРОМ не отправляет отчеты о сбоях, которым более 10 минут (поскольку такие отчеты больше не могут быть сопоставлены в кластере Ключ-АСТРОМ).

Вы можете отключить отправку отчетов об ошибках с помощью соответствующего свойства <code>crashReporting</code>.

=== Настройка через Groovy DSL ===

<pre>
astromkey {
configurations {
sampleConfig {
crashReporting false
}
}
}
</pre>

=== Настройка через Kotlin DSL ===

<pre>
configure<com.astromkey.tools.android.dsl.AstromkeyExtension> {
configurations {
create("sampleConfig") {
crashReporting(false)
}
}
}
</pre>

== ANR ==

ЕдиныйАгент сообщает об ошибках '''ANR''' только на устройствах с '''Android''' 11 и выше. На более старых версиях '''Android''' событие ошибки '''ANR''' недоступно.

Эти события отправляются только в том случае, если пользователь перезапускает мобильное приложение в течение 10 минут.

С помощью '''RUM''' Ключ-АСТРОМ автоматически фиксирует ошибки «Приложение не отвечает» ('''ANR'''). Мониторинг ошибок '''ANR''' крайне важен, поскольку они вызывают недовольство пользователя. Основная проблема заключается в том, что основной поток приложения, отвечающий за обновление пользовательского интерфейса, не может обрабатывать события ввода пользователя или отрисовывать изображение, что приводит к закрытию приложения. В официальной документации '''Android''' приведены примеры и способы диагностики этих ошибок.

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

=== Отключение при ручном запуске агента ===

'''Kotlin'''
<pre>
Astromkey.startup(this, AstromkeyConfigurationBuilder("<YourApplicationID>", "<ProvidedBeaconUrl>")
.withAnrReporting(false)
.buildConfiguration()
)
</pre>

'''Java'''
<pre>
Astromkey.startup(this, new AstromkeyConfigurationBuilder("<YourApplicationID>", "<ProvidedBeaconUrl>")
.withAnrReporting(false)
.buildConfiguration()
);
</pre>

=== Отключение через Gradle DSL ===

'''Groovy'''
<pre>
astromkey {
configurations {
sampleConfig {
anrReporting false
}
}
}
</pre>

'''Kotlin'''
<pre>
configure<com.astromkey.tools.android.dsl.AstromkeyExtension> {
configurations {
create("sampleConfig") {
anrReporting(false)
}
}
}
</pre>

=== Ограничения ===

* '''Несколько ошибок ANR в одной сессии''' — в редких случаях может произойти несколько ошибок '''ANR''' до перезапуска приложения. Ключ-АСТРОМ будет отправлять отдельные события для каждой ошибки '''ANR''', даже если они относятся к одной и той же сессии.
* '''Неизвестные случаи ANR''' — в некоторых случаях '''ANR''' может отсутствовать четкая информация о типе или субъекте. Тем не менее, такие случаи сообщаются с учетом имеющейся информации.
* '''Системные ограничения''' — качество данных '''ANR''' определяется операционной системой '''Android'''. Отсутствие трассировок стека или неполные данные о субъектах могут возникать из-за: перезаписи общего хранилища для трассировок, серьезных сбоев (например, повреждения памяти), поведения пользовательской прошивки.

== Сбои нативных приложений ==

ЕдиныйАгент сообщает о сбоях нативных приложений только на устройствах с '''Android''' 11 или выше. На более старых версиях '''Android''' событие «Сбой нативного приложения» недоступно.

Эти события отправляются только в том случае, если пользователь перезапускает мобильное приложение в течение 10 минут.

Сбои, вызванные нативными компонентами, — это сбои, возникающие в коде '''C/C++''', добавленном через '''NDK'''. В официальной документации '''Android''' приведены примеры и способы их диагностики.

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

=== Отключение при ручном запуске агента ===

'''Kotlin'''
<pre>
Astromkey.startup(this, AstromkeyConfigurationBuilder("<YourApplicationID>", "<ProvidedBeaconUrl>")
.withNativeCrashReporting(false)
.buildConfiguration()
)
</pre>

'''Java'''
<pre>
Astromkey.startup(this, new AstromkeyConfigurationBuilder("<YourApplicationID>", "<ProvidedBeaconUrl>")
.withNativeCrashReporting(false)
.buildConfiguration()
);
</pre>

=== Отключение через Gradle DSL ===

'''Groovy'''
<pre>
astromkey {
configurations {
sampleConfig {
nativeCrashReporting false
}
}
}
</pre>

'''Kotlin'''
<pre>
configure<com.astromkey.tools.android.dsl.AstromkeyExtension> {
configurations {
create("sampleConfig") {
nativeCrashReporting(false)
}
}
}
</pre>

=== Ограничения ===

* '''Пустые трассировки стека''' — в некоторых случаях система '''Android''' может возвращать нулевую трассировку стека из-за перезаписанного общего хранилища, серьезных сбоев (например, поврежденной библиотеки libc) и поведения пользовательской прошивки.
* '''Множественные сбои в течение одной сессии''' — если до перезапуска приложения происходит несколько сбоев в работе нативных приложений, Ключ-АСТРОМ отправит отдельные события для каждого сбоя.

== Сообщение об ошибках вручную ==

Для ошибок, которые вы обрабатываете в своем коде, но которые все же хотите сообщать в Ключ-АСТРОМ, используйте API для ручного создания отчетов.

Используйте <code>Astromkey.sendExceptionEvent(ExceptionEventData exceptionEventData)</code> для сообщения об исключениях с полным контекстом и пользовательскими свойствами:

'''Kotlin'''
<pre>
try {
// код, который может вызвать исключение
} catch (exception: Exception) {
Astromkey.sendExceptionEvent(
ExceptionEventData(exception)
.addEventProperty("event_properties.<YourPropertyName>", "<YourPropertyValue>")
)
}
</pre>

'''Java'''
<pre>
try {
// код, который может вызвать исключение
} catch (Exception exception) {
Astromkey.sendExceptionEvent(
new ExceptionEventData(exception)
.addEventProperty("event_properties.<YourPropertyName>", "<YourPropertyValue>")
);
}
</pre>

Сообщения об ошибках и сбоях - История изменений