Parameterization in Issue Templates for Incidents

Everyone can contribute. Help move this issue forward while earning points, leveling up and collecting rewards.

  • Close this issue

Problem to solve

Alerts contain a lot of information that typically varies based on the service and the problem at hand. In GitLab today, we provide a simple setting that users can enable to automatically create issues when a prometheus Alert is triggered. We can save users time and automate some of the routing and triage process for issues by allowing users to assign and label issues or select specific runbooks based on alert attributes.

We can achieve this by parameterization of values based on incoming alert fields/attributes and supporting a mark-up language in issues templates. The mark-up language would expect parameters from the alert payloads that the user could then use to determine who to assign an issue to or how to label it.

For example if you had alerts tied to a particular service, it would be great if you could annotate those labels in the alert, then have that carry through to the issue template which would add the label to the issue upon creation.

Intended users

Sasha the Software Developer
Devon the DevOps Engineer
Sidney the Systems Administrator

Further details

This work contributes to the Incident Management Vision

Proposal

We can support the Liquid markup language (due to #26764 (comment 521145192)) GitLab's Changelog Custom Template for our issue templates, and variables can be substituted based on incoming labels and annotations from Prometheus.

For example:

{% if alert.metric_query %}
Metric query: {{ it }}
{% end %}

{% each alert.annotations.labels %}
/label {{ it }}
{% end %}

Permissions and Security

Documentation

What does success look like, and how can we measure that?

What is the type of buyer?

Links / references

This page may contain information related to upcoming products, features and functionality. It is important to note that the information presented is for informational purposes only, so please do not rely on the information for purchasing or planning purposes. Just like with all projects, the items mentioned on the page are subject to change or delay, and the development, release, and timing of any products, features, or functionality remain at the sole discretion of GitLab Inc.

Edited Jun 28, 2025 by 🤖 GitLab Bot 🤖
Assignee Loading
Time tracking Loading