Diese Seite ist eine maschinelle Übersetzung der englischen Seite, die maßgeblich ist. Englische Seite lesen
Den Server von außen überwachen
Wie du einen Uptime-Monitor auf den Server richtest, wie du verhinderst, dass die Überwachung die laufenden Kosten erhöht, und wie du den Wartungsmodus (Wartung) von einem Ausfall unterscheidest. Die Probe-Pfade stehen im Abschnitt zu Health-Checks im Betriebsleitfaden.
Fakten zu Drittanbietern unten tragen das Datum, an dem sie bestätigt wurden, und ihre Quelle. Dienste ändern ihre Tarife und Oberflächen; prüfe die verlinkte Seite, bevor du dich auf ein Limit verlässt.
Welche URL überwacht werden soll
Abschnitt betitelt „Welche URL überwacht werden soll“| Pfad | Wofür | Greift auf die DB zu | Im Wartungsmodus |
|---|---|---|---|
GET /api/v1/instance/health |
Uptime-Monitore, Statusseiten, der Web-Client | Höchstens einmal pro 60 s und Prozess | 503 mit Retry-After und {"status":"maintenance"} |
GET /healthz, GET /health/live |
Die Liveness-Probe der Plattform | Nie | 200 {"status":"maintenance"} |
GET /readyz, GET /health/ready |
Die Readiness-Probe des Load Balancers oder von Kubernetes | Bei jeder Anfrage (gleichzeitige Anfragen teilen sich eine Prüfung) | 200 {"status":"maintenance"} |
Richte den externen Monitor auf /api/v1/instance/health aus, nicht auf /readyz (/health/ready): Dieser Pfad fragt bei jeder Anfrage die Datenbank ab,
sodass ein Monitor mit kurzem Intervall eine Scale-to-zero-Datenbank wach hält. Die Probes sind für deine Plattform gedacht.
Der Abschnitt monitoring von mycroblog-gcp prüft auf Google Cloud /health/live, der von mycroblog-aws prüft /readyz, jeweils vom plattformeigenen Monitor in einem langen Intervall: Sein uptime_period bestimmt, was das kostet, denn jede Prüfung weckt eine Instanz.
Wohin die eigenen Metriken, Traces und Fehlerberichte des Servers gehen, legt der Abschnitt observability derselben Module fest, den monitoring liest. Standardmäßig schickt er jedes davon an die Plattform: auf Google Cloud die Metriken an Cloud Monitoring, die Request-Traces an Cloud Trace und die Fehlerberichte an Error Reporting, alle drei aus dem, was Cloud Run ihnen sendet, mit aktivierten APIs; auf AWS die Metriken im Embedded Metric Format an CloudWatch, die Fehlerberichte an CloudWatch Logs und die Traces an X-Ray, über einen Collector, der in jedem Task neben dem Server läuft (Traces auf AWS ECS). monitoring braucht dort die Metriken: Es lehnt observability.metrics = "settings" ab, das metrics_exporter der Eingabe settings überlässt.
Antworten von /api/v1/instance/health (ohne Authentifizierung, Cache-Control: no-store):
| Zustand | HTTP | Body |
|---|---|---|
| Gesund | 200 |
{"status":"ok","checked_at":"<RFC 3339>"} |
| Nicht verfügbar (die Datenbank ist nicht erreichbar oder das Schema ist nicht angewendet) | 503 |
{"status":"unavailable","checked_at":"<RFC 3339>"} |
| Wartungsmodus | 503 mit Retry-After |
{"status":"maintenance"} |
/healthz und /readyz antworten im gesunden Zustand mit 200 und {"status":"ok"}, und /readyz antwortet mit 503 und einem Problem-Dokument, wenn die Datenbank nicht bereit ist. /health/live und /health/ready sind dieselben Prüfungen unter anderen Namen.
Rufe auf Cloud Run die Pfade auf, die nicht auf z enden. Cloud Run reserviert einige Pfade, die auf z enden, und beantwortet sie mit einem eigenen 404, bevor eine Anfrage den Container erreicht: /healthz ist einer davon, und nichts garantiert, dass /readyz weiter antwortet. Verwende von außerhalb einer Cloud-Run-Bereitstellung (ein Uptime-Monitor, curl) /health/live, /health/ready oder /api/v1/instance/health. Die Probes des Containers selbst sind nicht betroffen.
Der Body enthält nie einen Grund, Hostnamen oder eine Version. Die Ursache steht im Server-Log.
checked_at ist der Zeitpunkt der Prüfung, auf der die Antwort beruht. Der Server führt die Datenbankprüfung höchstens einmal pro Minute und Prozess aus und verwendet das Ergebnis weiter,
sodass ein Monitor, der häufiger als alle 60 s abfragt, dasselbe checked_at sieht und nichts gewinnt. Bei mehreren Prozessen führt jeder seine eigene Prüfung aus.
Ist origin_secret gesetzt, antworten diese drei Pfade weiterhin ohne den Header, zeigen also nicht, dass das CDN ihn verloren hat. Überwache auch eine Seite über das CDN, etwa https://<host>/about, wenn ein Monitor dein erstes Warnzeichen ist.
Das Monitoring günstig halten
Abschnitt betitelt „Das Monitoring günstig halten“- Auf null skalierende Datenbanken. Ist das Intervall des Monitors kürzer als die Zeit, die die Datenbank wartet, bevor sie stoppt, stoppt die Datenbank nie. Neon setzt eine Compute nach 5 Minuten ohne Aktivität aus; der Free-Tarif kann das nicht abschalten (bestätigt 2026-10-25, Neon: Scale to zero). Als Faustregel lässt ein Intervall von 5 Minuten oder mehr eine untätige Datenbank zwischen den Prüfungen stoppen, und jede Prüfung weckt sie für die Prüfung plus die Leerlaufzeit. Ein föderierter Server erhält rund um die Uhr Zustellungen von anderen Servern, daher ist seine Datenbank ohnehin einen großen Teil des Tages wach; die Zusatzkosten beschränken sich auf die ruhigen Stunden.
- Bevorzuge eine günstigere Aufteilung, wenn dir die Kosten im Leerlauf am wichtigsten sind. Überwache
/health/live(es berührt nie die Datenbank) in einem kurzen Intervall und das datenbankgestützte/api/v1/instance/healthin einem langen (15 Minuten oder mehr)./health/liveantwortet auch im Wartungsmodus mit200, gleiche also"status":"ok"im Body ab. - Die Anfragen selbst sind klein. Eine Prüfung alle 5 Minuten sind etwa 8.640 Anfragen im Monat, jede Minute etwa 43.200. Das passt in das Free-Kontingent von Cloud Run (2 Millionen Anfragen, 180.000 vCPU-Sekunden und 360.000 GiB-Sekunden im Monat; Zeit auf 100 ms aufgerundet; bestätigt 2026-10-23, Cloud-Run-Preise).
Den Wartungsmodus von einem Ausfall unterscheiden
Abschnitt betitelt „Den Wartungsmodus von einem Ausfall unterscheiden“Im Wartungsmodus (Wartungsleitfaden) antwortet der Health-Endpunkt mit 503, was die meisten Monitore wie einen Ausfall behandeln.
Der Statuscode allein kann sie nicht unterscheiden, entscheide also anhand des Bodys:
- Behandle
"status":"ok"im Body als gesund und alles andere als ausgefallen. Ein Keyword- oder JSON-Wert-Monitor tut das. - Um Alarme bei geplanter Wartung zu vermeiden, setze das Wartungsfenster des Monitors, falls der Dienst eines hat (siehe die Tabelle unten), oder pausiere den Monitor vor dem Start von Hand.
- Der Free-Tarif von UptimeRobot hat kein Wartungsfenster: Pausiere den Monitor oder nimm den Alarm in Kauf.
Die Monitore einrichten
Abschnitt betitelt „Die Monitore einrichten“Alle prüfen dasselbe: GET https://<your-host>/api/v1/instance/health ist gesund, wenn die Antwort 200 ist und der Body "status":"ok" enthält.
| Dienst | Monitor-Typ | Gesund, wenn | Wartungsfenster | Bestätigt |
|---|---|---|---|---|
| UptimeRobot | Keyword | Der Body enthält "status":"ok" |
Nicht in Free (Solo und höher) | 2026-10-25, Preise |
| Better Stack | HTTP-Status oder Keyword | 2xx, oder der Body enthält "status":"ok" |
Ungeprüft | 2026-10-25 |
| Gatus | Endpoint-Bedingungen | [STATUS] == 200 und [BODY].status == ok |
maintenance in der Konfiguration |
2026-10-25, README |
| Uptime Kuma | HTTP(s) - Keyword oder JSON Query | Der Body enthält "status":"ok", oder status ist ok |
Eingebaut | 2026-10-23, README |
| Upptime | sites in .upptimerc.yml |
200 und der Body enthält "status":"ok" |
Keines | 2026-10-25, Konfiguration |
UptimeRobot
Abschnitt betitelt „UptimeRobot“Lege einen Monitor vom Typ Keyword an: URL https://<your-host>/api/v1/instance/health, Keyword "status":"ok", Alarm, wenn das Keyword nicht vorhanden ist.
Der Free-Tarif erlaubt 50 Monitore in einem Intervall von 5 Minuten und enthält Keyword-Monitore.
„Custom headers & statuses“ und Wartungsfenster beginnen im Solo-Tarif (kostenpflichtig, Intervall von 60 Sekunden)
(bestätigt 2026-10-25, Preise). Ein Keyword-Monitor genügt hier, weil die Prüfung den Body betrifft.
Better Stack
Abschnitt betitelt „Better Stack“Zwei Formen funktionieren (bestätigt 2026-10-25, Uptime monitor, Keyword monitor):
- Ein HTTP-Status-Monitor: Er behandelt eine
2xx-Antwort als erreichbar, also ist200erreichbar, und503(nicht verfügbar oder Wartung) öffnet einen Vorfall. - Ein Keyword-Monitor: „Alert us when“ ist „URL doesn’t contain keyword“, Keyword
"status":"ok". Die Übereinstimmung unterscheidet nicht zwischen Groß- und Kleinschreibung.
Die Prüfhäufigkeit und die Wartungsfenster des Free-Tarifs sind ungeprüft: Die offiziellen Seiten nennen sie für den Free-Tarif nicht. Die Zahlen des kostenlosen Tarifs (10 Monitore und Heartbeats zusammen, eine Statusseite) stammen von der Preisseite, bestätigt 2026-10-23.
In config.yaml (Standardintervall 60s; bestätigt 2026-10-25, README):
endpoints: - name: my url: "https://<your-host>/api/v1/instance/health" interval: 5m conditions: - "[STATUS] == 200" - "[BODY].status == ok"Gatus hat einen maintenance-Abschnitt auf oberster Ebene (start als hh:mm, duration, timezone mit Standard UTC, every als Liste von Wochentagen, leer bedeutet jeden Tag)
für geplante Arbeiten. Die README sagt nur, dass er dazu dient, Alarme während Wartungsfenstern zu vermeiden; prüfe das Verhalten in deiner Version.
Uptime Kuma
Abschnitt betitelt „Uptime Kuma“Füge einen Monitor vom Typ HTTP(s) - Keyword mit dem Keyword "status":"ok" hinzu, oder HTTP(s) - Json Query mit der Abfrage status und dem erwarteten Wert ok.
Die akzeptierten Statuscodes sind standardmäßig 200-299, sodass das 503 der Wartung und das 503 des Ausfalls beide als ausgefallen gelten. Uptime Kuma hat eine Wartungsfunktion
für Monitor-Fenster (das Wiki nennt sie; ihre Details sind ungeprüft).
Die Monitor-Typen wurden 2026-10-23 im Quellcode bestätigt (monitor.js,
EditMonitor.vue).
Upptime
Abschnitt betitelt „Upptime“In .upptimerc.yml (bestätigt 2026-10-25, Konfiguration):
sites: - name: My server url: https://<your-host>/api/v1/instance/health __dangerous__body_down_if_text_missing: '"status":"ok"'Standardmäßig gelten 20x und 30x als erreichbar; setze expectedStatusCodes: [200], um nur 200 zu akzeptieren. Die Prüfung läuft aus GitHub Actions nach einem Zeitplan, der für alle Sites gilt
(workflowSchedule.uptime, standardmäßig alle 5 Minuten, was auch das Kürzeste ist, das GitHub Actions erlaubt). Der Optionsname sagt, dass sie nicht empfohlen ist,
aber sie ist der Weg, den Body zu testen.
Eine Statusseite
Abschnitt betitelt „Eine Statusseite“Setze status_page_url (MY_STATUS_PAGE_URL, eine https:-URL; siehe die Konfigurationsreferenz)
auf die öffentliche Seite deines Monitors. Der Server zeigt den Link in GET /api/v1/instance, in den Anmelde- und Fehlerseiten, die er rendert, im Web-Client
(auch wenn der Server nicht antwortet) und auf der Wartungsseite, sodass ein Nutzer, der den Server nicht erreicht, herausfinden kann, warum.
Er wird aus der Konfiguration gelesen, nicht aus der Datenbank, funktioniert also, wenn die Datenbank ausgefallen ist. Eine Änderung wirkt nach einem Neustart.
Optionen für die Seite selbst (dieser Server übernimmt den Zustand einer Statusseite nicht, veröffentliche Meldungen also zusätzlich als serverweiten Hinweis):
- Die gehostete Statusseite des gewählten Überwachungsdienstes (der Free-Tarif von UptimeRobot hat eine Statusseite ohne Anpassung; der kostenlose Tarif von Better Stack hat eine), die Seiten, die Gatus und Uptime Kuma selbst ausliefern, oder die statische Site von Upptime auf GitHub Pages.
- Atlassian Statuspage, das ein Ort zum Veröffentlichen und kein Monitor ist. Eine Komponente hat einen von fünf Zuständen: Operational, Under maintenance, Degraded performance,
Partial outage, Major outage (API-Werte
operational,under_maintenance,degraded_performance,partial_outage,major_outage; bestätigt 2026-10-23, What is a component?, Statuspage API). Wie sich der Zustand einer Komponente automatisch aus dem Alarm eines Monitors ändern lässt, ist ungeprüft (es braucht eine dienstspezifische Integration, die auf einem echten Konto eingerichtet wird).
Für LLMs und Coding-Agenten:llms.txt,llms-full.txt, llms-small.txt