- Home
- Integrazioni
- Prometheus
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
-
Crea una chiave API in Impostazioni › API. Sola lettura basta.
-
Aggiungi un job di scrape in
prometheus.yml: targetapp.uptimecheck.com, schemahttps, percorso delle metriche/api/v1/metricse la chiave come bearer token. -
Imposta
scrape_intervala60so 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
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.
Funziona bene con
Tutte le integrazioni-
API REST
Monitor, incidenti, manutenzioni e aggiornamenti di stato, con un documento OpenAPI. Leggi di più : API REST -
Webhook
Ogni avviso come JSON firmato al tuo endpoint, con nuovi tentativi. Come funziona : Webhook -
Server MCP
Permetti a Claude, Cursor o VS Code di controllare lo stato e gestire i monitor con una chiave API. Come funziona : Server MCP
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