---
title: "Crash Tracking"
slug: "mapp-intelligence-android-sdk-v5-crash-tracking"
description: "Track app crashes with Mapp Intelligence Android SDK v5 and understand how crash-related analytics are captured."
updated: 2026-04-24T11:12:35Z
published: 2026-04-24T11:12:35Z
canonical: "docs.mapp.com/mapp-intelligence-android-sdk-v5-crash-tracking"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Crash Tracking

Crash tracking allows you to analyze crashes and exceptions within your mobile application. Once enabled, parameters are automatically sent to Mapp Intelligence for analysis, but proper configuration is required for accurate insights.

## Parameters

The following parameters are automatically tracked when crash tracking is enabled. They must be [configured in Mapp Intelligence](/v1/docs/how-to-set-up-custom-parameters) as Event Parameters to ensure accurate analysis:

| Parameter | Description | Where to analyze |
| --- | --- | --- |
| Crash - Type | Type of crash: - 1: Uncaught - 2: Caught - 3: Custom | metric |
| Crash - Name | Name of the crash, either system-generated or custom (if custom type is used). | *Navigation > Event Parameter* |
| Crash - Message | Message associated with the crash, system or custom. |
| Crash - Cause Message | Parsed string from the crash message. |
| Crash - Stack | Stack where the crash happened. |
| Crash - Cause Stack | Stack that caused the crash. |

## Methods

To enable crash tracking in your application, use the following methods:

| Method | Description | Tracking Options |
| --- | --- | --- |
| enableCrashTracking(exceptionLogLevel: ExceptionType) | Enables crash tracking in global configuration. The following types can be tracked: - Uncaught exceptions - Caught exceptions - Caught exceptions with custom messages | - NONE: Disables crash tracking. (Default) - ALL: Tracks all crash types. - UNCAUGHT: Tracks uncaught exceptions. - CAUGHT: Tracks caught exceptions. - CUSTOM: Tracks custom exceptions. - UNCAUGHT_AND_CUSTOM: Tracks uncaught and custom exceptions. - UNCAUGHT_AND_CAUGHT: Tracks uncaught and caught exceptions. - CUSTOM_AND_CAUGHT: Tracks custom and caught exceptions. |
| trackException( exception: Exception ) | Tracks caught exceptions. | - |
| trackException( name: String, message: String ) | Tracks caught exceptions with custom name and message. | - |

## Example

**Kotlin**

1. Enable crash tracking in your [global configuration](https://docs.mapp.com/docs/en/mapp-intelligence-android-sdk-v5-configure-global-tracking) settings:

```kotlin
val webtrekkConfigurations =
     WebtrekkConfiguration.Builder(listOf( "12345" ), "https://track.mapp.com" )
         .enableCrashTracking(ExceptionType.ALL)
         .build()
Webtrekk.getInstance().init( this , webtrekkConfigurations)
```
2. Track exceptions in your application:

```kotlin
//Uncaught exception
trackUncaught.setOnClickListener {
     Integer.parseInt( "@!#" )
}
 
//Caught exceptions
trackCaught.setOnClickListener {
     try {
         Integer.parseInt( "@!#" )
     } catch (e: Exception) {
         Webtrekk.getInstance().trackException(e)
     }
}
 
//Custom exceptions
trackCustom.setOnClickListener {
     try {
         Integer.parseInt( "@!#" )
     } catch (e: Exception) {
         Webtrekk.getInstance().trackException( "Hello" , "I am custom exception :)" )
     }
```

**Full Code Example**

```kotlin
class CrashActivity : AppCompatActivity() {
 
     override fun onCreate(savedInstanceState: Bundle?) {
         super .onCreate(savedInstanceState)
         setContentView(R.layout.activity_crash)
 
         //Uncaught exception
         trackUncaught.setOnClickListener {
             Integer.parseInt( "@!#" )
         }
 
         //Caught exceptions
         trackCaught.setOnClickListener {
             try {
                 Integer.parseInt( "@!#" )
             } catch (e: Exception) {
                 Webtrekk.getInstance().trackException(e)
             }
         }
 
         //Custom exceptions
         trackCustom.setOnClickListener {
             try {
                 Integer.parseInt( "@!#" )
             } catch (e: Exception) {
                 Webtrekk.getInstance().trackException( "Hello" , "I am custom exception :*" )
             }
         }
     }
}
```

**Java**

1. Enable crash tracking in your [global configuration](https://docs.mapp.com/docs/en/mapp-intelligence-android-sdk-v5-configure-global-tracking) settings:

```java
List<String> ids = new ArrayList<>();
ids.add( "1" );
 
WebtrekkConfiguration webtrekkConfiguration2 = new WebtrekkConfiguration.Builder(ids, "https://www.webtrekk.com" )
         .enableCrashTracking(ExceptionType.ALL)
         .build();
Webtrekk.getInstance().init( this , webtrekkConfiguration);
```
2. Track exceptions in your application:

```java
//Uncaught exception
Button trackUncaught = findViewById(R.id.trackUncaught);
trackUncaught.setOnClickListener( new View.OnClickListener() {
     @Override
     public void onClick(View v) {
         Integer.parseInt( "@!#" );
     }
});
 
//Caught exceptions
Button trackCaught = findViewById(R.id.trackCaught);
trackCaught.setOnClickListener( new View.OnClickListener() {
     @Override
     public void onClick(View v) {
         try {
             Integer.parseInt( "@!#" );
         } catch (Exception e) {
             Webtrekk.getInstance().trackException(e);
         }
     }
});
 
//Custom exceptions
Button trackCustom = findViewById(R.id.trackCustom);
trackCaught.setOnClickListener( new View.OnClickListener() {
     @Override
     public void onClick(View v) {
         try {
             Integer.parseInt( "@!#" );
         } catch (Exception e) {
             Webtrekk.getInstance().trackException( "Hello" , "I am custom exception :)" );
         }
     }
});
```

**Full Code Example**

```java
public class CrashActivity extends AppCompatActivity {
 
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super .onCreate(savedInstanceState);
         setContentView(R.layout.activity_crash);
 
         //Uncaught exception
         Button trackUncaught = findViewById(R.id.trackUncaught);
         trackUncaught.setOnClickListener( new View.OnClickListener() {
             @Override
             public void onClick(View v) {
                 Integer.parseInt( "@!#" );
             }
         });
 
         //Caught exceptions
         Button trackCaught = findViewById(R.id.trackCaught);
         trackCaught.setOnClickListener( new View.OnClickListener() {
             @Override
             public void onClick(View v) {
                 try {
                     Integer.parseInt( "@!#" );
                 } catch (Exception e) {
                     Webtrekk.getInstance().trackException(e);
                 }
             }
         });
 
         //Custom exceptions
         Button trackCustom = findViewById(R.id.trackCustom);
         trackCaught.setOnClickListener( new View.OnClickListener() {
             @Override
             public void onClick(View v) {
                 try {
                     Integer.parseInt( "@!#" );
                 } catch (Exception e) {
                     Webtrekk.getInstance().trackException( "Hello" , "I am custom exception :)" );
                 }
             }
         });
     }
}
```