Alert Management

Introduced in GitLab 13.0.

Alert Management enables developers to easily discover and view the alerts generated by their application. By surfacing alert information where the code is being developed, efficiency and awareness can be increased.

Enable Alert Management

Note: You will need at least Maintainer permissions to enable the Alert Management feature.
  1. Follow the instructions for toggling generic alerts
  2. You can now visit Operations > Alerts in your project’s sidebar to view a list of alerts.

Alert Management Toggle

Populate Alert data

To populate data, see the instructions for customizing the payload and making a request to the alerts endpoint.

Alert Management severity

Each level of alert contains a uniquely shaped and color-coded icon to help you identify the severity of a particular alert. These severity icons help you immediately identify which alerts you should prioritize investigating:

Alert Management Severity System

Alerts contain one of the following icons:

  • Critical: and hexadecimal color #8b2615
  • High: and hexadecimal color #c0341d
  • Medium: and hexadecimal color #fca429
  • Low: and hexadecimal color #fdbc60
  • Info: and hexadecimal color #418cd8
  • Unknown: and hexadecimal color #bababa

Alert Management list

Note: You will need at least Developer permissions to view the Alert Management list.

You can find the Alert Management list at Operations > Alerts in your project’s sidebar. Each alert contains the following metrics:

Alert Management List

  • Severity - The current importance of a alert and how much attention it should receive.
  • Start time - How long ago the alert fired. This field uses the standard GitLab pattern of X time ago, but is supported by a granular date/time tooltip depending on the user’s locale.
  • End time - How long ago the alert fired was resolved. This field uses the standard GitLab pattern of X time ago, but is supported by a granular date/time tooltip depending on the user’s locale.
  • Alert description - The description of the alert, which attempts to capture the most meaningful data.
  • Event count - The number of times that an alert has fired.
  • Status - The current status of the alert.

Alert Management statuses

Each alert contains a status dropdown to indicate which alerts need investigation. Standard alert statuses include triggered, acknowledged, and resolved:

  • Triggered: No one has begun investigation.
  • Acknowledged: Someone is actively investigating the problem.
  • Resolved: No further work is required.

Alert Management details

Note: You will need at least Developer permissions to view Alert Management details.

Navigate to the Alert Management detail view by visiting the Alert Management list and selecting an Alert from the list.

Alert Management Detail Overview

Alert Management Full Details

Update an Alert’s status

The Alert Management detail view enables you to update the Alert Status. See Alert Management statuses for more details.

Create an Issue from an Alert

Introduced in GitLab 13.1.

The Alert Management detail view enables you to create an issue with a description automatically populated from an alert. To create the issue, click the Create Issue button. You can then view the issue from the alert by clicking the View Issue button.