Come fare scrape delle metriche di Uptimecheck con Prometheus

Aggiornato il 15 novembre 2026 2 min di lettura

Su Professional e Business, Prometheus può fare scrape di tutti i monitor del tuo workspace da un solo endpoint, https://app.uptimecheck.com/api/v1/metrics, con una chiave API. Ottieni stato, tempo di risposta e uptime delle ultime 24 ore di ogni monitor come metriche, pronte per le tue regole di alert e per i grafici in Grafana tramite Prometheus.

Crea una chiave API

  1. Apri Impostazioni nella barra laterale e scegli la scheda API.
  2. Scegli Nuova chiave API, dalle un nome in base a dove la usi, per esempio “Prometheus”, e scegli Sola lettura. Per le metriche non serve altro.
  3. Scegli Crea chiave e copiala. È l’unica volta in cui la chiave viene mostrata.

Aggiungi un job di scrape

Aggiungi un job in prometheus.yml, metti la tua chiave al posto di uc_your_api_key e ricarica 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"]

Tieni scrape_interval a 60 secondi o più: l’API consente 120 richieste al minuto per chiave, condivise con tutto ciò che usa la chiave. Per non lasciare la chiave nel file, usa credentials_file con il percorso di un file che la contiene al posto di credentials. Il nuovo target dovrebbe risultare attivo nella pagina dei target di Prometheus entro un minuto.

Cosa ottieni

  • uptimecheck_monitor_up: 1 se l’ultimo controllo è riuscito, 0 se è fallito. I monitor in pausa e quelli non ancora controllati non compaiono.
  • uptimecheck_monitor_paused: 1 finché il monitor è in pausa.
  • uptimecheck_monitor_response_ms: il tempo di risposta dell’ultimo controllo, in millisecondi.
  • uptimecheck_monitor_last_check_timestamp_seconds: quando il monitor è stato controllato l’ultima volta, come tempo Unix.
  • uptimecheck_monitor_uptime_ratio: la quota delle ultime 24 ore in cui il monitor era raggiungibile, da 0 a 1.
  • uptimecheck_open_incidents: gli incidenti aperti in questo momento nel workspace.

Ogni metrica dei monitor ha le label monitor_id, name, type e project, così puoi filtrare per progetto di un cliente o per tipo di monitor.

Ricevi alert

Una regola Prometheus che scatta quando un monitor è down da due minuti:

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

Uptimecheck continua a inviare i suoi avvisi ai tuoi canali di avviso, quindi regole come questa sono un’aggiunta, non un sostituto. Scopri di più sull’integrazione con Prometheus, sulle chiavi API e sull’API REST.

Questo articolo ti è stato utile?

Provalo nel tuo workspace

Prova gratuita di 14 giorni · Poi gratis con 20 monitor · Nessuna carta di credito

Ancora bloccato?

Scrivi a support@uptimecheck.com e ti risponderemo entro 24 ore.

Vuoi automatizzare? La Riferimento API copre API REST, webhook, ping dei cron job e MCP.