Komponenten, Gruppen und Prüfungen

Komponenten

Eine Komponente ist ein Eintrag auf deiner Seite: „Website“, „API“, „Survival-Server“. Jede hat einen Status, der entweder aus einer Prüfung kommt oder von dir gesetzt wird. Du verwaltest sie unter Dashboard → Dienste → deine Statusseite → Komponenten.

Wie viele Komponenten du anlegen kannst, hängt am Paket: 5 bei Free, 25 bei Pro, 100 bei Business.

Gruppen

Gruppen ordnen Komponenten, etwa „Spieleserver“ und „Web“. Eine Gruppe hat einen Namen und eine Reihenfolge (kleinere Zahl steht weiter oben); die Komponenten darin sortierst du ebenso. Du legst sie unter Gruppen mit Neue Gruppe an. Gruppen sind optional, bei drei Komponenten braucht es keine.

Prüfarten

Beim Anlegen mit Komponente hinzufügen wählst du die Prüfart im Feld Prüfung: Von Hand, HTTP, TCP, Ping, CitexNode-Dienst, DNS, SSL-Zertifikat und Heartbeat.

HTTP(S)

Du trägst die URL ein, unter Erwarteter HTTP-Status den Statuscode (meist 200, leer heißt: jeder Erfolg) und unter Timeout (Sekunden) einen Wert zwischen 1 und 30. Weiterleitungen werden nicht verfolgt: Leitet https://example.com auf https://www.example.com weiter, kommt ein 301 zurück. Trag also die Adresse ein, die direkt antwortet, oder erwarte den Weiterleitungscode.

TCP

Für alles, was kein HTTP spricht: Gameserver, Datenbanken, Mailserver. Geprüft wird, ob eine Verbindung auf den Port zustande kommt. Ob das Spiel dahinter wirklich Spieler annimmt, sieht eine TCP-Prüfung nicht.

DNS

Prüft, ob dein Name im DNS richtig auflöst. Du trägst den Hostnamen ein und wählst den Eintragstyp: A, AAAA, MX, CNAME, TXT oder NS. Gefragt werden öffentliche Resolver, also das, was auch deine Besucher sehen.

Optional gibst du unter Erwarteter Wert etwas an, etwa die IP deines Servers oder deinen Mailserver. Dann muss genau dieser Wert unter den Antworten sein; weitere Antworten daneben stören nicht. Groß- und Kleinschreibung spielen keine Rolle. Bei MX vergleichst du nur den Mailserver ohne Priorität (mx.example.com), bei TXT den ganzen Text, auch wenn er im DNS in mehrere Teile zerlegt ist.

Die Prüfung schlägt fehl, wenn es keine Antwort gibt oder der erwartete Wert fehlt.

SSL-Zertifikat

Prüft das Zertifikat, das dein Server ausliefert: ob die Kette vertrauenswürdig ist, ob es zum Hostnamen passt und ob es gerade gültig ist. Als Ziel reicht der Host, z. B. example.com; für einen anderen Port als 443 schreibst du ihn dazu, etwa mail.example.com:993.

Die Warnfrist stellst du unter Warnen ab (Tagen vor Ablauf) ein: zwischen 1 und 90 Tagen, Standard 14. So siehst du rechtzeitig, wenn eine automatische Verlängerung hängt, bevor deine Besucher eine Fehlermeldung im Browser bekommen.

Heartbeat

Die anderen Prüfarten fragen deinen Dienst von außen ab. Ein Heartbeat dreht das um: dein Job meldet sich bei uns. Das passt für alles, was man von außen nicht sieht, etwa Cronjobs, Backups oder Sync-Skripte.

So richtest du ihn ein:

1. Komponente mit der Prüfart Heartbeat anlegen.
2. Unter Erwarteter Abstand (Sekunden) stellst du ein, wie oft dein Job läuft, vom kürzesten Intervall deines Pakets bis 24 Stunden.
3. Unter Kulanz (Sekunden) gibst du an, wie viel später der Aufruf noch kommen darf: Standard 60 Sekunden, bis zu 24 Stunden. Läuft dein Backup mal länger, verhindert die Kulanz einen Fehlalarm.
4. Nach dem Anlegen zeigt das Dashboard unter Bearbeiten die Heartbeat-Adresse, etwa https://acme.statuscx.eu/hb/…. Die rufst du am Ende jedes Laufs auf, per GET, HEAD oder POST:

curl -fsS -m 10 https://acme.statuscx.eu/hb/…

Im Crontab hängst du den Aufruf mit && an, dann meldet sich der Job nur, wenn er auch geklappt hat:

*/5 * * * * /pfad/backup.sh && curl -fsS -m 10 https://acme.statuscx.eu/hb/… >/dev/null

Kommt innerhalb von Abstand plus Kulanz kein Aufruf, wird die Komponente rot (großer Ausfall) und es öffnet sich automatisch ein Vorfall. Die Zeit läuft ab dem letzten Aufruf, bei einer neuen oder wieder eingeschalteten Komponente ab diesem Moment. Mit dem nächsten Aufruf ist sie sofort wieder grün.

Je URL zählt höchstens ein Aufruf alle 10 Sekunden; häufigere bekommen 429 und ändern nichts.

CitexNode-Dienst

Läuft dein Dienst bei uns, wählst du ihn aus einer Liste: deine Gameserver, Bots und anderen Instanzen, deine eigenen vServer und deine Deploy-Projekte. Der Status kommt dann direkt aus CitexNode; Adresse und Port musst du nicht pflegen, auch wenn sie sich ändern.

Intervall

Wie oft geprüft wird, stellst du je Komponente unter Intervall (Sekunden) ein. Das kürzeste Intervall hängt am Paket: 5 Minuten bei Free, 1 Minute bei Pro, 30 Sekunden bei Business. Das längste ist 1 Stunde, beim Heartbeat 24 Stunden.

Wann eine Komponente rot wird

Ein einzelner Fehlschlag reicht nicht. Erst wenn zwei Prüfungen hintereinander fehlschlagen, wird die Komponente rot und es öffnet sich automatisch ein Vorfall; deine Abonnenten und Webhooks werden benachrichtigt. Gelingen die Prüfungen wieder, wird der Vorfall von selbst geschlossen.

Beim Heartbeat zählt stattdessen die Frist aus Abstand und Kulanz, siehe oben. Ein SSL-Zertifikat kurz vor dem Ablauf färbt die Komponente nur gelb.

Läuft gerade eine Wartung, öffnet sich kein automatischer Vorfall. Mehr zu Vorfällen unter Vorfälle und Wartungen.

Gesamtstatus

Ganz oben auf deiner Seite steht ein Gesamtstatus. Er ist immer der schlechteste Wert aus den Komponenten, den offenen Vorfällen und einer laufenden Wartung. Eine einzige rote Komponente färbt also den ganzen Kopf.

Woher geprüft wird

Die Prüfungen laufen von unserem Server in Frankfurt am Main (Rechenzentrum Firstcolo, Adresse 110.34.38.189). Blockiert deine Firewall fremde Anfragen, sieht die Prüfung das als Ausfall. DNS-Prüfungen fragen öffentliche Resolver; beim Heartbeat kommt der Aufruf von deinem Server zu uns.

Wenn das Paket kleiner wird

Ein kleineres Paket löscht nichts. Komponenten über der neuen Grenze bleiben stehen, werden aber nicht mehr geprüft. Intervalle unter dem neuen Minimum werden auf das Minimum angehoben.