Generic webhook template doesn't identify which metric attribute/label combination (e.g. trace name) triggered the alert
Maintainer antworten meist innerhalb von 1 Tag
Dieses Issue hat noch niemand übernommen.
Bewertung
- Schwierigkeit
- 5/5
- Geschätzter Aufwand
- Über eine Woche
- Anfängerfreundlichkeit
- 45/100
- Issue-Typ
- Feature
- Klarheit
- Größtenteils klar
- Aktivitätsstatus
- Ruhig
- Tech-Stack
- typescript
- Bereich
- observability
Rechercherichtung
Das Issue nennt keine Dateien oder Tests. Beginnen Sie damit, die Verarbeitung generischer Webhook-Vorlagen, die Auswertung von Metrik-Alerts und die Pfade für den Alert-Verlauf der External API v2 zu finden; verfolgen Sie nach, wie implizite und explizite Serienlabels bis zum Auslösen gelangen. Erledigt ist die Aufgabe, wenn Kombinationen von Attributen, die einen Schwellwert überschreiten, in Webhook-Vorlagen und Antworten zum Alert-Verlauf verfügbar sind und das Verhalten für eine oder mehrere Webhook-Zustellungen definiert ist.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
My alert is on a dashboard tile with a single series: a metrics data source, a gauge aggregation, and a where clause — no groupBy is configured anywhere in the tile. Despite that, the chart renders multiple lines, because the underlying OTel metric carries multiple distinct attribute/label combinations (e.g. per trace/span name), and HyperDX implicitly plots one line per unique combination even though I never set an explicit group-by.
When the alert fires, the generic webhook body currently supports {{title}}, {{body}}, {{link}}, {{state}}, {{startTime}}, {{endTime}}, and {{eventId}}. None of these identify which underlying attribute combination (e.g. which trace name) actually crossed the threshold — the payload describes the alert's overall state and timing, but has no reference to the specific label values that produced the offending line.
This makes it impossible to route or triage generic webhook alerts without manually opening the dashboard and visually picking out which of the several implicit lines crossed the threshold. For downstream automation (custom incident routing, deduping, auto-annotating tickets, posting to the right team channel, etc.) this is a hard blocker — the alert is not attributable to a specific cause without a human eyeballing the chart.
Current behavior
- Dashboard tile: single series, metrics data source, gauge value,
whereclause. NogroupByconfigured. - The metric itself has multiple attribute/label combinations (e.g. per-trace or per-span name), so the tile implicitly renders several lines even without an explicit group-by.
- Alert is attached to this tile/series.
- On firing, the generic webhook body supports
{{title}},{{body}},{{link}},{{state}},{{startTime}},{{endTime}}, and{{eventId}}. - None of these resolve to the specific attribute/label combination (e.g. trace name) whose line crossed the threshold —
{{link}}sends you to the tile, and the rest describe the alert's state/timing/ID, but none carry the identity of the offending line. You still have to visually inspect the chart to identify it.
Expected behavior
The webhook payload/template should include the specific attribute/label combination that breached the threshold for that firing — e.g. a {{seriesLabels}} or {{attributeValue}} (name TBD) template variable, populated with the trace name / span name / other metric attribute value that produced the crossing line.
This is closely related to (and possibly the same underlying gap as) groupBy-based alerts not surfacing the specific group value that fired — in both cases, the tile can implicitly or explicitly contain multiple lines, and the webhook has no way to say which one triggered.
Why this matters
Without this, generic webhook consumers (custom bots, incident routing via generic webhook, internal Slack bots, etc.) can only say "something on this metric tile crossed a threshold" — not "trace X crossed the threshold." For any metric with multiple attribute combinations feeding one tile, this makes the alert nearly useless for automated triage; a human has to click through and visually inspect the chart every time just to know what actually needs attention.
Suggested implementation
- Add a template variable (e.g.
{{seriesLabels}}) available in the generic webhook body template, populated per-firing with the specific attribute/label combination (as key-value pairs) of the line that breached. - Since a metric-source tile with no explicit
groupBycan still implicitly fan out into many lines by attribute combination, consider either:- firing one webhook call per breaching attribute combination (each with its own labels), or
- including an array of breaching attribute combinations in the payload if a single call is preferred.
- Apply the equivalent fix for explicit
groupBy-based alerts (surface the specific group value that fired, not just the field being grouped on) — same underlying gap, different mechanism for producing multiple lines. - Expose the same field on the External API v2 alert-history/evaluation response, if separate from the webhook payload, so it's fetchable after the fact too.
Environment
- Alert type: Dashboard tile alert (chart), single series, metrics data source, gauge aggregation,
whereclause, nogroupByconfigured - Multiple alerts appear implicitly due to distinct attribute/label combinations in the underlying metric
- Notification channel: Generic Webhook
- Vorherrschende Sprache
- TypeScript
- Sterne
- 10.1k
- Forks
- 527
- Ø Merge
- 1 T. 20 Std.
- Gemergte PRs (30 T.)
- 186
Entwicklungsumgebung
- Enthält ein Dockerfile oder eine Docker-Compose-Datei
- Hat eine Pull-Request-Vorlage
- Beitragsleitfaden lesen
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus ClickHouse/ClickStack
-
external
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
ClickHouse/ClickStack#3761 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Metric chart with aggFn increase and a multi-column group-by fails: toString() gets several argumentsEvtl. vergeben @CG-5228 hat das vor 26 Tagen übernommen. Offenexternal
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 76/100
ClickHouse/ClickStack#3477 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
-
Slack notifications for inline alerts fail when the chart-explorer link passes Slack's 3000-character block limitEvtl. vergeben @Tyagiquamar hat das vor 27 Tagen übernommen. Offenalerting bug external
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 76/100
ClickHouse/ClickStack#3452 ·
Maintainer antworten meist innerhalb von 1 Tag
-
check-alerts worker: 13 error spans (mongodb.create, NamespaceExists) every minute because mongoose autoCreate is still onEvtl. wieder frei Ein Pull Request dazu wurde ohne Merge geschlossen. Offenbug external Needs Feedback
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
ClickHouse/ClickStack#3308 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
-
count_distinct aggFn on metric tiles ignores valueExpression, always counts distinct metric ValuesEvtl. vergeben @Harshul1484 hat das vor 54 Tagen übernommen. Offen
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
ClickHouse/ClickStack#2311 ·
Maintainer antworten meist innerhalb von 1 Tag
Alle Issues in ClickHouse/ClickStack
Ähnliche Issues
-
Add: GTrekkerOffencheck:passed streams:add
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 72/100
Maintainer antworten meist innerhalb von 1 Tag
-
area: ui Bug Payload OSS
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 88/100
payloadcms/payload#19839 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 85/100
Maintainer antworten meist innerhalb von 1 Tag
-
fix(auth): add the email OTP verification step to Pollar loginEvtl. vergeben @akansnoro hat das heute übernommen. OffenStellar Wave
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 74/100
safetrustcr/dApp-SafeTrust#584 · 10 Kommentare ·
Maintainer antworten meist innerhalb von 1 Tag
-
The manager preset saves launch definitions without the required file and digest pairEvtl. vergeben Ein verknüpfter Pull Request ist offen oder bereits gemergt. Offenbug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 80/100
Maintainer antworten meist innerhalb von 1 Tag