Integration · Udviklere

Dine monitorer i Prometheus

Scrape ét endpoint med en API-nøgle, og få hver monitors status, svartid og oppetid for det seneste døgn som Prometheus-metrics, ved siden af resten af din infrastruktur.

14 dages gratis prøveperiode · Derefter gratis med 20 monitorer · Intet kreditkort

Det får du

  • Hver monitor, ét scrape

    Oppe eller nede, på pause, den seneste svartid, hvornår den sidst blev tjekket, og hvor stor en del af de seneste 24 timer den var oppe, for hver monitor i arbejdsområdet.

  • Labels at filtrere på

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

  • Regler i din egen stack

    Skriv alarmregler på uptimecheck_monitor_up eller uptimecheck_open_incidents ved siden af dem, du allerede har. Uptimechecks egne alarmer virker som før.

  • Grafer i Grafana

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

Sådan forbinder du Prometheus

  1. Opret en API-nøgle under Indstillinger › API. Kun læse er nok.

  2. Tilføj et scrape-job i prometheus.yml: mål app.uptimecheck.com, skema https, metrics-sti /api/v1/metrics og nøglen som bearer-token.

  3. Sæt scrape_interval til 60s eller mere, genindlæs Prometheus, og tjek, at det nye mål er oppe.

Endpointet er beskrevet i API-referencen.

På Professional og Business med en API-nøgle fra Indstillinger › API. En nøgle med kun læseadgang er nok.

Hvad den måler

uptimecheck_monitor_up
1, når det seneste tjek lykkedes, 0, når det fejlede
uptimecheck_monitor_paused
1, mens monitoren er sat på pause
uptimecheck_monitor_response_ms
Svartid for det seneste tjek i millisekunder
uptimecheck_monitor_last_check_timestamp_seconds
Hvornår monitoren sidst blev tjekket, som Unix-tid
uptimecheck_monitor_uptime_ratio
Andel af de seneste 24 timer, hvor den var oppe, fra 0 til 1
uptimecheck_open_incidents
Hændelser, der er åbne lige nu i arbejdsområ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
Et scrape-job og en del af det, det får tilbage, i Prometheus’ tekstformat. Hver monitor i arbejdsområdet har sin egen serie.

Spørgsmål

Hvilke metrics er der?

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 seneste 24 timer og uptimecheck_open_incidents for arbejdsområdet. Monitorernes metrics har labels monitor_id, name, type og project.

Hvor ofte skal Prometheus scrape?

Hvert 60. sekund eller sjældnere. Så holder du dig inden for API’ets grænse på 120 forespørgsler i minuttet pr. nøgle, som deles med alt andet, der bruger nøglen.

Hvorfor mangler en monitor i uptimecheck_monitor_up?

Monitorer på pause og monitorer, der endnu ikke er tjekket, 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, ligesom REST API’et. Alle API-nøgler virker, også en med kun læseadgang.

Kan jeg vise dem i Grafana?

Ja, via Prometheus: tilføj din Prometheus som datakilde i Grafana, og vis uptimecheck_-metrics som alle andre.

Hør det fra os, ikke fra dine kunder.

Klik rundt i livedemoen uden en konto, eller start din prøveperiode, og tilføj din første monitor.

14 dages gratis prøveperiode · Derefter gratis med 20 monitorer · Intet kreditkort