Dokumentation
Pingio-Dokumentation
Wie Monitore, Vorfälle, Benachrichtigungskanäle und öffentliche Statusseiten zusammenspielen.
Erste Schritte
Erstellen Sie ein Konto, legen Sie Ihren ersten Monitor an und verbinden Sie einen Benachrichtigungskanal. Pingio beginnt sofort mit der Prüfung und zeigt das erste Ergebnis innerhalb eines Intervalls.
Jeder Monitor braucht ein Ziel, einen Prüftyp und ein Intervall. Alles Weitere hat sinnvolle Voreinstellungen, die Sie später verfeinern können.
- Legen Sie einen Monitor über das Dashboard oder die API an.
- Verbinden Sie mindestens einen Kanal, damit Alarme ein Ziel haben.
- Öffnen Sie die Monitor-Detailseite, um die rohe Prüfhistorie zu sehen.
Monitortypen
Pingio unterstützt Prüfungen für HTTP(S), Schlüsselwörter, TCP-Ports, Ping, SSL-Zertifikate und Server-Agenten. Jeder Typ hat eigene Prüfregeln und Timeout-Richtlinien.
- HTTP(S): Statuscode, Antwortzeit, Weiterleitungen und Request-Header.
- Schlüsselwort: prüfen, ob ein Text im Antwortkörper vorhanden oder abwesend ist.
- TCP und Ping: Erreichbarkeit von Host und Port aus mehreren Regionen.
- SSL: Ablauf des Zertifikats, Gültigkeit der Kette und Übereinstimmung des Hostnamens.
- Server-Agent: CPU-, Speicher- und Festplattenwerte eines installierten Agenten.
Zeitplanung und Verifikation
Monitore werden nach Intervall eingereiht und an Worker verteilt. Schlägt eine Prüfung fehl, wiederholt Pingio sie aus einer anderen Region, bevor ein Vorfall eröffnet wird – so alarmiert eine einzelne gestörte Route Ihr Team nie allein.
Ist ein Vorfall offen, prüft Pingio im normalen Takt weiter und schließt den Vorfall automatisch nach der eingestellten Zahl erfolgreicher Prüfungen.
Vorfälle und Benachrichtigungen
Wiederholte Fehler werden zu einem einzigen Vorfall mit Zeitleiste gebündelt. Benachrichtigungen gehen bei Eröffnung, bei fälligen Erinnerungen und bei der Behebung heraus.
Erinnerungsintervalle und die maximale Zahl der Erinnerungen werden je Team konfiguriert, damit lange Ausfälle sichtbar bleiben, ohne Ihre Kanäle zu fluten.
- E-Mail, Telegram, Slack, SMS und generische Webhooks.
- Kanalzuordnung je Monitor und Ruhezeiten.
- Deduplizierung, damit ein Ausfall nie doppelte Alarme erzeugt.
Öffentliche Statusseiten
Jedes Team kann eine oder mehrere Statusseiten veröffentlichen, die den aktuellen Monitorzustand, die Vorfallhistorie und geplante Wartungen zeigen. Statusseiten sind lokalisiert und für Suchmaschinen indexierbar.
API-Zugriff
Die REST-API bildet das Dashboard ab. Nutzen Sie sie, um Monitore aus Infrastrukturcode anzulegen, Prüfhistorien in eigene Dashboards zu holen oder während eines Deployments Wartungsfenster auszulösen.
{
"name": "Primary website",
"type": "http",
"target": "https://example.com",
"intervalSeconds": 60,
"regions": ["eu-central", "us-east"],
"assertions": {
"status": 200,
"contains": "Welcome"
}
}