Professional- ja Business-paketeissa Prometheus voi hakea työtilasi kaikkien valvontakohteiden tiedot yhdestä päätepisteestä, https://app.uptimecheck.com/api/v1/metrics, API-avaimella. Saat jokaisen valvonnan tilan, vasteajan ja vuorokauden käytettävyyden mittareina, valmiina omille hälytyssäännöillesi ja Grafanan kaavioille Prometheuksen kautta.
Luo API-avain
- Avaa sivupalkista Asetukset ja valitse välilehti API.
- Valitse Uusi API-avain, nimeä se käyttöpaikan mukaan, esimerkiksi ”Prometheus”, ja valitse Vain luku. Mittareiden lukemiseen ei tarvita enempää.
- Valitse Luo avain ja kopioi se. Avain näytetään vain tämän kerran.
Lisää scrape-työ
Lisää työ tiedostoon prometheus.yml, laita avaimesi kohdan uc_your_api_key tilalle ja lataa Prometheus uudelleen:
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"]
Pidä scrape_interval 60 sekunnissa tai pidempänä: API sallii 120 pyyntöä minuutissa avainta kohden, ja raja on yhteinen kaikelle, mikä käyttää avainta. Jos et halua avainta tiedostoon, käytä credentials_file-asetusta ja sen tiedoston polkua, jossa avain on, asetuksen credentials sijaan. Uuden kohteen pitäisi näkyä ylhäällä Prometheuksen kohdesivulla minuutin sisällä.
Mitä saat
uptimecheck_monitor_up: 1, kun viimeisin tarkistus onnistui, 0, kun se epäonnistui. Keskeytetyt ja vielä tarkistamattomat valvontakohteet puuttuvat.uptimecheck_monitor_paused: 1, kun valvonta on keskeytetty.uptimecheck_monitor_response_ms: viimeisimmän tarkistuksen vasteaika millisekunteina.uptimecheck_monitor_last_check_timestamp_seconds: valvonnan viimeisimmän tarkistuksen aika Unix-aikana.uptimecheck_monitor_uptime_ratio: osuus viimeisestä 24 tunnista, jona valvonta oli käytettävissä, 0–1.uptimecheck_open_incidents: työtilassa juuri nyt avoinna olevat häiriöt.
Jokaisessa valvonnan mittarissa on tunnisteet monitor_id, name, type ja project, joten voit suodattaa asiakkaan projektin tai valvontatyypin mukaan.
Hälytä niiden perusteella
Prometheus-sääntö, joka laukeaa, kun valvonta on ollut alhaalla kaksi minuuttia:
groups:
- name: uptimecheck
rules:
- alert: UptimecheckMonitorDown
expr: uptimecheck_monitor_up == 0
for: 2m
labels:
severity: critical
annotations:
summary: "{{ $labels.name }} is down"
Uptimecheck lähettää edelleen omat hälytyksensä hälytyskanaviisi, joten tällaiset säännöt ovat lisä eivätkä korvaa niitä. Lue lisää Prometheus-integraatiosta, API-avaimista ja REST API:sta.