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
- Öffnen Sie Einstellungen in der Seitenleiste und wählen Sie den Tab API.
- 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.
- 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.