På Professional og Business kan Prometheus scrape alle monitorer i dit arbejdsområde fra ét endpoint, https://app.uptimecheck.com/api/v1/metrics, med en API-nøgle. Du får hver monitors status, svartid og oppetid for det seneste døgn som metrics, klar til dine egne alarmregler og til grafer i Grafana via Prometheus.
Opret en API-nøgle
- Åbn Indstillinger i sidemenuen, og vælg fanen API.
- Vælg Ny API-nøgle, navngiv den efter, hvor den bruges, fx “Prometheus”, og vælg Kun læse. Mere kræver metrics ikke.
- Vælg Opret nøgle, og kopiér den. Det er den eneste gang, nøglen vises.
Tilføj et scrape-job
Tilføj et job i prometheus.yml, sæt din nøgle ind i stedet for uc_your_api_key, og genindlæs 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"]
Hold scrape_interval på 60 sekunder eller mere: API’et tillader 120 forespørgsler i minuttet pr. nøgle, delt med alt andet, der bruger nøglen. Vil du holde nøglen ude af filen, så brug credentials_file med stien til en fil, der indeholder den, i stedet for credentials. Det nye mål bør vises som oppe på Prometheus’ side med mål inden for et minut.
Det får du
uptimecheck_monitor_up: 1, når det seneste tjek lykkedes, 0, når det fejlede. Monitorer på pause og monitorer, der endnu ikke er tjekket, er ikke med.uptimecheck_monitor_paused: 1, mens monitoren er sat på pause.uptimecheck_monitor_response_ms: svartiden for det seneste tjek i millisekunder.uptimecheck_monitor_last_check_timestamp_seconds: hvornår monitoren sidst blev tjekket, som Unix-tid.uptimecheck_monitor_uptime_ratio: hvor stor en del af de seneste 24 timer monitoren var oppe, fra 0 til 1.uptimecheck_open_incidents: hændelser, der er åbne lige nu i arbejdsområdet.
Hver monitor-metric har labels monitor_id, name, type og project, så du kan filtrere efter en kundes projekt eller en monitortype.
Få alarm på det
En Prometheus-regel, der udløses, når en monitor har været nede i to minutter:
groups:
- name: uptimecheck
rules:
- alert: UptimecheckMonitorDown
expr: uptimecheck_monitor_up == 0
for: 2m
labels:
severity: critical
annotations:
summary: "{{ $labels.name }} is down"
Uptimecheck sender stadig sine egne alarmer til dine alarmkanaler, så regler som denne er et supplement, ikke en erstatning. Læs mere om Prometheus-integrationen, API-nøgler og REST API’et.