Integration · Utvecklare

Dina monitorer i Prometheus

Scrapa en enda endpoint med en API-nyckel och få varje monitors status, svarstid och upptid för senaste dygnet som Prometheus-metrics, bredvid resten av din infrastruktur.

14 dagar gratis · Sedan gratis för 20 monitorer · Inget kreditkort

Det här får du

  • Varje monitor, en scrape

    Uppe eller nere, pausad, den senaste svarstiden, när den senast kontrollerades och hur stor del av de senaste 24 timmarna den var uppe, för varje monitor i arbetsytan.

  • Etiketter att filtrera på

    Varje serie har monitor_id, name, type och project, så du kan gruppera på kundprojekt eller monitortyp i PromQL.

  • Regler i din egen stack

    Skriv larmregler på uptimecheck_monitor_up eller uptimecheck_open_incidents bredvid dem du redan har. Uptimechecks egna larm fungerar som förut.

  • Grafer i Grafana

    Med Prometheus som datakälla visar du svarstider och upptid i Grafana bredvid dina egna metrics.

Så ansluter du Prometheus

  1. Skapa en API-nyckel under Inställningar › API. Bara läsa räcker.

  2. Lägg till ett scrape-jobb i prometheus.yml: mål app.uptimecheck.com, schema https, metrics-sökväg /api/v1/metrics och nyckeln som bearer-token.

  3. Sätt scrape_interval till 60s eller mer, ladda om Prometheus och kontrollera att det nya målet är uppe.

Endpointen beskrivs i API-referensen.

På Professional och Business, med en API-nyckel från Inställningar › API. En nyckel med bara läsbehörighet räcker.

Vad den mäter

uptimecheck_monitor_up
1 när den senaste kontrollen lyckades, 0 när den misslyckades
uptimecheck_monitor_paused
1 medan monitorn är pausad
uptimecheck_monitor_response_ms
Svarstid för den senaste kontrollen i millisekunder
uptimecheck_monitor_last_check_timestamp_seconds
När monitorn senast kontrollerades, som Unix-tid
uptimecheck_monitor_uptime_ratio
Andel av de senaste 24 timmarna som den var uppe, från 0 till 1
uptimecheck_open_incidents
Driftstörningar som är öppna just nu i arbetsytan

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
Ett scrape-jobb och en del av vad det får tillbaka, i Prometheus textformat. Varje monitor i arbetsytan har en egen serie.

Frågor

Vilka metrics finns?

uptimecheck_monitor_up (1 eller 0), uptimecheck_monitor_paused, uptimecheck_monitor_response_ms, uptimecheck_monitor_last_check_timestamp_seconds, uptimecheck_monitor_uptime_ratio för de senaste 24 timmarna och uptimecheck_open_incidents för arbetsytan. Monitorernas metrics har etiketterna monitor_id, name, type och project.

Hur ofta ska Prometheus scrapa?

Var 60:e sekund eller mer sällan. Då håller du dig inom API:ets gräns på 120 anrop per minut och nyckel, som delas med allt annat som använder nyckeln.

Varför saknas en monitor i uptimecheck_monitor_up?

Pausade monitorer och monitorer som inte har kontrollerats än saknas i uptimecheck_monitor_up och svarstiden. En pausad monitor visar 1 i uptimecheck_monitor_paused.

Vilka planer har det?

Professional och Business, precis som REST-API:t. Alla API-nycklar fungerar, även en med bara läsbehörighet.

Kan jag visa dem i Grafana?

Ja, via Prometheus: lägg till ditt Prometheus som datakälla i Grafana och visa uptimecheck_-metrics som alla andra.

Få veta det av oss, inte av dina kunder.

Klicka runt i livedemon utan konto, eller starta din provperiod och lägg till din första monitor.

14 dagar gratis · Sedan gratis för 20 monitorer · Inget kreditkort