Integrazione · Sviluppatori

I tuoi monitor in Prometheus

Fai scrape di un solo endpoint con una chiave API e ottieni stato, tempo di risposta e uptime delle ultime 24 ore di ogni monitor come metriche Prometheus, accanto al resto della tua infrastruttura.

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

Cosa ottieni

  • Ogni monitor, un solo scrape

    Raggiungibile o no, in pausa, l’ultimo tempo di risposta, quando è stato controllato l’ultima volta e la quota delle ultime 24 ore in cui era raggiungibile, per ogni monitor del workspace.

  • Label per filtrare

    Ogni serie porta monitor_id, name, type e project, così puoi raggruppare per progetto cliente o tipo di monitor in PromQL.

  • Regole nel tuo stack

    Scrivi regole di alert su uptimecheck_monitor_up o uptimecheck_open_incidents accanto a quelle che hai già. Gli avvisi di Uptimecheck continuano a funzionare come prima.

  • Grafici in Grafana

    Con Prometheus come sorgente dati, visualizza tempi di risposta e uptime in Grafana accanto alle tue metriche.

Come collegare Prometheus

  1. Crea una chiave API in Impostazioni › API. Sola lettura basta.

  2. Aggiungi un job di scrape in prometheus.yml: target app.uptimecheck.com, schema https, percorso delle metriche /api/v1/metrics e la chiave come bearer token.

  3. Imposta scrape_interval a 60s o più, ricarica Prometheus e verifica che il nuovo target sia attivo.

L’endpoint è descritto nel riferimento dell’API.

Su Professional e Business, con una chiave API da Impostazioni › API. Basta una chiave in sola lettura.

Cosa misura

uptimecheck_monitor_up
1 se l’ultimo controllo è riuscito, 0 se è fallito
uptimecheck_monitor_paused
1 finché il monitor è in pausa
uptimecheck_monitor_response_ms
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
Quota delle ultime 24 ore in cui era raggiungibile, da 0 a 1
uptimecheck_open_incidents
Incidenti aperti in questo momento nel workspace

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
Un job di scrape e parte di ciò che riceve, nel formato testo di Prometheus. Ogni monitor del workspace ha la sua serie.

Domande

Quali metriche ci sono?

uptimecheck_monitor_up (1 o 0), uptimecheck_monitor_paused, uptimecheck_monitor_response_ms, uptimecheck_monitor_last_check_timestamp_seconds, uptimecheck_monitor_uptime_ratio sulle ultime 24 ore e uptimecheck_open_incidents per il workspace. Le metriche dei monitor hanno le label monitor_id, name, type e project.

Ogni quanto deve fare scrape Prometheus?

Ogni 60 secondi o meno spesso. Così resti nel limite dell’API di 120 richieste al minuto per chiave, condiviso da tutti gli usi della chiave.

Perché un monitor manca da uptimecheck_monitor_up?

I monitor in pausa e quelli non ancora controllati non compaiono in uptimecheck_monitor_up né nel tempo di risposta. Un monitor in pausa mostra 1 in uptimecheck_monitor_paused.

Quali piani lo includono?

Professional e Business, come l’API REST. Va bene qualsiasi chiave API, anche in sola lettura.

Posso visualizzarle in Grafana?

Sì, tramite Prometheus: aggiungi il tuo Prometheus come sorgente dati in Grafana e visualizza le metriche uptimecheck_ come tutte le altre.

Saperlo da noi, non dai tuoi clienti.

Esplora la demo live senza account, oppure inizia la prova e aggiungi il tuo primo monitor.

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