Uptime Monitoring

Uptime monitors check whether your services are online and fire alerts when something goes down. Instead of configuring each monitor to notify each channel individually, point them all at Alphorn and let routing rules handle the rest.

With Uptime Kuma

Uptime Kuma is a popular self-hosted monitoring tool. It supports webhook notifications out of the box.

Simple setup

The quickest way — just point Uptime Kuma at your Alphorn webhook. Alphorn will receive the raw payload and forward it to your channels.

1. Create a webhook in Alphorn and copy the URL
2. In Uptime Kuma, go to Settings → Notifications
3. Add a new notification with type Webhook
4. Paste your Alphorn webhook URL as the URL
5. Done — Uptime Kuma sends its default payload and Alphorn routes it

This works out of the box. You'll get notifications with Uptime Kuma's default message format.

Advanced setup

For richer notifications with priority-based routing and custom tags, configure a custom request body:

1. In the Uptime Kuma notification settings, set Body to Custom Body
2. Use this JSON template:

{
  "title": "{{ monitorJSON['name'] }} is {{ heartbeatJSON['status'] === 1 ? 'UP' : 'DOWN' }}",
  "message": "{{ monitorJSON['url'] }} — {{ heartbeatJSON['msg'] }}",
  "priority": {{ heartbeatJSON['status'] === 1 ? 2 : 5 }},
  "tags": ["uptime", "{{ heartbeatJSON['status'] === 1 ? 'recovery' : 'down' }}"]
}

This gives you:

• Dynamic priority — DOWN events get priority 5 (critical), UP recoveries get priority 2 (low)
• Tags — down or recovery tags for filtering
• Readable titles — "My API is DOWN" instead of a raw JSON blob

Routing examples

With the advanced setup you can route based on priority and tags:

With Healthchecks.io

Healthchecks.io monitors cron jobs and heartbeats. Configure a webhook integration pointing to your Alphorn endpoint.

Custom uptime check

A simple bash script that checks a URL and sends the result to Alphorn:

#!/bin/bash
URL="https://your-app.com/health"
WEBHOOK="https://app.alphorn.dev/api/webhooks/wh_abc123"

STATUS=$(curl -s -o /dev/null -w "%{http_code}" "$URL")

if [ "$STATUS" -ne 200 ]; then
  curl -s -X POST "$WEBHOOK" \
    -H "Content-Type: application/json" \
    -d "{
      \"title\": \"Health check failed\",
      \"message\": \"$URL returned HTTP $STATUS\",
      \"priority\": 5,
      \"tags\": [\"uptime\", \"down\"]
    }"
fi

Run this with cron every minute:

* * * * * /path/to/healthcheck.sh