- Startseite
- Integrationen
- Prometheus
Integration · Entwickler
Ihre Monitore in Prometheus
Scrapen Sie einen Endpunkt mit einem API-Schlüssel und erhalten Sie Status, Antwortzeit und 24-Stunden-Uptime jedes Monitors als Prometheus-Metriken, direkt neben dem Rest Ihrer Infrastruktur.
14 Tage kostenlos testen · Danach gratis für 20 Monitore · Keine Kreditkarte
Was Sie bekommen
-
Jeder Monitor, ein Scrape
Erreichbar oder nicht, pausiert, die letzte Antwortzeit, der Zeitpunkt des letzten Checks und der Anteil der letzten 24 Stunden, in denen er erreichbar war, für jeden Monitor im Workspace.
-
Labels zum Filtern
Jede Zeitreihe trägt monitor_id, name, type und project, sodass Sie in PromQL nach Kundenprojekt oder Monitortyp gruppieren können.
-
Regeln im eigenen Stack
Schreiben Sie Alarmregeln auf uptimecheck_monitor_up oder uptimecheck_open_incidents neben denen, die Sie schon betreiben. Die Alarme von Uptimecheck selbst laufen weiter wie bisher.
-
Diagramme in Grafana
Mit Prometheus als Datenquelle stellen Sie Antwortzeiten und Uptime in Grafana neben Ihren eigenen Metriken dar.
So verbinden Sie Prometheus
-
Erstellen Sie einen API-Schlüssel unter Einstellungen › API. Nur Lesen genügt.
-
Fügen Sie in
prometheus.ymleinen Scrape-Job hinzu: Zielapp.uptimecheck.com, Schemahttps, Metrics-Pfad/api/v1/metricsund der Schlüssel als Bearer-Token. -
Setzen Sie
scrape_intervalauf60soder mehr, laden Sie Prometheus neu und prüfen Sie, ob das neue Ziel erreichbar ist.
Der Endpunkt ist in der API-Referenz beschrieben.
In Professional und Business, mit einem API-Schlüssel aus Einstellungen › API. Ein Schlüssel mit reinem Lesezugriff genügt.
Was gemessen wird
- uptimecheck_monitor_up
- 1, wenn der letzte Check erfolgreich war, 0, wenn er fehlschlug
- uptimecheck_monitor_paused
- 1, solange der Monitor pausiert ist
- uptimecheck_monitor_response_ms
- Antwortzeit des letzten Checks in Millisekunden
- uptimecheck_monitor_last_check_timestamp_seconds
- Zeitpunkt des letzten Checks als Unix-Zeit
- uptimecheck_monitor_uptime_ratio
- Anteil der letzten 24 Stunden, in denen er erreichbar war, von 0 bis 1
- uptimecheck_open_incidents
- Aktuell offene Vorfälle im Workspace
prometheus.yml
scrape_configs:
- job_name: uptimecheck
scrape_interval: 60s
scheme: https
metrics_path: /api/v1/metrics
authorization:
type: Bearer
credentials: uc_your_api_key
static_configs:
- targets: ["app.uptimecheck.com"]
GET /api/v1/metrics
# HELP uptimecheck_monitor_up Whether the monitor's last check passed (1) or failed (0).
# TYPE uptimecheck_monitor_up gauge
uptimecheck_monitor_up{monitor_id="mon_9xk2m1q8w4",name="Checkout",type="http",project="Northwind"} 0
uptimecheck_monitor_up{monitor_id="mon_4hd8s2k7p1",name="Storefront",type="http",project="Northwind"} 1
# HELP uptimecheck_monitor_response_ms Response time of the last check, in milliseconds.
# TYPE uptimecheck_monitor_response_ms gauge
uptimecheck_monitor_response_ms{monitor_id="mon_4hd8s2k7p1",name="Storefront",type="http",project="Northwind"} 184
# HELP uptimecheck_monitor_uptime_ratio Share of the last 24 hours the monitor was up (0 to 1), over the time it was monitored.
# TYPE uptimecheck_monitor_uptime_ratio gauge
uptimecheck_monitor_uptime_ratio{monitor_id="mon_9xk2m1q8w4",name="Checkout",type="http",project="Northwind"} 0.995139
uptimecheck_monitor_uptime_ratio{monitor_id="mon_4hd8s2k7p1",name="Storefront",type="http",project="Northwind"} 1
# HELP uptimecheck_open_incidents Incidents open right now in the workspace.
# TYPE uptimecheck_open_incidents gauge
uptimecheck_open_incidents 1
Fragen
Welche Metriken gibt es?
uptimecheck_monitor_up (1 oder 0), uptimecheck_monitor_paused, uptimecheck_monitor_response_ms, uptimecheck_monitor_last_check_timestamp_seconds, uptimecheck_monitor_uptime_ratio über die letzten 24 Stunden und uptimecheck_open_incidents für den Workspace. Monitor-Metriken tragen die Labels monitor_id, name, type und project.
Wie oft sollte Prometheus scrapen?
Alle 60 Sekunden oder seltener. So bleiben Sie innerhalb des Rate-Limits der API von 120 Anfragen pro Minute und Schlüssel, das sich alle Nutzungen des Schlüssels teilen.
Warum fehlt ein Monitor in uptimecheck_monitor_up?
Pausierte Monitore und Monitore, die noch nicht geprüft wurden, fehlen in uptimecheck_monitor_up und bei der Antwortzeit. Ein pausierter Monitor zeigt 1 in uptimecheck_monitor_paused.
Welche Tarife enthalten es?
Professional und Business, wie die REST API. Jeder API-Schlüssel funktioniert, auch einer mit reinem Lesezugriff.
Kann ich die Metriken in Grafana darstellen?
Ja, über Prometheus: Fügen Sie Ihr Prometheus in Grafana als Datenquelle hinzu und stellen Sie die uptimecheck_-Metriken wie jede andere dar.
Passt gut zu
Alle Integrationen-
REST API
Monitore, Vorfälle, Wartungen und Status-Updates, mit einem OpenAPI-Dokument. Weiterlesen : REST API -
Webhooks
Jeder Alarm als signiertes JSON an Ihren eigenen Endpunkt, mit Wiederholungen. So funktioniert es : Webhooks -
MCP-Server
Lassen Sie Claude, Cursor oder VS Code mit einem API-Schlüssel den Status prüfen und Monitore verwalten. So funktioniert es : MCP-Server
Erfahren Sie es von uns, nicht von Ihren Kunden.
Klicken Sie sich ohne Konto durch die Live-Demo – oder starten Sie Ihre Testphase und legen Sie Ihren ersten Monitor an.
14 Tage kostenlos testen · Danach gratis für 20 Monitore · Keine Kreditkarte