Skip to content

Connect your alerts

Paeon sits next to your alerting, never in its path: your existing notifications stay as they are, and Paeon gets a copy.

Three sources work with nothing but the ingest token:

Source How
uptime-kuma Add a notification of type Webhook: post URL http://paeon:8080/ingest/uptime-kuma, body application/json, additional header {"Authorization": "Bearer <PAEON_INGEST_TOKEN>"}. Apply it to every monitor.
Alertmanager, and what speaks its webhook Point a webhook receiver at http://paeon:8080/ingest/alertmanager with the same bearer token.
OpenObserve Create a user that can read the triggers stream and set the PAEON_OPENOBSERVE_* variables. Paeon polls; it never writes to OpenObserve and nothing changes in your alerts.

Every other service is a source you name in the rules file. It posts to /ingest/<name>, or Paeon polls it:

Service Alerts arrive
Grafana webhook contact point Grafana
Gatus custom alert Gatus
Healthchecks webhook integration Healthchecks
Netdata custom notification Netdata
Zabbix webhook media type Zabbix
Beszel polled Beszel
A second OpenObserve, uptime-kuma or Alertmanager as above, under a name of yours Sources
sources:
  grafana: { type: grafana }
  gatus:   { type: gatus }

A source can also give an investigation read-only tools: metrics from Prometheus or VictoriaMetrics, logs from Loki or VictoriaLogs, monitor states, silences. The Sources guide has each service in full: what to set up in it, every key, what arrives and what can be read.

Planned work

Announce a deploy, an update run or a backup from the script that does it, so triage knows about it:

curl -X POST http://paeon:8080/ingest/change -H "Authorization: Bearer $PAEON_INGEST_TOKEN" -H 'Content-Type: application/json' -d '{"kind": "update", "title": "weekly updater", "host": "server-1"}'

A silent source, a silent Paeon

A polled source that stops answering opens an internal source_stale alert, and Paeon can push a heartbeat to an uptime-kuma push monitor (PAEON_HEARTBEAT_URL), so a silent Paeon is noticed.