Track Browser and Mobile Errors

Overview

Error Tracking processes errors collected from browser and mobile Datadog SDKs. Whenever an error containing a stack trace is collected, Error Tracking processes and groups it under an issue, which is a grouping of similar errors.

An essential attribute for log errors is the stack trace in a log’s error.stack. If you are sending stack traces to Datadog but they are not in error.stack, you can set up a generic log remapper to remap the stack trace to the correct attribute in Datadog.

Your crash reports appear in Error Tracking.

Setup

If you have not set up the Datadog Browser SDK yet, follow the in-app setup instructions or see the Browser Logs setup documentation.

  1. Download the latest version of the Logs Browser SDK. Error Tracking requires at least v4.36.0.

  2. Configure your application’s version, env, and service when initializing the SDK. For example, with NPM:

    import { datadogLogs } from '@datadog/browser-logs'
    
    datadogLogs.init({
      clientToken: '<DATADOG_CLIENT_TOKEN>',
      site: '<DATADOG_SITE>',
      service: '<MY_SERVICE>',
      env: '<MY_ENV>',
      forwardErrorsToLogs: true,
      sessionSampleRate: 100,
    })
    
  3. To log a caught exception yourself, you may use the optional error parameter:

    try {
      throw new Error('wrong behavior');
    } catch(err) {
      datadogLogs.logger.error("an error occurred", {usr: {id: 123}}, err);
    }
    

Note: Error Tracking only considers errors that are instances of Error.

If you have not set up the Datadog Android SDK yet, follow the in-app setup instructions or see the Android Logs setup documentation.

  1. Download the latest version of the Datadog Android SDK for Logs.

  2. Configure your application’s version, env, and service when initializing the SDK.

  3. To log a caught exception yourself, you may optionally use:

    try {
      doSomething();
    } catch (IOException e) {
      logger.e("an exception occurred", e);
    }
    

If you have not setup the Datadog iOS SDK yet, follow the in-app setup instructions or see the iOS Logs setup documentation.

  1. Download the latest version of the Datadog iOS SDK for Logs.

  2. Configure your application’s version, env, and service when initializing the SDK.

  3. To log a caught exception yourself, you may optionally use:

    do {
      // ...
    } catch {
      logger.error("an exception occurred", error)
    }
    

Further Reading