Часто задаваемые вопросы о плагине Astromkey для Android Gradle

Узнайте, как решить проблемы, связанные с мониторингом мобильных приложений Android.

Общий

Что означает `Max. количество действий пользователя в минуту превышено` означает сообщение?

Макс. количество действий пользователя в минуту превышено» информирует вас о том, что количество действий пользователя, сгенерированных с помощью Real User Monitoring (Web, Mobile и OpenKit), превысило ограничение, характерное для вашей среды. Как только этот предел достигнут, Ключ-АСТРОМ автоматически ограничивает количество захватываемых пользовательских сеансов до тех пор, пока количество действий пользователя снова не станет ниже предела. Регулирование выполняется на основе сеанса пользователя, чтобы обеспечить статистически правильные значения в Ключ-АСТРОМ. Если общий объем трафика упадет, Ключ-АСТРОМ автоматически вернется к скорости захвата, установленной для вашей среды.

Почему Ключ-АСТРОМ меняет скорость захвата?

Ограничение максимального количества действий пользователя в минуту зависит от вашей среды и предназначено для предотвращения непредвиденного высокого потребления объема вашей лицензии непредвиденными ИТ-событиями, такими как необъявленные маркетинговые кампании, незапланированные нагрузочные тесты, атаки DDoS, агрессивные веб-сканеры и другие.

Как это влияет на данные, видимые в пользовательском интерфейсе Ключ-АСТРОМ?

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

• Это влияет на все показатели подсчета (например, количество сеансов пользователя, количество действий пользователя и количество конверсий).
• Показатели скорости (например, частота ошибок JavaScript, коэффициент конверсии, частота сбоев и показатель отказов) не изменяются, поскольку сеансы либо фиксируются полностью, либо не фиксируются вообще.
• Захват сеанса пользователя на стороне кластера не влияет на внедрение RUM JavaScript.

Можно ли изменить лимит моей среды?

Увеличение лимита действий пользователя в минуту приводит к анализу большего количества пользовательских сеансов и, следовательно, также увеличивает потребление DEM .

Ключ-АСТРОМ SaaS

Максимальное количество действий пользователя в минуту зависит от вашей среды. Чтобы настроить это ограничение, перейдите в «Настройки » > «Веб- и мобильный мониторинг » > «Предотвращение перегрузки RUM» в веб-интерфейсе Ключ-АСТРОМ.

Ключ-АСТРОМ Managed

Максимальное количество действий пользователя в минуту зависит от вашей среды. Это ограничение можно настроить в разделе Консоль управления кластером > Среды в разделе Параметры предотвращения перегрузки кластера .

Как я узнаю, что мое приложение RUM превысило лимит?

На странице «Сеансы пользователей» отображается следующий тип предупреждений:

События ограничения максимального количества действий пользователя в минуту перечислены в разделах «События » и «Влияние действий пользователя на производительность» на соответствующей странице обзора приложения.

Предупреждение также отображается в разделе «Производительность» действий пользователя .

Почему ЕдиныйАгент для Android не отправляет данные в мое мобильное приложение?

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

В следующем списке перечислены некоторые проблемы, с которыми вы можете столкнуться:

• Убедитесь, что вы использовали правильное значение applicationIdи beaconUrlзначение, предоставленное вашим приложением для мониторинга.
• Вы правильно адаптировали Network Security Configuration? Вы должны включить системные сертификаты ЦС или сертификат в ваш общедоступный управляемый кластер Ключ-АСТРОМ АктивныйШлюз.
• Проверьте, доступен ли Ключ-АСТРОМ или общедоступный Ключ-АСТРОМ Managed Cluster АктивныйШлюз из сети вашей компании.
• [Для Ключ-АСТРОМ Managed] Имеет ли общедоступный Ключ-АСТРОМ Managed Cluster АктивныйШлюз действующий сертификат? Также проверьте правильность имени хоста/домена.

Почему мое сообщаемое значение, имя действия и URL-адрес веб-запроса усечены?

ЕдиныйАгент для Android усекает большинство (связанных с пользователем) значений, когда они превышают предельное значение границы, равное 250.

Плагин Astromkey для Android Gradle

Общие

Почему некоторые из моих веб-запросов отсутствуют?

Захватываются только веб-запросы из поддерживаемой платформы HTTP . Проверьте, есть ли ваша HTTP-инфраструктура в этом списке. Если это не так, настройте свои веб-запросы вручную.

Также см. Почему я пропускаю веб-запросы при использовании плагина Firebase? .

Почему веб-запросы не связаны с данным действием пользователя?

ЕдиныйАгент для Android привязывает веб-запросы только к действию пользователя, инициированному в течение определенного периода времени. Временные рамки начинаются, когда действие открывается, и заканчивается 500 msпосле закрытия действия. Вы можете изменить это значение с помощью userActions.timeoutсвойства.

Почему мой компонент пользовательского интерфейса не генерирует действие пользователя?

Может быть несколько причин, по которым ЕдиныйАгент для Android не может создать действие пользователя:

• Компонент пользовательского интерфейса определен в WebView.
• Компонент пользовательского интерфейса использует неподдерживаемый прослушиватель. Вы можете найти список всех поддерживаемых прослушивателей в разделе мониторинга действий пользователя .

Почему я пропускаю веб-запросы при использовании плагина Firebase?

Плагин Astromkey для Android Gradle совместим с плагином Firebase Performance Monitoring. Однако существуют некоторые ограничения.

