Zum Inhalt springen

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 Prüfregionen verteilt. Schlägt eine Prüfung fehl, wiederholt Pingio sie aus einer anderen Region, bevor ein Vorfall eröffnet wird — eine einzelne gestörte Route alarmiert Sie also 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.

Erinnerungsintervall und maximale Anzahl der Erinnerungen legen Sie selbst fest, damit lange Ausfälle sichtbar bleiben, ohne Ihre Kanäle zu fluten.

  • E-Mail, Telegram und generische Webhooks.
  • Kanalzuordnung je Monitor und Ruhezeiten.
  • Deduplizierung, damit ein Ausfall nie doppelte Alarme erzeugt.

Öffentliche Statusseiten

Sie können eine oder mehrere Statusseiten veröffentlichen, die den aktuellen Monitorzustand, die Vorfallhistorie und geplante Wartungen zeigen. Statusseiten sind lokalisiert und werden von Suchmaschinen indexiert.

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"
  }
}