Öffentliche Statusseite (/status)
http://[서버IP]/status ist eine Verfügbarkeitsseite, die ohne Login geöffnet werden kann.
Sie soll Ihnen ermöglichen, zu sehen, «wo gerade etwas ausgefallen ist», selbst wenn Sie nicht in die Konsole gelangen.
Es gibt keinen Link im Konsolenmenü — Sie erreichen die Seite, indem Sie die Adresse direkt eingeben. Es ist hilfreich, diese Adresse auf einem Vor-Ort-Display oder im internen Wiki zu verlinken.
Was angezeigt wird
┌────────────────────────────────────────────────┐
│ 플랜트펄스 상태 │
│ 🟢 모든 시스템 정상 │
│ 24시간 가용성 99.95% 마지막 갱신 12:34:56 │
├── 인프라 ─────────────────────────────────────┤
│ 이벤트 스토어 · 스트림 · MQTT · 캐시 · … │
├── API 엔드포인트 ─────────────────────────────┤
│ auth 🟢 99.98% p99 45ms 성공 12,345 / 오류 2│
│ ▁▁▁▂▁▁▁▁▁▁▁▁▁▁ (90칸 타임라인) │
└────────────────────────────────────────────────┘
5초마다 자동 갱신
Oben — Gesamtstatus
| Anzeige | Bedeutung |
|---|---|
| 🟢 Alle Systeme normal | Alle OPERATIONAL |
| 🟡 Teilsysteme mit Leistungseinbußen | Mindestens eines ist DEGRADED |
| 🔴 Schwerwiegende Störung | Mindestens eines ist OUTAGE |
Daneben werden 24-Stunden-Verfügbarkeit und der Zeitpunkt der letzten Aktualisierung angezeigt. Bei Verbindungsabbruch wird «Verbindung unterbrochen. Wird erneut versucht...» angezeigt.
Infrastruktur — 13 Komponenten
| Anzeigename | Was |
|---|---|
| Event-Store | Ereignis-Speicher |
| Stream | Stream-Verarbeitung |
| MQTT | Messaging-Broker |
| Cache | In-Memory-Cache |
| Metastore | Metadaten-DB |
| Analyse-Store | Speicher für Analysen |
| Knoten-OS | Server-Betriebssystem |
| Zeitreihen-Engine | Zeitreihen-DB |
| Komplexe Ereignisverarbeitung | CEP-Engine |
| Daten-Gateway | Erfassungs-Gateway |
| Workflow-Engine | Temporal |
| Batch-Orchestrator | Kestra |
| Objekt-Speicher | RustFS |
Die Bedeutung der einzelnen Punkte und die Definition der Statusfarben finden Sie unter Statuscode-Definition.
API-Endpunkte
Für jeden Endpunkt wird eine Karte angezeigt, mit den folgenden Angaben.
| Punkt | Bedeutung |
|---|---|
| 24-Stunden-Verfügbarkeit | Erfolgsquote der letzten 24 Stunden |
| p99-Antwortzeit | Schlechteste Antwortzeit außerhalb der obersten 1% (ms) |
| Erfolgreich (24 h) · Fehler (24 h) | Anzahl der Aufrufe |
| 90-Segment-Timeline | Statusbalken der letzten 90 Intervalle |
Wenn nicht genügend Messdaten vorliegen, wird «Keine Daten» oder «N/M Minuten gemessen» angezeigt —
dies erklärt eine niedrige Verfügbarkeit bei einem gerade gestarteten Server.
Woher die Daten kommen
Die Seite selbst ist eine leere Hülle, die der Browser alle 5 Sekunden durch Polling von GET /api/v5/public/status befüllt.
curl -s http://[서버IP]/api/v5/public/status
{
"data": {
"overall_status": "OPERATIONAL",
"as_of": 1717400000000,
"uptime_24h_percent": 99.95,
"endpoints": [
{
"name": "auth", "category": "auth", "status": "OPERATIONAL",
"uptime_percent_24h": 99.98, "p99_latency_ms": 45,
"success_count_24h": 12345, "error_count_24h": 2,
"timeline_90": ["ok", "ok", "degraded", "ok"]
}
]
},
"meta": { "timestamp": 1717400000000, "status": "OK", "pagination": null },
"errors": null
}
Weder API-Key noch Sitzung erforderlich. Sie kann direkt von Überwachungstools oder Dashboards abgerufen werden.
/status und /api/v5/public/status sind für jeden einsehbar. Da die Namen der Infrastrukturkomponenten
und deren Ausfallstatus sichtbar sind, sollten Sie bei direkt im Internet exponierten Servern diese beiden Pfade
über den Reverse-Proxy auf das interne Netzwerk beschränken. Bei Installationen im internen Netzwerk ist es praktischer, sie so zu belassen.
Unterschied zum Healthcheck
/status | /api/health | |
|---|---|---|
| Zweck | Für Menschen gedachte Verfügbarkeitsseite | Für Maschinen gedachter Readiness-Check |
| Authentifizierung | Keine | Keine |
| Antwort | 24-Stunden-Statistik, Latenz, Timeline | status / service / ts / checks |
| Verwendungsort | Browser, Dashboard | Container-Healthcheck, HA-Gate, CI |
Verwenden Sie für Healthchecks in Containern oder Load-Balancern /api/health.
/status basiert auf einer 24-Stunden-Aggregation und reagiert nicht auf kurzfristige Störungen.
Häufig gestellte Fragen
F. Ich gebe die Adresse ein, lande aber auf der Anmeldeseite.
A. Der Pfad muss exakt /status sein (auch /status/ oder /status/index sind zulässig).
Prüfen Sie auch, ob der Reverse-Proxy den Zugriff blockiert.
F. Nach der Installation wird eine Verfügbarkeit von 0% angezeigt.
A. Da es sich um eine 24-Stunden-Aggregation handelt, müssen sich erst Messintervalle ansammeln. Achten Sie auf die Anzeige «N/M Minuten gemessen».
F. Eine Infrastrukturkomponente bleibt durchgehend rot. A. Prüfen Sie unter Monitoring, ob die Komponente tatsächlich läuft. Je nach Installationskonfiguration sind einige Komponenten gar nicht bereitgestellt.
Verwandte Ansichten
- Statuscode-Definition — Definition von Statuswerten und Farben
- Monitoring — Detailliertes Monitoring für Administratoren
- Diagnose — Ursachenanalyse von Störungen
- Ports — Welche Ports geöffnet werden müssen