Integracja · Dla deweloperów

Twoje monitory w Prometheusie

Rób scrape jednego endpointu z kluczem API i otrzymuj stan, czas odpowiedzi i dostępność z 24 godzin każdego monitora jako metryki Prometheusa, obok reszty swojej infrastruktury.

14 dni za darmo · Potem 20 monitorów gratis · Bez karty kredytowej

Co otrzymujesz

  • Każdy monitor, jeden scrape

    Dostępny lub nie, wstrzymany, ostatni czas odpowiedzi, czas ostatniego sprawdzenia i część ostatnich 24 godzin, w której był dostępny, dla każdego monitora w obszarze roboczym.

  • Etykiety do filtrowania

    Każda seria ma etykiety monitor_id, name, type i project, więc w PromQL możesz grupować według projektu klienta lub typu monitora.

  • Reguły we własnym stacku

    Pisz reguły alertów na uptimecheck_monitor_up lub uptimecheck_open_incidents obok tych, które już masz. Alerty samego Uptimecheck działają dalej jak dotąd.

  • Wykresy w Grafanie

    Z Prometheusem jako źródłem danych pokażesz czasy odpowiedzi i dostępność w Grafanie obok własnych metryk.

Jak połączyć Prometheus

  1. Utwórz klucz API w Ustawienia › API. Wystarczy Tylko odczyt.

  2. Dodaj zadanie scrape w prometheus.yml: cel app.uptimecheck.com, schemat https, ścieżka metryk /api/v1/metrics i klucz jako token bearer.

  3. Ustaw scrape_interval na 60s lub więcej, przeładuj Prometheusa i sprawdź, czy nowy cel jest aktywny.

Endpoint jest opisany w dokumentacji API.

W planach Professional i Business, z kluczem API z Ustawienia › API. Wystarczy klucz tylko do odczytu.

Co mierzy

uptimecheck_monitor_up
1, gdy ostatnie sprawdzenie się powiodło, 0, gdy się nie powiodło
uptimecheck_monitor_paused
1, dopóki monitor jest wstrzymany
uptimecheck_monitor_response_ms
Czas odpowiedzi ostatniego sprawdzenia w milisekundach
uptimecheck_monitor_last_check_timestamp_seconds
Czas ostatniego sprawdzenia monitora jako czas uniksowy
uptimecheck_monitor_uptime_ratio
Część ostatnich 24 godzin, w której był dostępny, od 0 do 1
uptimecheck_open_incidents
Incydenty otwarte w tej chwili w obszarze roboczym

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
Zadanie scrape i część tego, co zwraca endpoint, w formacie tekstowym Prometheusa. Każdy monitor w obszarze roboczym ma własną serię.

Pytania

Jakie metryki są dostępne?

uptimecheck_monitor_up (1 lub 0), uptimecheck_monitor_paused, uptimecheck_monitor_response_ms, uptimecheck_monitor_last_check_timestamp_seconds, uptimecheck_monitor_uptime_ratio z ostatnich 24 godzin oraz uptimecheck_open_incidents dla obszaru roboczego. Metryki monitorów mają etykiety monitor_id, name, type i project.

Jak często Prometheus powinien robić scrape?

Co 60 sekund lub rzadziej. Mieścisz się wtedy w limicie API wynoszącym 120 żądań na minutę na klucz, wspólnym dla wszystkich zastosowań klucza.

Dlaczego monitora brakuje w uptimecheck_monitor_up?

Wstrzymane monitory i monitory, które nie zostały jeszcze sprawdzone, nie pojawiają się w uptimecheck_monitor_up ani w czasie odpowiedzi. Wstrzymany monitor ma 1 w uptimecheck_monitor_paused.

Które plany to obejmują?

Professional i Business, tak jak REST API. Działa każdy klucz API, także tylko do odczytu.

Czy mogę pokazać je w Grafanie?

Tak, przez Prometheusa: dodaj swój Prometheus jako źródło danych w Grafanie i pokazuj metryki uptimecheck_ jak każde inne.

Usłysz to od nas, nie od klientów.

Wypróbuj demo na żywo bez zakładania konta albo rozpocznij okres próbny i dodaj pierwszy monitor.

14 dni za darmo · Potem 20 monitorów gratis · Bez karty kredytowej