Metrics & monitoring

Send VictoriaMetrics (vmalert) alerts to on-call with CallHeim.

vmalert Alertmanager-shaped webhook pointed directly at us. CallHeim maps the payload, collapses repeats within five minutes, and pages whoever is on call for the service it belongs to.

victoriametricsalso accepts: vmalert, victoria-metrics, vm

Batched deliveries

Each delivery becomes one alert, from its first event. If VictoriaMetrics (vmalert) batches several events into one delivery, only the first is turned into an alert.

Setting it up

Create an Integration in CallHeim and choose VictoriaMetrics (vmalert) from the Catalog. You get an ingest URL for that integration — paste it into VictoriaMetrics (vmalert)’s webhook configuration. The snippet beside this is the shape it expects, with {{WEBHOOK_URL}} replaced by your real URL.

If you enable request signing on this integration, CallHeim requires a valid HMAC-SHA256 signature in the X-ItOnCall-Signature or X-Hub-Signature-256 header on every request to it. Without a signing secret, the ingest URL itself is the credential.

CallHeim includes a payload mapping for VictoriaMetrics (vmalert)’s webhook format, built and tested against sample payloads.

VictoriaMetrics (vmalert) webhook documentation →

Setup snippetvictoriametrics
# vmalert notifier config (Alertmanager-compatible webhook):
receivers:
  - name: callheim
    webhook_configs:
      - url: "{{WEBHOOK_URL}}"
        send_resolved: true
Example shape written by us; check VictoriaMetrics (vmalert)’s current documentation.

After it arrives

What CallHeim does with VictoriaMetrics (vmalert) alerts.

Threshold alerts flap at the boundary. Where a source sends a recovery event CallHeim recognises, a series that changes state four times inside ten minutes is grouped instead of re-paging, and the underlying incident stays open and visible.

CallHeim maps VictoriaMetrics (vmalert)’s own severity to a P1–P5 level and shows a separate, explainable severity suggestion — a published keyword ruleset plus your own resolved-incident history — that a person can apply. How severity is suggested →

Each alert source is bound to a service, and the service’s escalation policy (or its team’s) sets who is paged. Alerting and escalation →

CallHeim closes an incident on a recovery event only for sources whose recovery payload it recognises (or that you map). For the others, a person resolves the incident.

The thresholds it passes through

Dedup window
300s
Flap threshold
4 transitions / 600s
Title correlation
similarity ≥ 0.6, same source and service
Group window default
600s

All defaults are published. You can turn title correlation off or change its threshold, and set the window on your own noise rules; the dedup window and the flap settings are fixed. How alerts are processed →

CallHeim

Point VictoriaMetrics (vmalert) at CallHeim and see what it does with your alerts.

Explore the platform, connect one source, and send yourself a test page by e-mail (early access).

Early access · every workspace starts with a 14-day trial for up to 5 seats, no card required