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

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

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

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

=== Почему Ключ-АСТРОМ меняет скорость захвата? ===
Ограничение максимального количества действий пользователя в минуту зависит от вашей среды и предназначено для предотвращения непредвиденного высокого потребления объема вашей лицензии непредвиденными ИТ-событиями, такими как необъявленные маркетинговые кампании, незапланированные нагрузочные тесты, атаки DDoS, агрессивные веб-сканеры и другие.

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

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

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

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

[[Файл:andr1.png]]

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

[[Файл:andr2.png]]

=== Как я узнаю, что мое приложение RUM превысило лимит? ===
На странице «Сеансы пользователей» отображается следующий тип предупреждений:

[[Файл:andr3.png]]

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

[[Файл:andr4.png]]

[[Файл:andr5.png]]

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

[[Файл:andr6.png]]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Чтобы узнать, затронута ли ваша сборка, проверьте версии, указанные в <code>build.gradle</code>файле.
 <code>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
 }</code>
Решение . Обновите подключаемый модуль Android Gradle до версии 7.0.0+ и используйте последнюю версию подключаемого модуля Astromkey для Android Gradle.

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

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

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

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

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

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

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

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

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

Проверьте, применили ли вы плагин Astromkey Android Gradle до <code>astromkey</code>зависимости блока.
 <code>apply plugin: 'com.astromkey.instrumentation'
 
 astromkey {
 ...
 }</code>
Почему моя сборка завершается с ошибкой: «Не найдена конфигурация для плагина Astromkey Android Gradle! Скопируйте блок конфигурации из мастера инструментовки в нужное место.`?

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

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

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

Плагин Astromkey для Android Gradle создает новые задачи Gradle (например, задачу <code>printVariantAffiliation</code>) только для определенных подпроектов вашего проекта приложения для Android. Он не генерирует задачи для корневого проекта и некоторых подпроектов. Например, подключаемый модуль Astromkey для Android Gradle не создает <code>printVariantAffiliation</code>библиотечные модули для 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) верхнего уровня»?

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

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

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

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

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

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