DESK Android Gradle plugin FAQs
Find out how to solve problems related to Android mobile app monitoring.
General
A 'Max. user actions per minute exceeded' event informs you that the number of user actions generated from Real User Monitoring (Web, Mobile, and OpenKit) has exceeded a limit that is specific to your environment. Once this limit is reached, DESK automatically throttles the number of user sessions being captured until the number of user actions is below the limit again. The throttling is done on a user session basis in order to provide statistically correct values in DESK. If the overall traffic volume drops, DESK will automatically return to the capturing rate you've set for your environment.
Why does DESK change the capture rate?
The maximum user action count per minute limit is specific to your environment and is there to prevent unexpected high consumption of your license volume by unexpected IT events like unannounced marketing campaigns, unplanned load tests, DDoS attacks, aggressive web scanners, or other.
What is the impact on the data visible in the DESK UI?
During the period of the event, DESK reduces the amount of captured user sessions. Some of the sessions aren't captured and therefore no further analysis is applied. This means all count metrics are impacted (for example, user session count, user action count, and conversion count). Rate metrics aren't impacted since sessions are either captured fully or not at all. This includes, for example, JavaScript error rate, conversion rate, crash rate, and bounce rate.
Can my environment limit be changed?
The environment limit can be adjusted. For details, please contact the DESK ONE team or your sales representative.
The maximum user action count per minute limit is specific to your environment. You can configure this limit at Environments > Cluster Management Console.
How do I know if my RUM application has exceeded the limit?
The User sessions page displays the following type of alert:
The Maximum user actions per minute limit events are listed under the Events and Impact of user actions on performance sections of the corresponding application overview page.
An alert is also displayed under the Performance section of User actions.
You might have to adjust the app or your server infrastructure to allow OneAgent to reach DESK. Read Adjust OneAgent communication for more information.
The following list contains some problems that you might experience:
- Verify that you used the correct
applicationId
andbeaconUrl
value provided by your monitoring app - Did you adapt the
Network Security Configuration
correctly? You must include system CA certificates or the certificate to your public Managed Cluster ActiveGate. - Check if DESK or your public Managed Cluster ActiveGate is reachable from within your company network.
- [For DESK Managed] Does the public Managed Cluster ActiveGate have a valid certificate? Also, verify that the host/domain name is correct.
OneAgent for Android truncates most (user-related) values when they exceed the border limit value of 250.
DESK Android Gradle plugin
General
Only web requests from a supported HTTP framework are captured. Check if your HTTP framework is in this list. If it isn't, instrument your web requests manually.
OneAgent for Android only attaches web requests to a user action triggered within a specific timeframe. The timeframe starts when the action opens and ends 500 ms
after the action closes. You can change this value with the userActions.timeout
property.
There can be multiple reasons why OneAgent for Android can't create a user action:
- The UI component is defined in a WebView.
- The listener method is defined in a resource XML file.
- The UI component uses an unsupported listener. You can find the list of all supported listeners in the user action monitoring section .
Enable the userActions.emptyActions
property if your user interaction does not trigger a web request or lifecycle change. OneAgent for Android discards empty user actions by default.
Build problems
OneAgent SDK and the DESK Android Gradle plugin must have the same version. You may have added OneAgent SDK (with a higher version) via a Gradle dependency to your Android application project.
Check if you have added the buildscript
block with the classpath 'com.desk.tools:android:8.+'
dependency to your module's build.gradle
file.
This is because Gradle was unable to find the specified version. Check if you have specified the correct version number. You can check the available version on JCenter and Maven Central. You also must add jcenter()
or mavenCentral()
to your buildscript
configuration.
Gradle was unable to find a version that matches your version settings. You can check the available version on JCenter and
Maven Central. You also have to add jcenter()
or mavenCentral()
to your buildscript
configuration.
Check if you have applied the DESK Gradle plugin before the desk
block dependency.
apply plugin: 'com.desk.instrumentation'
desk {
...
}
Ensure that you have added the DESK Android Gradle plugin to the buildscript classpath and that you have applied the plugin.
The DESK Android Gradle plugin only generates new Gradle tasks (like the printVariantAffiliation
task) for specific subprojects of your Android application project. It does not generate tasks for the root project and some subproject. For example, the DESK Android Gradle plugin doesn't generate the printVariantAffiliation
for Android library modules.
The DESK Android Gradle plugin can only be used when your Android project is built with the Android Gradle plugin. This error message is displayed when the DESK Android Gradle plugin is used in non-Android projects or in Android projects that are not built via the Android Gradle plugin.