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

  1. Erstellen Sie einen API-Schlüssel unter Einstellungen › API. Nur Lesen genügt.

  2. Fügen Sie in prometheus.yml einen Scrape-Job hinzu: Ziel app.uptimecheck.com, Schema https, Metrics-Pfad /api/v1/metrics und der Schlüssel als Bearer-Token.

  3. Setzen Sie scrape_interval auf 60s oder 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
Ein Scrape-Job und ein Teil dessen, was er zurückbekommt, im Textformat von Prometheus. Jeder Monitor im Workspace hat seine eigene Zeitreihe.

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.

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