Für Entwickler

Uptime-Monitoring das Sie skripten können

Überwachen Sie Ihre APIs, Cronjobs, Ports und Zertifikate, legen Sie Monitore an und schalten Sie Alarme aus Ihrer Pipeline per REST-API stumm, und erhalten Sie einen signierten Webhook, wenn etwas ausfällt. Reines HTTP, kein Agent zu installieren.

  • Prüfungen alle 60 Sekunden
  • REST-API und signierte Webhooks
  • Anmeldung mit GitHub
Einen Monitor über die Kommandozeile anlegen
curl -X POST https://api.alertsleep.com/public/v1/monitors \
  -H "AuthToken: $ALERTSLEEP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "friendly_name": "Orders API",
    "url": "https://api.example.com/health",
    "type": "http",
    "interval_seconds": 60
  }'

Binden Sie es in Ihren Workflow ein

Alles hier ist eine einfache HTTP-Anfrage. Nutzen Sie curl, Ihre CI oder einen beliebigen HTTP-Client.

Alarme während eines Deployments stummschalten

Öffnen Sie aus der Pipeline ein Wartungsfenster und beenden Sie es, wenn das Deployment fertig ist. Ein Wartungsfenster hat eine Maximaldauer, sodass ein Job, der mittendrin abbricht, Ihre Monitore nicht dauerhaft stummschalten kann.

# before the deploy: mute alerts for at most 15 minutes
START=$(date -u +%FT%TZ); END=$(date -u -d "+15 min" +%FT%TZ)
WINDOW_ID=$(curl -fsS -X POST https://api.alertsleep.com/public/v1/maintenance-windows \
  -H "AuthToken: $ALERTSLEEP_TOKEN" -H "Content-Type: application/json" \
  -d "{\"title\":\"Deploy $CI_COMMIT_SHORT_SHA\",\"starts_at\":\"$START\",
       \"ends_at\":\"$END\",\"monitor_ids\":[\"$MONITOR_ID\"]}" \
  | jq -r .maintenance_window.id)

./deploy.sh

# after it: end the window early
curl -fsS -X POST https://api.alertsleep.com/public/v1/maintenance-windows/$WINDOW_ID/end \
  -H "AuthToken: $ALERTSLEEP_TOKEN"

Heartbeats aus Cron

Pingen Sie /start, wenn der Job beginnt, damit auch ein hängender Lauf erkannt wird, und die einfache URL, wenn er erfolgreich war. Bei einem Fehler pingen Sie /fail mit dem Exit-Code, und die E-Mail geht sofort raus statt erst nach der Karenzzeit.

# crontab: alert me if the nightly backup fails or never runs
# (one line in crontab)
0 3 * * * curl -fsS https://api.alertsleep.com/v1/ping/YOUR-TOKEN/start; /usr/local/bin/backup.sh && curl -fsS https://api.alertsleep.com/v1/ping/YOUR-TOKEN || curl -fsS https://api.alertsleep.com/v1/ping/YOUR-TOKEN/fail -d exit_code=$?

Reagieren Sie in Ihrem Code auf einen Ausfall

Die Webhook-Integration sendet JSON bei monitor.down, monitor.up und Zertifikatsereignissen. Ist ein Secret gesetzt, trägt jede Anfrage eine HMAC-SHA256-Signatur über Zeitstempel und Body, sodass Sie gefälschte und wiederholte Aufrufe ablehnen können.

// Node: verify an AlertSleep webhook
const ts = req.headers['x-alertsleep-timestamp'];
const expected = 'sha256=' + crypto
  .createHmac('sha256', process.env.ALERTSLEEP_SECRET)
  .update(ts + '.' + rawBody).digest('hex');
const ok = crypto.timingSafeEqual(
  Buffer.from(expected),
  Buffer.from(req.headers['x-alertsleep-signature']));

// body: {"version":1,"event":"monitor.down",
//   "sent_at":"…","resource":{…},
//   "data":{"status":"down","reason":"HTTP 503 …"}}

Ein Status-Badge im README

Jede öffentliche Statusseite hat ein SVG-Badge mit ihrem aktuellen Status oder ihrer Verfügbarkeit über 30 Tage, verlinkt auf die Seite.

