Upload and manage symbol files for mobile applications
Deobfuscation (Android) or symbolication (iOS) is the process of making classes and methods human-readable in a crash report stack trace.
The following example is an Android stack trace, before and after deobfuscation:
Dynatrace enables you to manage Android mapping files and iOS symbol extract files required to interpret mobile stack traces that Dynatrace receives.
Dynatrace supports three different ways of uploading these files:
- Through a symbolication service known as "Deobfuscation and Symbolication Service" (DSS)
- Via the Dynatrace REST API
- Via the Dynatrace Fastlane plugin
- Through the Dynatrace web UI
Currently, Dynatrace only supports symbolication of stack-trace lines from applications and third-party libraries on iOS, for which the dSYM files have been provided. Symbolication of system library stack trace lines is not supported.
Note that you can upload a symbol file of up to 100 MiB compressed; the uncompressed file must not exceed 500 MiB.
You need the Change monitoring settings permission to upload source maps and symbol files.
Upload mapping files for Android
For Android, upload your app's mapping files in their original form. You do not need to preprocess these files.
To learn more about mapping files and where to find them, check the official Android documentation.
Upload symbol files for iOS
For iOS symbolication, you need to preprocess dSYM files using the DSSClient before you can upload them to Dynatrace.
Manage uploaded symbol files
You can use the Dynatrace web UI to manage the previously uploaded Android mapping files and iOS symbol extract files.
To list the uploaded symbol files for a particular application
- In the Dynatrace menu, go to Mobile.
- Select the mobile application that you want to configure.
- Select More (…) > Edit in the upper-right corner of the tile with your application name.
- From the application settings, select Symbol files.
To list the uploaded symbol files for all your applications
- In the Dynatrace menu, go to Settings.
- Select Web and mobile monitoring > Source maps and symbol files.
This page displays the amount of storage that is currently used and the storage limit.
- For Dynatrace SaaS, the maximum storage size for symbol and mapping files is 1 GB.
- For Dynatrace Managed, the default storage size for symbol and mapping files is 1 GB. You can modify the storage size according to your requirements.
To free up space, you can manually delete files that you no longer need.
For a more automated approach to deleting unneeded files, turn on Pinned for the files that you want to keep. After that, whenever the storage limit is reached, Dynatrace begins deleting the symbol files that aren't pinned, starting with the oldest files.
Alternatively, you can use the Mobile Symbolication API to view, pin, or delete your symbol files.