Så scrapar du Uptimechecks metrics med Prometheus

Uppdaterad 15 november 2026 2 min läsning

På Professional och Business kan Prometheus scrapa varje monitor i din arbetsyta från en enda endpoint, https://app.uptimecheck.com/api/v1/metrics, med en API-nyckel. Du får varje monitors status, svarstid och upptid för senaste dygnet som metrics, redo för dina egna larmregler och för grafer i Grafana via Prometheus.

Skapa en API-nyckel

  1. Öppna Inställningar i sidomenyn och välj fliken API.
  2. Välj Ny API-nyckel, döp den efter var den används, till exempel ”Prometheus”, och välj Bara läsa. Mer behövs inte för att läsa metrics.
  3. Välj Skapa nyckel och kopiera den. Det är enda gången nyckeln visas.

Lägg till ett scrape-jobb

Lägg till ett jobb i prometheus.yml, sätt in din nyckel i stället för uc_your_api_key och ladda om 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"]

Låt scrape_interval vara 60 sekunder eller mer: API:t tillåter 120 anrop per minut och nyckel, delat med allt annat som använder nyckeln. Vill du hålla nyckeln utanför filen använder du credentials_file med sökvägen till en fil som innehåller den, i stället för credentials. Det nya målet bör synas som uppe på Prometheus sida för mål inom en minut.

Det här får du

  • uptimecheck_monitor_up: 1 när den senaste kontrollen lyckades, 0 när den misslyckades. Pausade monitorer och monitorer som inte har kontrollerats än är inte med.
  • uptimecheck_monitor_paused: 1 medan monitorn är pausad.
  • uptimecheck_monitor_response_ms: svarstiden 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: hur stor del av de senaste 24 timmarna monitorn var uppe, från 0 till 1.
  • uptimecheck_open_incidents: driftstörningar som är öppna just nu i arbetsytan.

Varje monitor-metric har etiketterna monitor_id, name, type och project, så du kan filtrera på en kunds projekt eller en monitortyp.

Larma på det

En Prometheus-regel som löser ut när en monitor har varit nere i två minuter:

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

Uptimecheck skickar fortfarande sina egna larm till dina larmkanaler, så regler som den här är ett tillägg, inte en ersättning. Läs mer om Prometheus-integrationen, API-nycklar och REST-API:t.

Var den här artikeln till hjälp?

Prova i din egen arbetsyta

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

Kommer du inte vidare?

Mejla support@uptimecheck.com så svarar vi inom 24 timmar.

Vill du automatisera? API-referens täcker REST-API:t, webhooks, pingar för cron-jobb och MCP.