1. 1. Manual crash reporting
      1. JavaScript tracker
      2. Matomo Tag Manager
      3. Tracker SDKs
      4. HTTP Tracking API

Crash Analytics supports automatic crash reporting where available and also lets your application report additional errors manually. You can use both approaches together.

When enabled, Crash Analytics automatically records unhandled JavaScript exceptions and unhandled Promise rejections on websites that use the Matomo JavaScript tracker.

No additional Crash Analytics tracking code is required. Once Crash Analytics is enabled, supported JavaScript errors are automatically reported.

Some applications detect or handle errors before they become unhandled exceptions. Because these errors are handled by the application, Crash Analytics does not record them automatically. You can report these errors manually to:

• report caught exceptions.
• report business logic failures that do not generate JavaScript errors.
• report server-side exceptions.
• report exceptions from mobile applications.

You can manually report these errors using one of the following methods.

Web applications can report crashes using the Crash Analytics methods provided by the Matomo JavaScript tracker. This is the recommended approach when:

• You can modify your application’s code and want to report caught or application-specific errors that are handled by your code.
• You want to capture JavaScript errors that occur before the Matomo JavaScript tracker has loaded by queuing them for reporting after the tracker has initialised.

Websites using Matomo Tag Manager can also report crashes using a Custom HTML tag. Use this approach when your application exposes error information through the data layer for Matomo Tag Manager to process.

Applications can report crashes using a supported Matomo Tracker SDK. Supported Tracker SDKs provide methods for manually reporting exceptions and application errors. For example:

• PHP: doTrackPhpThrowable()
• Android: TrackHelper.exception()

Native Android and iOS crashes are not detected automatically. Applications must explicitly report exceptions using the appropriate Tracker SDK. Refer to the developer guide on Tracking application and server-side crashes.

If your application cannot use an official Matomo Tracker SDK, you can send crash reports directly using the HTTP Tracking API. This allows applications written in any language or runtime environment to report exceptions to Crash Analytics.

Previous FAQ: Group hashed JavaScript source files in Crash Analytics