Vier Wege zu Ihren Daten
Verwalten über die REST-API, Messwerte über Prometheus, Ereignisse über Webhooks, Listen über den Export.
Anmeldung mit einem API-Schlüssel
Jedes Konto hat einen API-Schlüssel, zu finden im Konto unter „API“ und dort neu erzeugbar. Er wird als Authorization: Bearer im Header gesendet. Der Schlüssel gilt für das ganze Konto, abgestufte oder nur lesende Schlüssel gibt es nicht. Behandeln Sie ihn wie ein Passwort.
Monitore automatisch anlegen und verwalten
Uptime-Monitore, Heartbeats, Server-Monitore, DNS-Monitore, Domains, Statusseiten, Benachrichtigungskanäle, Projekte und Wartungsfenster lassen sich auflisten, einzeln abrufen, anlegen, ändern und löschen. Ein Deployment-Skript kann so den Monitor für einen neuen Server gleich mit anlegen. Jede Änderung über die API steht im Änderungsprotokoll.
Vorfälle lesen und bestätigen
Vorfälle lassen sich filtern, abrufen, kommentieren und über POST /api/incidents/{incident_id}/acknowledge bestätigen. Das entspricht „Ich kümmere mich“ im Portal und stoppt Erinnerungen und Eskalation, ein Ticket-System meldet so die Übernahme zurück. Vorfälle gibt es zu Uptime-Monitoren und Heartbeats: Ein Server-Monitor, der offline ist, hat keinen Vorfall und lässt sich nur im Portal oder aus der Alarm-E-Mail bestätigen.
Messwerte für Prometheus
GET /api/metrics liefert die aktuellen Werte des Kontos im Textformat von Prometheus: Uptime-Monitore, Heartbeats, Server-Monitore mit GPUs, Restlaufzeiten von Domains und Zertifikaten, offene Vorfälle. Alle Metriken tragen das Präfix peaknode_. Unbekanntes wird weggelassen und nie als 0 gemeldet.
Webhooks für Ereignisse
Der Benachrichtigungskanal Webhook sendet bei jeder Meldung, die an ihn geht, einen POST-Request an Ihre URL, formularkodiert, mit dem User-Agent PeakNode/1.0: bei Alarm und Entwarnung ebenso wie bei Erinnerung, Eskalation, Grenzwert oder DNS-Änderung. Ist Ihr Server nicht erreichbar oder antwortet er mit 408, 425, 429 oder einem Fehler ab 500, wiederholt PeakNode die Zustellung über rund 4 Stunden und ergänzt das Feld original_datetime. Kommt die Verbindung zustande und bleibt nur die Antwort aus, wird nicht wiederholt, damit Ihr System nichts doppelt auslöst. Eine Signatur trägt der Request nicht.
Export und Import
Listen und Verläufe lassen sich als CSV oder JSON herunterladen, zum Beispiel die Prüfungen eines Monitors über einen gewählten Zeitraum. PDF entsteht über die Druckansicht des Browsers, ein fertiges PDF gibt es beim SLA-Bericht. Monitore, Heartbeats, Server-Monitore, DNS-Monitore und Domains lassen sich per CSV importieren. Welche Exportarten ein Konto nutzen kann, legt der Tarif fest.