Поддержка и ограничения

Материал из Документация Ключ-АСТРОМ

Поддержка и ограничения

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

Поддерживаемые версии

Требование Минимальная версия
Уровень API Android 23
Gradle 8.0
Плагин Android Gradle 8.1.1
Java 17
Kotlin 2.1.0
Jetpack Compose 1.4 - 1.10

Ограничения

  • HttpURLConnection и HTTP-запросы — Автоматически инструментируются только веб-запросы от фреймворков OkHttp (включая фреймворки, основанные на этих фреймворках); веб-запросы от других фреймворков необходимо инструментировать вручную.
  • Для протоколов WebSocket и не-HTTP требуется ручная инструментация запросов WebSocket (ws://, wss://) и других не-HTTP протоколов.
  • Инструментированные файлы — Плагин Ключ-АСТРОМ Android Gradle инструментирует только файлы AndroidManifest.xml и .class. Он не инструментирует следующие компоненты:
    • Нативный код — код, написанный с использованием NDK, не подвергается инструментированию.
    • Веб-компоненты — файлы, такие как .html и .js, не подвергаются инструментированию.
    • Файлы ресурсов — .xml файлы макета и другие файлы ресурсов не подвергаются инструментальной обработке.
  • Ограничения, специфичные для конкретной сборки.
    • Возможны проблемы совместимости с другими плагинами мониторинга производительности, особенно если эти плагины используют ЕдиныйАгент для Android. Мы рекомендуем либо использовать только один плагин мониторинга производительности, либо проверить совместимость выбранных вами плагинов с помощью ручного тестирования.
    • Проекты библиотек Android — плагин Ключ-АСТРОМ Android Gradle автоматически инструментирует только проекты приложений Android. Он не поддерживает автоматическую инструментацию автономных проектов библиотек Android. Внутренние библиотеки автоматически инструментируются при добавлении в качестве зависимости к вашему проекту приложения Android.
    • Свойство excludes плагина Android Gradle — с помощью этого свойства плагина Android Gradle можно отключить инструментирование для определенных классов. Это свойство аналогично свойству плагина Ключ-АСТРОМ для Android Gradle. Однако при использовании свойства Ключ-АСТРОМ наш плагин по-прежнему инструментирует некоторые очень важные классы, чтобы гарантировать, что инструментирование всегда корректно. При использовании свойства Android инструментирование не выполняется для всех указанных классов, что может негативно повлиять на инструментирование.
    • Инструменты обфускации от третьих лиц — ЕдиныйАгент для Android и его транзитивные зависимости предоставляют правила ProGuard, разработанные для R8. Если вы используете сторонние инструменты обфускации вместо R8, вы несете ответственность за их настройку для соблюдения необходимых правил сохранения. Несоблюдение этого требования может привести к ошибкам во время выполнения из-за неправильно обфусцированных классов. Если вы используете функции плагина Android Gradle, например, для фильтрации правил сохранения зависимостей, имейте в виду, что это может повлиять на функциональность ЕдиногоАгента.

Ограничения событий

  • Количество событий в минуту — существует ограничение на количество событий, которые могут быть сгенерированы за одну минуту. Превышение этого лимита может привести к тому, что события будут отброшены или не обработаны. Лимит по умолчанию составляет 1000 событий в минуту.
  • Свойства события и сессии.

Поиск неисправностей

Для устранения неполадок, связанных с мониторингом мобильных приложений, обратитесь к следующим ресурсам:

  • Устранение неполадок RUM для мобильных приложений — Общие рекомендации по устранению неполадок RUM в мобильных приложениях.

Получить поддержку

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

Сообщить об ошибке

Чтобы сообщить об ошибке или открыть заявку в службу поддержки:

  1. Перейдите на сайт support.astromkey.com.
  2. Создайте заявку в службу поддержки, указав следующую информацию:
    • Ваша конфигурация Gradle (с удаленными конфиденциальными данными).
    • Журналы отладки из ЕдиногоАгента (см. раздел «Включение ведения журналов отладки»).
    • Версия ЕдиногоАгента.
    • Версия операционной системы и модель устройства.
    • Версии Android Studio и Gradle.
    • Шаги для воспроизведения проблемы.
    • Любые сообщения об ошибках или трассировки стека.

Сообщество

Сообщество Ключ-АСТРОМ: Мониторинг реальных пользователей.

Источник — https://doc.ruscomtech.ru/index.php?title=Поддержка_и_ограничения&oldid=6580