Integratie · Developers

Je monitors in Prometheus

Scrape één endpoint met een API-sleutel en krijg de status, reactietijd en uptime over 24 uur van elke monitor als Prometheus-metrics, naast de rest van je infrastructuur.

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

Wat je krijgt

  • Elke monitor, één scrape

    Bereikbaar of niet, gepauzeerd, de laatste reactietijd, wanneer hij voor het laatst gecheckt is en het deel van de afgelopen 24 uur dat hij bereikbaar was, voor elke monitor in de workspace.

  • Labels om op te filteren

    Elke reeks heeft monitor_id, name, type en project, zodat je in PromQL kunt groeperen op klantproject of monitortype.

  • Regels in je eigen stack

    Schrijf alertregels op uptimecheck_monitor_up of uptimecheck_open_incidents naast de regels die je al hebt. De meldingen van Uptimecheck zelf blijven gewoon werken.

  • Grafieken in Grafana

    Met Prometheus als databron toon je reactietijden en uptime in Grafana naast je eigen metrics.

Prometheus koppelen

  1. Maak een API-sleutel aan onder Instellingen › API. Alleen lezen is genoeg.

  2. Voeg een scrape-job toe aan prometheus.yml: target app.uptimecheck.com, scheme https, metrics-pad /api/v1/metrics en de sleutel als bearer-token.

  3. Zet scrape_interval op 60s of meer, herlaad Prometheus en controleer of het nieuwe target up is.

Het endpoint staat beschreven in de API-referentie.

Op Professional en Business, met een API-sleutel uit Instellingen › API. Een sleutel met alleen leesrechten is genoeg.

Wat het meet

uptimecheck_monitor_up
1 als de laatste check slaagde, 0 als die mislukte
uptimecheck_monitor_paused
1 zolang de monitor gepauzeerd is
uptimecheck_monitor_response_ms
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
Deel van de afgelopen 24 uur dat hij bereikbaar was, van 0 tot 1
uptimecheck_open_incidents
Storingen die nu openstaan in de 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
Een scrape-job en een deel van wat die terugkrijgt, in het tekstformaat van Prometheus. Elke monitor in de workspace heeft een eigen reeks.

Vragen

Welke metrics zijn er?

uptimecheck_monitor_up (1 of 0), uptimecheck_monitor_paused, uptimecheck_monitor_response_ms, uptimecheck_monitor_last_check_timestamp_seconds, uptimecheck_monitor_uptime_ratio over de afgelopen 24 uur en uptimecheck_open_incidents voor de workspace. Monitor-metrics hebben de labels monitor_id, name, type en project.

Hoe vaak moet Prometheus scrapen?

Elke 60 seconden of minder vaak. Zo blijf je binnen de rate limit van de API van 120 verzoeken per minuut per sleutel, die alle toepassingen van de sleutel delen.

Waarom ontbreekt een monitor in uptimecheck_monitor_up?

Gepauzeerde monitors en monitors die nog niet gecheckt zijn, ontbreken in uptimecheck_monitor_up en bij de reactietijd. Een gepauzeerde monitor toont 1 in uptimecheck_monitor_paused.

Bij welke abonnementen zit het?

Professional en Business, net als de REST API. Elke API-sleutel werkt, ook een met alleen leesrechten.

Kan ik ze in Grafana tonen?

Ja, via Prometheus: voeg je Prometheus als databron toe in Grafana en toon de uptimecheck_-metrics zoals alle andere.

Hoor het van ons, niet van je klanten.

Klik zonder account rond in de live demo, of start je proefperiode en voeg je eerste monitor toe.

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