Home / Docs / Alertmanager

Alertmanager alerts as iPhone push notifications

Alertmanager's webhook receiver can POST to any URL when an alert fires or resolves. Point it at Pling and your Prometheus alerts become iPhone push notifications, with the severity label mapped to push priority and grouped alerts summarized for you.

The receiver config

Add a webhook receiver to alertmanager.yml and route alerts to it:

receivers:
  - name: pling
    webhook_configs:
      - url: "https://api.plingpush.com/api/ingest/alertmanager/YOUR_TOKEN"
        send_resolved: true

route:
  receiver: pling

Reload and test

Reload the configuration, then fire a test alert:

curl -X POST http://localhost:9093/-/reload

What the push looks like

Title — [FIRING] or [RESOLVED] plus the alert name.
Message — the summary annotation, the instance, and the alert count.
Priority — critical severity becomes high; resolved becomes low.
Tap target — the alert's generator URL.

Where to get your token: create an API token in the Pling app, or at plingpush.com/account, and swap it into the URL above. Full API reference in the docs.

Frequently asked

Does send_resolved work?

Yes. With send_resolved: true, Alertmanager also posts when an alert clears, and Pling delivers that as a low-priority [RESOLVED] push.

What happens with grouped alerts?

Alertmanager groups alerts before sending. Pling uses the group's alert name as the title and notes how many alerts are in the group in the message.

How is priority decided?

A severity: critical label maps to high priority, other severities to normal, and resolved notifications to low. The summary annotation and instance label form the message.

Where do I get my token?

Create an API token in the Pling app or at plingpush.com/account and use it in place of YOUR_TOKEN in the webhook URL.

More recipes: GitHub Actions · cron jobs · Python · Grafana · Uptime Kuma · API reference