Know the second when a server goes down.

Wire up your monitoring

1. A bash health check on cron

Install the CLI, authenticate once, then ping the service and push if it does not answer.

sudo mv pocketalert /usr/local/bin/ && chmod +x /usr/local/bin/pocketalert
pocketalert auth YOUR_API_KEY

#!/usr/bin/env bash
URL=https://api.example.com/health
if ! curl -fsS --max-time 10 "$URL" >/dev/null; then
  pocketalert send -t "API DOWN on $(hostname)" -m "$URL did not respond"
fi

Run it every minute from cron.

* * * * * /usr/local/bin/check-health.sh

2. Or a Netdata alarm hook

Add a custom_sender() to health_alarm_notify.conf (edit via sudo ./edit-config health_alarm_notify.conf) so every Netdata alarm posts to the messages API.

custom_sender() {
  curl -X POST 'https://api.pocketalert.app/v1/messages' \
    -H 'Token: YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -d "{\"title\":\"${name} is ${status} on ${host}\",\"message\":\"${chart}.${family}: ${value_string}\",\"level\":\"critical\"}"
}

3. Or forward Alertmanager via a webhook

Create a webhook on the Webhooks page with a GJSON template, then add the receive URL to a Prometheus Alertmanager webhook_config.

curl -X POST 'https://api.pocketalert.app/v1/webhooks' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Alertmanager","application_id":"qm47b9pzxzxg","message":"%status%: %alerts.0.labels.alertname% — %alerts.0.annotations.summary%"}'

receivers:
  - name: pocketalert
    webhook_configs:
      - url: 'https://p4a.me/wh/1234abcd'
        send_resolved: true

The docs list the GJSON paths.