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
- Apri Impostazioni nella barra laterale e scegli la scheda API.
- 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.
- 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.