- Home
- Integraties
- Prometheus
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
-
Maak een API-sleutel aan onder Instellingen › API. Alleen lezen is genoeg.
-
Voeg een scrape-job toe aan
prometheus.yml: targetapp.uptimecheck.com, schemehttps, metrics-pad/api/v1/metricsen de sleutel als bearer-token. -
Zet
scrape_intervalop60sof 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
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.
Werkt goed met
Alle integraties-
REST API
Monitors, incidenten, onderhoud en statusupdates, met een OpenAPI-document. Lees meer : REST API -
Webhooks
Elke melding als ondertekende JSON naar je eigen endpoint, met nieuwe pogingen. Zo werkt het : Webhooks -
MCP-server
Laat Claude, Cursor of VS Code de status checken en monitors beheren met een API-sleutel. Zo werkt het : MCP-server
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