prometheus / prometheus/alertmanager

Improvement amtool alert grouping

Open
#2,736 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

component/cli stale
Dominant language
Go
Stars
8.6k
Forks
2.5k
Avg merge
2d 6h
Merged PRs (30d)
61

Description

What did you do?

$ amtool alert
Alertname        Starts At                Summary
Test_Alert       2017-08-02 18:30:18 UTC  This is a testing alert!
Test_Alert       2017-08-02 18:30:18 UTC  This is a testing alert!
Check_Foo_Fails  2017-08-02 18:30:18 UTC  This is a testing alert!
Check_Foo_Fails  2017-08-02 18:30:18 UTC  This is a testing alert!

What did you expect to see?
An option to group active alerts by alertname. This would bring the output of amtool in alignment with the UI for prometheus/alertmanager which collapse alerts of the same alertname into a single row.

This is useful for installations with a large number of open alerts of the same type.

What did you see instead? Under which circumstances?
Individual alerts with no grouping options. Possibly add a "group" option to the -o parameter

  • Alertmanager version:

    v0.18.0

  • Prometheus version:

    v2.20.0

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start at the amtool alert command and its -o option handling. Trace how active alerts are currently rendered, then determine where grouping by alertname belongs. Done means a grouping option produces one row per alertname for active alerts, matching the requested condensed output.

Written by the indexing model from the issue text.

Assessment

Tech stack
go
Domain
cli
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.