<!-- README.md -->
[![Status](https://status.alertsleep.com/your-page/badge.svg)](https://status.alertsleep.com/your-page)

<!-- 30-day uptime instead of the current state -->
![Uptime](https://status.alertsleep.com/your-page/badge.svg?type=uptime)

Öffentliche API unter /public/v1 mit einem API-Token im AuthToken-Header, bis zu 500 Anfragen pro Minute und Token.

Alarme dort, wo Sie ohnehin sind

Wählen Sie die Kanäle pro Monitor. Eine fehlgeschlagene Prüfung wird zuerst von einem zweiten Standort wiederholt, sodass ein Aussetzer im Netzwerk auf unserer Seite niemanden weckt.

E-Mail SMS Telefonanruf Slack Microsoft Teams Discord Telegram WhatsApp Webhook
Alle Integrationen
  • Der Alarm nennt, was fehlgeschlagen ist: den Statuscode, den Timeout, den DNS- oder TLS-Fehler oder das fehlende Keyword.
  • Bei der ersten erfolgreichen Prüfung folgt eine Entwarnung.
  • SMS und Telefonanrufe sind im Tarif enthalten, ab $59 pro Jahr.
  • Alarme können auf Englisch, Deutsch, Französisch, Spanisch, Polnisch oder Tschechisch verfasst werden.

Liegt es an denen oder an Ihnen?

Wenn ein Deployment fehlschlägt oder eine API in den Timeout läuft, prüfen Sie die Dienste, auf denen Ihr Stack läuft. Jede Seite zeigt unsere eigenen Prüfungen und die offiziellen Vorfälle des Anbieters.

Ein Konto, dem Sie Tokens anvertrauen können

Monitore enthalten Zugangsdaten zu Ihren Systemen, deshalb ist das Konto entsprechend geschützt.

Anmeldung mit GitHub

Oder mit Google oder Microsoft oder mit einem Passwort. Verknüpfen Sie mehrere davon mit einem Konto.

Zwei-Faktor-Authentifizierung

TOTP-Codes aus jeder Authenticator-App, mit einmaligen Wiederherstellungscodes.

Verschlüsselte Zugangsdaten

Monitor-Header, Basic-Auth-Passwörter und Integrationseinstellungen werden verschlüsselt gespeichert.

Widerrufbare API-Tokens

Ein Token pro Pipeline oder Skript, jeweils mit Anzeige der letzten Nutzung, und mit einem Klick gelöscht.

Was AlertSleep nicht ist

Damit Sie sich vor der Anmeldung entscheiden können.

  • Es gibt keine CLI, kein SDK und keinen Terraform-Provider. Die API ist reines JSON über HTTPS, curl und jede HTTP-Bibliothek funktionieren also.
  • Es ist kein APM- und kein Log-Tool: keine Traces, kein Error-Tracking, keine Real-User-Metriken.
  • Ein Monitor sendet eine Anfrage. Mehrstufige Abläufe und JSON-Schema-Assertions gehören in einen eigenen Health-Endpunkt.
  • Die Prüfungen laufen von einem Standort, und jeder Ausfall wird von einem zweiten bestätigt. Es gibt kein Netz von Prüfpunkten in vielen Ländern.

Häufig gestellte Fragen

Hat AlertSleep eine API?

Ja. Mit der öffentlichen REST-API können Sie Monitore auflisten, anlegen, ändern und löschen, ihre Prüfungen und Vorfälle auslesen und Wartungsfenster verwalten. Erstellen Sie im Dashboard einen Token und senden Sie ihn im AuthToken-Header. Jeder Token erlaubt bis zu 500 Anfragen pro Minute.

Gibt es eine CLI oder ein SDK?

Nein. Die API ist reines JSON über HTTPS. curl in einem Shell-Skript oder CI-Job oder ein beliebiger HTTP-Client in Ihrer Sprache ist alles, was Sie brauchen.

Wie stoppe ich Alarme während eines Deployments?

Öffnen Sie ein Wartungsfenster für die betroffenen Monitore, im Dashboard oder per POST aus Ihrer Pipeline, und beenden Sie es, wenn das Deployment fertig ist. Die Prüfungen laufen weiter, aber es gehen keine Alarme raus, und das Wartungsfenster senkt Ihre Verfügbarkeit nicht.

Wie überwache ich einen Cronjob oder einen Queue-Worker?

Legen Sie einen Cron-Monitor mit dem Zeitplan an, als Intervall oder als Cron-Ausdruck mit Zeitzone, und mit einer Karenzzeit. Der Job ruft seine Ping-URL auf, wenn er fertig ist. Kommt kein Ping rechtzeitig an oder ruft der Job /fail auf, erhalten Sie eine E-Mail.

Wie prüfe ich die Webhook-Signatur?

Setzen Sie ein Secret in der Webhook-Integration. Jede Anfrage trägt dann X-AlertSleep-Timestamp und X-AlertSleep-Signature: sha256= gefolgt vom HMAC-SHA256 aus Zeitstempel, einem Punkt und dem unveränderten Body. Berechnen Sie denselben Wert mit Ihrem Secret, vergleichen Sie in konstanter Zeit und lehnen Sie alte Zeitstempel ab.

Kann ich APIs hinter einer Authentifizierung überwachen?

Ja. Senden Sie einen Bearer-Token oder einen API-Key in einem Header, oder nutzen Sie Basic Auth. Zugangsdaten werden verschlüsselt gespeichert und auch bei der Bestätigungsprüfung vom zweiten Standort mitgesendet.

Wie oft wird geprüft?

Alle 60 Sekunden, in jedem Tarif. Ein Ausfall wird sofort von einem zweiten Standort wiederholt, und wenn beide übereinstimmen, geht der Alarm sofort raus.

Kann ich es kostenlos testen?

Ja. Beide Tarife beginnen mit einer 14-tägigen Testphase inklusive API, Webhooks und SMS-Alarmen, ohne Karte. Nach der Testphase kostet es ab $59 pro Jahr.

Fügen Sie Ihren ersten Endpunkt in wenigen Minuten hinzu

Legen Sie einen Monitor im Dashboard oder mit einem einzigen API-Aufruf an. 14 Tage kostenlos testen, ohne Karte.