Symbolication service version 8 and later

Symbolication (iOS) or De-Obfuscation (Android) is the process of making classes and methods in a crash report stack trace human-readable.

The Mobile Symbolication API enables you to manage the ProGuard mapping and iOS symbol extract files needed to interpret the mobile stack traces when they arrive to Dynatrace.

DSSClient

The Symbolication Service (also known as DSS, or De-obfuscation and Symbolication Service) enables you to symbolicate (iOS) or de-obfuscate (Android) mobile application crash reports or handled exceptions.

For iOS symbolication the DSSClient processes the symbol files (.dSYMs) and uploads them to Dynatrace. The ProGuard mapping files (Android) are uploaded in their original form.

Get Started

The DSSClient is bundled with the iOS Agent and can be found in the release package under dss/DTXDssClient.

The required .dSYM files can be downloaded from App Store Connect. For local builds and enterprise distribution, they can be found inside the app's .xcarchive.

Note: The DSSClient can only be executed on machines running macOS.

Usage

The DSSClient can be customized in multiple ways. For a detailed overview of all possible parameters start it with -help-appmon.

List all symbolfiles

DTXDssClient flavour=appmon server=http://server.com username=user password=pass -list
Option Definition
flavour=appmon If no flavour is specified, `flavour=dynatrace` will be used.
server The URL to the Appmon server.
username The username used to access the Appmon server.
password The password used to access the Appmon server.
-list The command flag.

Delete iOS symbols

DTXDssClient flavour=appmon server=http://server.com username=user password=pass -delete os=iOS appname=MyApp version=10.2
Option Definition
flavour=appmon If no flavour is specified, `flavour=dynatrace` will be used.
server The URL to the Appmon server.
username The username used to access the Appmon server.
password The password used to access the Appmon server.
-delete The command flag.
os The operating system of the symbol file to delete.
appname The name (as displayed via `-list`) of the symbol file to delete.
version The version (as displayed via `-list`) of the symbol file to delete.

Upload a mapping file contained within an XCode iOS archive file

DTXDssClient flavour=appmon server=http://server.com username=user password=pass -upload symbolsfile="usr/local/MyApp.xcarchive"
Option Definition
flavour=appmon If no flavour is specified, `flavour=dynatrace` will be used.
server The URL to the Appmon server.
username The username used to access the Appmon server.
password The password used to access the Appmon server.
-upload The command flag.
symbolsfile The path to the `.xcarchive` of the app (can also be a direct path to a `.dSYM` file).