Sådan scraper du Uptimechecks metrics med Prometheus

Opdateret 15. november 2026 2 min. læsning

På Professional og Business kan Prometheus scrape alle monitorer i dit arbejdsområde fra ét endpoint, https://app.uptimecheck.com/api/v1/metrics, med en API-nøgle. Du får hver monitors status, svartid og oppetid for det seneste døgn som metrics, klar til dine egne alarmregler og til grafer i Grafana via Prometheus.

Opret en API-nøgle

  1. Åbn Indstillinger i sidemenuen, og vælg fanen API.
  2. Vælg Ny API-nøgle, navngiv den efter, hvor den bruges, fx “Prometheus”, og vælg Kun læse. Mere kræver metrics ikke.
  3. Vælg Opret nøgle, og kopiér den. Det er den eneste gang, nøglen vises.

Tilføj et scrape-job

Tilføj et job i prometheus.yml, sæt din nøgle ind i stedet for uc_your_api_key, og genindlæs Prometheus:

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"]

Hold scrape_interval på 60 sekunder eller mere: API’et tillader 120 forespørgsler i minuttet pr. nøgle, delt med alt andet, der bruger nøglen. Vil du holde nøglen ude af filen, så brug credentials_file med stien til en fil, der indeholder den, i stedet for credentials. Det nye mål bør vises som oppe på Prometheus’ side med mål inden for et minut.

Det får du

  • uptimecheck_monitor_up: 1, når det seneste tjek lykkedes, 0, når det fejlede. Monitorer på pause og monitorer, der endnu ikke er tjekket, er ikke med.
  • uptimecheck_monitor_paused: 1, mens monitoren er sat på pause.
  • uptimecheck_monitor_response_ms: svartiden 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: hvor stor en del af de seneste 24 timer monitoren var oppe, fra 0 til 1.
  • uptimecheck_open_incidents: hændelser, der er åbne lige nu i arbejdsområdet.

Hver monitor-metric har labels monitor_id, name, type og project, så du kan filtrere efter en kundes projekt eller en monitortype.

Få alarm på det

En Prometheus-regel, der udløses, når en monitor har været nede i to minutter:

groups:
  - name: uptimecheck
    rules:
      - alert: UptimecheckMonitorDown
        expr: uptimecheck_monitor_up == 0
        for: 2m
        labels:
          severity: critical
        annotations:
          summary: "{{ $labels.name }} is down"

Uptimecheck sender stadig sine egne alarmer til dine alarmkanaler, så regler som denne er et supplement, ikke en erstatning. Læs mere om Prometheus-integrationen, API-nøgler og REST API’et.

Var denne artikel nyttig?

Prøv det i dit eget workspace

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

Sidder du stadig fast?

Skriv til support@uptimecheck.com, så svarer vi inden for 24 timer.

Vil du automatisere? API-reference dækker REST API'et, webhooks, cron-job-pings og MCP.