So scrapen Sie Uptimecheck-Metriken mit Prometheus

Aktualisiert am 15. November 2026 2 Min. Lesezeit

In Professional und Business kann Prometheus jeden Monitor in Ihrem Workspace über einen einzigen Endpunkt scrapen, https://app.uptimecheck.com/api/v1/metrics, mit einem API-Schlüssel. Sie erhalten Status, Antwortzeit und 24-Stunden-Uptime jedes Monitors als Metriken, bereit für eigene Alarmregeln und für Diagramme in Grafana über Prometheus.

API-Schlüssel erstellen

  1. Öffnen Sie Einstellungen in der Seitenleiste und wählen Sie den Tab API.
  2. Wählen Sie Neuer API-Schlüssel, benennen Sie ihn nach seinem Einsatzort, etwa „Prometheus“, und wählen Sie Nur Lesen. Mehr brauchen die Metriken nicht.
  3. Wählen Sie Schlüssel erstellen und kopieren Sie ihn. Er wird nur dieses eine Mal angezeigt.

Scrape-Job anlegen

Fügen Sie in prometheus.yml einen Job hinzu, setzen Sie Ihren Schlüssel anstelle von uc_your_api_key ein und laden Sie Prometheus neu:

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"]

Lassen Sie scrape_interval bei 60 Sekunden oder mehr: Die API erlaubt 120 Anfragen pro Minute und Schlüssel, geteilt mit allem anderen, was den Schlüssel nutzt. Um den Schlüssel aus der Datei herauszuhalten, verwenden Sie credentials_file mit dem Pfad zu einer Datei, die ihn enthält, statt credentials. Das neue Ziel sollte innerhalb einer Minute auf der Targets-Seite von Prometheus als erreichbar erscheinen.

Was Sie bekommen

  • uptimecheck_monitor_up: 1, wenn der letzte Check erfolgreich war, 0, wenn er fehlschlug. Pausierte und noch nicht geprüfte Monitore fehlen.
  • uptimecheck_monitor_paused: 1, solange der Monitor pausiert ist.
  • uptimecheck_monitor_response_ms: die Antwortzeit des letzten Checks in Millisekunden.
  • uptimecheck_monitor_last_check_timestamp_seconds: der Zeitpunkt des letzten Checks als Unix-Zeit.
  • uptimecheck_monitor_uptime_ratio: der Anteil der letzten 24 Stunden, in denen der Monitor erreichbar war, von 0 bis 1.
  • uptimecheck_open_incidents: die aktuell offenen Vorfälle im Workspace.

Jede Monitor-Metrik trägt die Labels monitor_id, name, type und project, sodass Sie nach dem Projekt eines Kunden oder nach Monitortyp filtern können.

Darauf alarmieren

Eine Prometheus-Regel, die auslöst, wenn ein Monitor seit zwei Minuten ausgefallen ist:

groups:
  - name: uptimecheck
    rules:
      - alert: UptimecheckMonitorDown
        expr: uptimecheck_monitor_up == 0
        for: 2m
        labels:
          severity: critical
        annotations:
          summary: "{{ $labels.name }} is down"

Uptimecheck sendet weiterhin seine eigenen Alarme an Ihre Alarmkanäle, solche Regeln sind also eine Ergänzung, kein Ersatz. Mehr zur Prometheus-Integration, zu API-Schlüsseln und zur REST API.

War dieser Artikel hilfreich?

Testen Sie es in Ihrem eigenen Workspace

14 Tage kostenlos testen · Danach gratis für 20 Monitore · Keine Kreditkarte

Kommen Sie nicht weiter?

Schreiben Sie an support@uptimecheck.com, wir antworten innerhalb von 24 Stunden.

Sie möchten automatisieren? Die API-Referenz deckt REST-API, Webhooks, Cron-Job-Pings und MCP ab.