Integrasjon · Utviklere

Monitorene dine i Prometheus

Scrape ett endepunkt med en API-nøkkel, og få hver monitors status, svartid og oppetid det siste døgnet som Prometheus-metrics, ved siden av resten av infrastrukturen din.

14 dagers gratis prøveperiode · Deretter gratis for 20 monitorer · Uten kredittkort

Hva du får

  • Hver monitor, én scrape

    Oppe eller nede, på pause, den siste svartiden, når den sist ble sjekket og hvor stor del av de siste 24 timene den var oppe, for hver monitor i arbeidsområdet.

  • Labels å filtrere på

    Hver serie har monitor_id, name, type og project, så du kan gruppere etter kundeprosjekt eller monitortype i PromQL.

  • Regler i din egen stack

    Skriv varslingsregler på uptimecheck_monitor_up eller uptimecheck_open_incidents ved siden av dem du allerede har. Uptimechecks egne varsler fungerer som før.

  • Grafer i Grafana

    Med Prometheus som datakilde viser du svartider og oppetid i Grafana ved siden av dine egne metrics.

Slik kobler du til Prometheus

  1. Opprett en API-nøkkel under Innstillinger › API. Bare lese holder.

  2. Legg til en scrape-jobb i prometheus.yml: mål app.uptimecheck.com, skjema https, metrics-sti /api/v1/metrics og nøkkelen som bearer-token.

  3. Sett scrape_interval til 60s eller mer, last inn Prometheus på nytt og sjekk at det nye målet er oppe.

Endepunktet er beskrevet i API-referansen.

På Professional og Business, med en API-nøkkel fra Innstillinger › API. En nøkkel med bare lesetilgang holder.

Hva den måler

uptimecheck_monitor_up
1 når den siste sjekken lyktes, 0 når den feilet
uptimecheck_monitor_paused
1 mens monitoren er satt på pause
uptimecheck_monitor_response_ms
Svartid for den siste sjekken i millisekunder
uptimecheck_monitor_last_check_timestamp_seconds
Når monitoren sist ble sjekket, som Unix-tid
uptimecheck_monitor_uptime_ratio
Andel av de siste 24 timene den var oppe, fra 0 til 1
uptimecheck_open_incidents
Hendelser som er åpne akkurat nå i arbeidsområdet

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
En scrape-jobb og en del av det den får tilbake, i tekstformatet til Prometheus. Hver monitor i arbeidsområdet har sin egen serie.

Spørsmål

Hvilke metrics finnes?

uptimecheck_monitor_up (1 eller 0), uptimecheck_monitor_paused, uptimecheck_monitor_response_ms, uptimecheck_monitor_last_check_timestamp_seconds, uptimecheck_monitor_uptime_ratio for de siste 24 timene og uptimecheck_open_incidents for arbeidsområdet. Monitorenes metrics har labels monitor_id, name, type og project.

Hvor ofte bør Prometheus scrape?

Hvert 60. sekund eller sjeldnere. Da holder du deg innenfor API-ets grense på 120 forespørsler i minuttet per nøkkel, som deles med alt annet som bruker nøkkelen.

Hvorfor mangler en monitor i uptimecheck_monitor_up?

Monitorer på pause og monitorer som ikke er sjekket ennå, mangler i uptimecheck_monitor_up og i svartiden. En monitor på pause viser 1 i uptimecheck_monitor_paused.

Hvilke planer inkluderer det?

Professional og Business, akkurat som REST API-et. Alle API-nøkler fungerer, også en med bare lesetilgang.

Kan jeg vise dem i Grafana?

Ja, via Prometheus: legg til din Prometheus som datakilde i Grafana og vis uptimecheck_-metrics som alle andre.

Hør det fra oss, ikke fra kundene.

Klikk deg rundt i livedemoen uten konto, eller start prøveperioden og legg til din første monitor.

14 dagers gratis prøveperiode · Deretter gratis for 20 monitorer · Uten kredittkort