Integraatio · Kehittäjille

Valvontasi suoraan Prometheukseen

Hae yhdestä päätepisteestä API-avaimella jokaisen valvonnan tila, vasteaika ja vuorokauden käytettävyys Prometheus-mittareina muun infrastruktuurisi rinnalle.

14 päivän ilmainen kokeilu · Sen jälkeen ilmainen 20 valvontakohteelle · Ei luottokorttia

Mitä saat

  • Jokainen valvonta, yksi scrape

    Ylhäällä vai alhaalla, keskeytetty, viimeisin vasteaika, viimeisimmän tarkistuksen aika ja osuus viimeisestä 24 tunnista, jona se oli käytettävissä, jokaiselle työtilan valvonnalle.

  • Tunnisteet suodattamiseen

    Jokaisessa sarjassa on monitor_id, name, type ja project, joten voit ryhmitellä PromQL:ssä asiakasprojektin tai valvontatyypin mukaan.

  • Omat säännöt omassa ympäristössä

    Kirjoita hälytyssääntöjä mittareille uptimecheck_monitor_up tai uptimecheck_open_incidents muiden sääntöjesi rinnalle. Uptimecheckin omat hälytykset toimivat kuten ennenkin.

  • Kaaviot Grafanassa

    Kun Prometheus on datalähteenä, näet vasteajat ja käytettävyyden Grafanassa omien mittariesi rinnalla.

Näin yhdistät palvelun Prometheus

  1. Luo API-avain kohdassa Asetukset › API. Vain luku riittää.

  2. Lisää scrape-työ tiedostoon prometheus.yml: kohde app.uptimecheck.com, skeema https, metriikkapolku /api/v1/metrics ja avain bearer-tunnisteena.

  3. Aseta scrape_interval arvoon 60s tai suuremmaksi, lataa Prometheus uudelleen ja tarkista, että uusi kohde on ylhäällä.

Päätepiste on kuvattu API-dokumentaatiossa.

Professional- ja Business-paketeissa, API-avaimella kohdasta Asetukset › API. Vain luku -avain riittää.

Mitä se mittaa

uptimecheck_monitor_up
1, kun viimeisin tarkistus onnistui, 0, kun se epäonnistui
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 se oli käytettävissä, 0–1
uptimecheck_open_incidents
Työtilassa juuri nyt avoinna olevat häiriöt

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
Scrape-työ ja osa siitä, mitä se saa takaisin, Prometheuksen tekstimuodossa. Jokaisella työtilan valvonnalla on oma sarjansa.

Kysymykset

Mitä mittareita on?

uptimecheck_monitor_up (1 tai 0), uptimecheck_monitor_paused, uptimecheck_monitor_response_ms, uptimecheck_monitor_last_check_timestamp_seconds, uptimecheck_monitor_uptime_ratio viimeiseltä 24 tunnilta ja uptimecheck_open_incidents koko työtilalle. Valvontojen mittareissa on tunnisteet monitor_id, name, type ja project.

Kuinka usein Prometheuksen pitäisi tehdä scrape?

60 sekunnin välein tai harvemmin. Silloin pysyt API:n rajan sisällä: 120 pyyntöä minuutissa avainta kohden, ja raja on yhteinen kaikelle, mikä käyttää avainta.

Miksi valvonta puuttuu mittarista uptimecheck_monitor_up?

Keskeytetyt valvontakohteet ja valvontakohteet, joita ei ole vielä tarkistettu, puuttuvat mittareista uptimecheck_monitor_up ja vasteaika. Keskeytetyn valvonnan arvo on 1 mittarissa uptimecheck_monitor_paused.

Mihin paketteihin se sisältyy?

Professional ja Business, kuten REST API. Mikä tahansa API-avain käy, myös vain luku -avain.

Voinko näyttää ne Grafanassa?

Kyllä, Prometheuksen kautta: lisää Prometheus Grafanaan datalähteeksi ja näytä uptimecheck_-mittarit kuten muutkin.

Kuule se meiltä, älä asiakkailtasi.

Tutustu live-demoon ilman tiliä tai aloita kokeilu ja lisää ensimmäinen valvontakohteesi.

14 päivän ilmainen kokeilu · Sen jälkeen ilmainen 20 valvontakohteelle · Ei luottokorttia