Komponenten

Eine Komponente ist ein Teil deines Dienstes, über den du getrennt Auskunft gibst — API, Web-App, Datenbank, E-Mail-Versand. Jede hat einen eigenen Zustand, und aus diesen Zuständen ergibt sich der Gesamtstatus oben auf der Seite.

Schneide sie so zu, wie deine Kunden deinen Dienst erleben, nicht wie deine Infrastruktur aufgebaut ist. „Checkout" sagt einem Kunden mehr als „Payment-Worker-Pool 3".

Die fünf Zustände

Zustand	Bedeutung
Betriebsbereit	Alles normal.
Beeinträchtigte Leistung	Läuft, aber langsam oder unzuverlässig.
Teilausfall	Ein Teil funktioniert nicht, ein anderer schon.
Großer Ausfall	Nicht nutzbar.
Wartung	Geplante Arbeiten laufen.

Der Gesamtstatus der Seite ist immer der schlechteste Zustand unter den sichtbaren Komponenten. Eine Komponente im großen Ausfall macht die ganze Seite rot — das ist Absicht, denn genau das erlebt ein betroffener Kunde.

Auf die Uptime wirken sich die Zustände unterschiedlich aus, siehe Uptime.

Was du je Komponente einstellst

Name — was der Kunde liest.
Beschreibung — ein Satz darunter, optional. Gut für Abgrenzungen: „umfasst auch die Webhooks".
Gruppe — optional, siehe unten.
Aktueller Status — lässt sich direkt setzen, ohne einen Vorfall anzulegen. Für kurze Dinge, über die es nichts zu erzählen gibt.
Position — die Reihenfolge auf der Seite. Kleinere Zahl steht weiter oben.
Uptime anzeigen — blendet die Balken für genau diese Komponente aus. Sinnvoll für etwas, das du erst seit gestern misst.
Uptime-Startdatum — ab wann gerechnet wird. Davor bleiben die Balken leer, statt 100 % zu behaupten, wo nichts gemessen wurde.
Sichtbar — nimmt die Komponente von der öffentlichen Seite, ohne sie zu löschen. Sie zählt dann auch nicht in den Gesamtstatus.

Gruppen

Ab einer Handvoll Komponenten wird die Liste unübersichtlich. Gruppen fassen zusammen, was zusammengehört — Kernplattform, Integrationen, Regionen.

Je Gruppe stellst du ein:

Name und Beschreibung
Position in der Liste
Standardmäßig eingeklappt — die Gruppe startet zugeklappt. Praktisch für lange Listen, bei denen die meisten Besucher nur wissen wollen, ob oben alles grün ist.
Sichtbar — wie bei Komponenten.

Eine Komponente ohne Gruppe steht oberhalb der Gruppen, nicht darunter. Damit bleibt das Wichtigste oben, auch wenn der Rest sortiert ist.

Dieselbe Komponente in mehreren Gruppen: Beim Anlegen kannst du mehrere Gruppen wählen. Dann entsteht je Gruppe eine eigene Komponente mit eigenem Status, etwa Server in eu01 und in eu02. Fällt der Server in eu01 aus, bleibt eu02 grün. Jede zählt einzeln zum Komponentenlimit deines Tarifs. Danach bearbeitest du sie einzeln. Über die API legst du sie mit einem Aufruf je Gruppe an.

Gruppen sind ab dem Tarif Basic verfügbar.

Wie sich der Zustand ändert

Sechs Wege, und alle landen im Audit-Log:

Von Hand im Dashboard — direkt an der Komponente.
Durch einen Vorfall — die betroffenen Komponenten nehmen den Zustand an, den der Schweregrad vorgibt. Wird der Vorfall gelöst, gehen sie zurück auf betriebsbereit, sofern kein anderer offener Vorfall sie hält.
Durch eine Wartung — wenn Komponentenstatus ändern aktiv ist, gehen die betroffenen Komponenten für die Dauer auf Wartung.
Durch einen HTTP-Check — wenn er die Komponente umschalten darf, setzt er sie bei einem bestätigten Ausfall selbst.
Über die API — POST /api/v1/components/{id}/status, siehe unten.
Über einen KI-Assistenten — mit dem Werkzeug set-component-status des MCP-Servers.

Über die API

curl -X POST https://statuswerk.eu/api/v1/components \
  -H "Authorization: Bearer $STATUSWERK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "API", "description": "REST-Schnittstelle", "visible": true}'

# Nur den Status setzen
curl -X POST https://statuswerk.eu/api/v1/components/{id}/status \
  -H "Authorization: Bearer $STATUSWERK_TOKEN" \
  -d '{"status": "degraded_performance"}'

Vollständig in der API-Referenz.