Uptimecheckin mittareiden haku Prometheukseen

Päivitetty 15. marraskuuta 2026 2 min lukuaika

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

  1. Avaa sivupalkista Asetukset ja valitse välilehti API.
  2. Valitse Uusi API-avain, nimeä se käyttöpaikan mukaan, esimerkiksi ”Prometheus”, ja valitse Vain luku. Mittareiden lukemiseen ei tarvita enempää.
  3. 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.

Oliko tästä artikkelista apua?

Kokeile omassa työtilassasi

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

Yhä jumissa?

Lähetä sähköpostia osoitteeseen support@uptimecheck.com, niin vastaamme 24 tunnin kuluessa.

Automatisoitko? API-referenssi kattaa REST API:n, webhookit, cron-ajojen pingit ja MCP:n.