Documentation Grafana Cloud Alerts and IRM IRM OnCall Configure Integrations Labels Configure labels

Configure labels

Labels are key-value pairs (for example, team_name: infrastructure). Grafana IMR has default key values include service_name and team_name, but you can define any custom values that fit your needs.

To configure labels:

1. In Grafana IRM, go to the Integrations page and select the integration you want to configure.
2. Click the three-dot menu next to the integration and select Integration settings.
3. In the Label Schema section, choose between Static and Dynamic labels, then click + Add label.
4. Enter a key-value pair for the label by selecting an existing key, adding a new one, or using a Jinja template.
5. Click + Add, then click Update integration to save your changes.
6. (Optional) Click the pencil icon next to the Multi-label Extraction Template to configure multiple labels in a single template.

Configure static labels

Static labels are tied to the integration they are configured for and applied to all alerts from that integration.

To configure static labels:

1. In the Static labels section of the Label Schema, click + Add label.
2. Enter a key-value pair (for example, team_name: infrastructure).
3. Click + Add to save the label.

Configure dynamic labels

Dynamic labels allow you to assign values to alert groups based on extracted alert payload data. These labels use a static key but extract their value dynamically using Jinja templates.

To configure dynamic labels:

1. In the Dynamic labels section of the Label Schema, click + Add Label.
2. Enter the key for the label (for example, severity).
3. Define the extraction logic using a Jinja template to extract the label value from the alert payload.
4. Click + Add to save the label.

Example: Dynamic label extraction

Consider a dynamic label that extracts the severity level from the alert payload:

Template:

jinja2 Copy

{{ payload.get("severity) }}

Created dynamic label:

Alert payloads

Alert 1:

json Copy

{
  "title": "critical alert",
  "severity": "critical"
}

Alert 2:

json Copy

{
  "title": "warning alert",
  "severity": "warning"
}

Resulting labels:

• The first alert group receives the label: severity: critical.
• The second alert group receives the label: severity: warning.

Multi-label extraction template

For advanced use cases, the Multi-label Extraction Template allows you to extract multiple labels from an alert payload using a single Jinja template. This is useful for alerts containing multiple key-value attributes.

To configure a multi-label template:

1. In the Label Schema section of your integration settings, open the Multi-label Extraction Template.
2. Enter a Jinja template that outputs a valid JSON dictionary.
3. Click Save, then click Update integration.

Example: Multi-label extraction

Consider an alert with the following payload:

Incoming payload:

json Copy

{
  ...
  "commonLabels": {
    "job": "node",
    "severity": "critical",
    "alertname": "InstanceDown"
  },
  ...
}

Template:

jinja2 Copy

{{ payload.commonLabels | tojson }}

Resulting labels applied to the alert group:

• job: node
• severity: critical
• alertname: InstanceDown

Advanced example: Extracting and modifying labels

This example extracts multiple labels, adds a new one, and modifies another.

Template:

jinja2 Copy

{%- set labels = {} -%}
{# add several labels #}
{%- set labels = dict(labels, **payload.commonLabels) -%}
{# add one label #}
{%- set labels = dict(labels, **{"status": payload.status}) -%}
{# add label not from payload #}
{%- set labels = dict(labels, **{"service": "oncall"}) -%}
{# dump labels dict to json string, so OnCall can parse it #}
{{ labels | tojson }}

This template results in the following labels:

• Extracts labels from commonLabels.
• Adds a status label from the payload.
• Adds a static service:oncall label.

Customize the Alert Group table

The Alert Group table can be customized to display relevant information for each user. You can select which columns to show and add custom columns based on labels.

Manage default columns

By default, the Columns dropdown provides predefined columns that users can enable or disable. Use the toggle switch next to each column name to show or hide it in the table.

Add custom columns

Users with admin permissions can create custom columns based on labels.

To add a custom column:

1. Click Add in the Columns dropdown. A modal appears.
2. Enter the name of the label key you want to use as a column.
3. Select the label from the available options.
4. Click Add.

The new custom column appears in the Column Settings and is available for all users.