Error Tracking

Error Tracking allows developers to discover and view errors generated by their application. Because error information is surfaced where the code is developed, this increases efficiency and awareness. Users can choose between GitLab Integrated error tracking and Sentry based backends.

How error tracking works

For error tracking to work, you need:

  • Your application configured with the Sentry SDK: when the error happens, Sentry SDK captures information about it and sends it over the network to the backend. The backend stores information about all errors.
  • Error tracking backend: the backend can be either GitLab itself or Sentry.
    • To use the GitLab backend, see GitLab Integrated error tracking. Integrated error tracking is available only on
    • To use Sentry as the backend, see Sentry based. Sentry based error tracking is available for, GitLab Dedicated and Self-managed instances.

Here is a summary of the capabilities for each version:

Feature Availability Data collection Data storage Data query
GitLab integrated Error Tracking only with Sentry SDK Data stored on with only
Sentry-based Error Tracking, GitLab Dedicated, Self-managed with Sentry SDK Data stored on Sentry instance (Cloud or Self-Hosted Sentry) with or Sentry instance