Op Professional en Business kan Prometheus elke monitor in je workspace scrapen via één endpoint, https://app.uptimecheck.com/api/v1/metrics, met een API-sleutel. Je krijgt de status, reactietijd en uptime over 24 uur van elke monitor als metrics, klaar voor je eigen alertregels en voor grafieken in Grafana via Prometheus.
Maak een API-sleutel aan
- Open Instellingen in de zijbalk en kies het tabblad API.
- Kies Nieuwe API-sleutel, geef hem een naam naar waar hij gebruikt wordt, zoals ‘Prometheus’, en kies Alleen lezen. Meer is voor metrics niet nodig.
- Kies Sleutel maken en kopieer hem. Dit is de enige keer dat de sleutel getoond wordt.
Voeg een scrape-job toe
Voeg een job toe aan prometheus.yml, zet je sleutel op de plek van uc_your_api_key en herlaad Prometheus:
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"]
Houd scrape_interval op 60 seconden of meer: de API staat 120 verzoeken per minuut per sleutel toe, gedeeld met al het andere dat de sleutel gebruikt. Wil je de sleutel niet in het bestand, gebruik dan credentials_file met het pad naar een bestand waarin hij staat, in plaats van credentials. Het nieuwe target hoort binnen een minuut als up te verschijnen op de targets-pagina van Prometheus.
Wat je krijgt
uptimecheck_monitor_up: 1 als de laatste check slaagde, 0 als die mislukte. Gepauzeerde monitors en monitors die nog niet gecheckt zijn, ontbreken.uptimecheck_monitor_paused: 1 zolang de monitor gepauzeerd is.uptimecheck_monitor_response_ms: de reactietijd van de laatste check, in milliseconden.uptimecheck_monitor_last_check_timestamp_seconds: wanneer de monitor voor het laatst gecheckt is, als Unix-tijd.uptimecheck_monitor_uptime_ratio: het deel van de afgelopen 24 uur dat de monitor bereikbaar was, van 0 tot 1.uptimecheck_open_incidents: de storingen die nu openstaan in de workspace.
Elke monitor-metric heeft de labels monitor_id, name, type en project, zodat je kunt filteren op het project van een klant of op monitortype.
Erop alerten
Een Prometheus-regel die afgaat als een monitor twee minuten down is:
groups:
- name: uptimecheck
rules:
- alert: UptimecheckMonitorDown
expr: uptimecheck_monitor_up == 0
for: 2m
labels:
severity: critical
annotations:
summary: "{{ $labels.name }} is down"
Uptimecheck blijft zijn eigen meldingen naar je meldingskanalen sturen, dus regels als deze zijn een aanvulling, geen vervanging. Meer over de Prometheus-integratie, API-sleutels en de REST API.