Uptimecheck-metrics scrapen met Prometheus

Bijgewerkt op 15 november 2026 2 min. leestijd

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

  1. Open Instellingen in de zijbalk en kies het tabblad API.
  2. 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.
  3. 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.

Was dit artikel nuttig?

Probeer het in je eigen workspace

14 dagen gratis proberen · Daarna gratis met 20 monitors · Geen creditcard

Kom je er niet uit?

Mail support@uptimecheck.com en we antwoorden binnen 24 uur.

Wil je het automatiseren? De API-referentie behandelt de REST API, webhooks, cronjob-pings en MCP.