Если вы используете плагин Firebase Performance Monitoring версии 1.4.0+ с плагином Android Gradle версии 4.2.x, это повлияет на вас. Плагин мониторинга производительности Firebase использует инструментальный подход, несовместимый с плагином Astromkey Android Gradle в этой версии плагина Android Gradle.

Чтобы узнать, затронута ли ваша сборка, проверьте версии, указанные в build.gradleфайле.

dependencies {
    classpath 'com.android.tools.build:gradle:4.2.0' // Android Gradle plugin
    classpath 'com.google.firebase:perf-plugin:1.4.0' // Firebase Performance Monitoring plugin
}

Решение . Обновите подключаемый модуль Android Gradle до версии 7.0.0+ и используйте последнюю версию подключаемого модуля Astromkey для Android Gradle.

Проблемы со сборкой

Почему я вижу сообщение «Версия ЕдиныйАгент SDK <номер_версии> не соответствует версии подключаемого модуля Astromkey Android Gradle <номер_версии>»?

ЕдиныйАгент SDK и подключаемый модуль Astromkey Android Gradle должны иметь одинаковую версию. Возможно, вы добавили ЕдиныйАгент SDK (с более поздней версией) через зависимость Gradle в свой проект приложения для Android.

Почему моя сборка завершается с ошибкой «Плагин с идентификатором com.astromkey.instrumentation не найден»?

Проверьте, добавили ли вы buildscriptблок с classpath 'com.astromkey.tools.android:gradle-plugin:8.+'зависимостью в файл вашего модуля build.gradle.

Почему моя сборка завершается с ошибкой «Не удалось найти com.astromkey.tools.android:gradle-plugin:<номер_версии>»?

Это связано с тем, что Gradle не смог найти указанную версию. Проверьте, правильно ли вы указали номер версии. Вы можете проверить доступную версию на Maven Central. Вы также должны добавить mavenCentral()в свою buildscriptконфигурацию.

Почему моя сборка завершается с ошибкой «Не удалось найти версию, соответствующую com.astromkey.tools.android:gradle-plugin:<номер_версии>.+.»?

Gradle не удалось найти версию, соответствующую вашим настройкам версии. Вы можете проверить доступную версию на Maven Central. Вы также должны добавить mavenCentral()в свою buildscriptконфигурацию.

Почему моя сборка завершается с ошибкой «Не удалось получить динамическую трассировку неизвестного свойства для объекта типа org.gradle.api.internal.artifacts.dsl.dependencies.DefaultDependencyHandler»?

Проверьте, применили ли вы плагин Astromkey Android Gradle до astromkeyзависимости блока.

apply plugin: 'com.astromkey.instrumentation'

astromkey {
...
}

Почему моя сборка завершается с ошибкой: «Не найдена конфигурация для плагина Astromkey Android Gradle! Скопируйте блок конфигурации из мастера инструментовки в нужное место.`?

Вы применили подключаемый модуль Astromkey Android Gradle к своему build.gradleфайлу, но не предоставили конфигурацию подключаемого модуля. Пожалуйста, следуйте шагу 3 раздела Инструментарий с помощью плагина Astromkey для Android Gradle . Для приложений React Native следуйте инструкциям по устранению неполадок в документации к подключаемому модулю Astromkey React Native .

Почему я вижу сообщение «Задача printVariantAffiliation не найдена в проекте: <имя_модуля>»?

Убедитесь, что вы добавили подключаемый модуль Astromkey Android Gradle в путь к классам buildscript и применили этот подключаемый модуль.

Плагин Astromkey для Android Gradle создает новые задачи Gradle (например, задачу printVariantAffiliation) только для определенных подпроектов вашего проекта приложения для Android. Он не генерирует задачи для корневого проекта и некоторых подпроектов. Например, подключаемый модуль Astromkey для Android Gradle не создает printVariantAffiliationбиблиотечные модули для Android.

Почему я вижу сообщение «Плагин Astromkey Android Gradle Plugin можно применять только к проектам Android»?

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

Почему я вижу сообщение «Плагин Astromkey Android Gradle должен быть применен в файле build.gradle (или build.gradle.kts) верхнего уровня»?

Плагин с идентификатором com.astromkey.instrumentationдолжен быть применен в файле build.gradle верхнего уровня . Скорее всего, вы добавили конфигурацию плагина не в тот build.gradleфайл. Убедитесь, что плагин используется в правильном build.gradleфайле.

Почему я вижу сообщение «Плагин Astromkey Android Gradle нельзя напрямую применить к модулю, связанному с Java или Android»?

Ваш проект не использует рекомендованную архитектуру ; он использует необычную архитектуру проекта.

• Если ваш проект Android содержит только один build.gradle файл, выполните действия, описанные в проектах Android только с одним файлом сборки .

Почему я вижу сообщение «Невозможно использовать оба плагина Astromkey («com.astromkey.instrumentation» и «com.astromkey.instrumentation.module») для одного и того же модуля»?

Плагин с ID com.astromkey.instrumentationавтоматически настраивает все модули в вашем проекте. Поэтому использование плагина с ID com.astromkey.instrumentation.moduleне требуется. См. Изменение конфигурации подключаемого модуля Astromkey Android Gradle на основе структуры проекта , чтобы понять, когда следует использовать подключаемый модуль с идентификатором com.astromkey.instrumentation.module.