- Strona główna
- Integracje
- Prometheus
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
-
Utwórz klucz API w Ustawienia › API. Wystarczy Tylko odczyt.
-
Dodaj zadanie scrape w
prometheus.yml: celapp.uptimecheck.com, schemathttps, ścieżka metryk/api/v1/metricsi klucz jako token bearer. -
Ustaw
scrape_intervalna60slub 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
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.
Dobrze współpracuje z
Wszystkie integracje-
REST API
Monitory, incydenty, prace serwisowe i aktualizacje statusu, z dokumentem OpenAPI. Czytaj więcej : REST API -
Webhooki
Każdy alert jako podpisany JSON do Twojego własnego endpointu, z ponowieniami. Jak to działa : Webhooki -
Serwer MCP
Pozwól Claude, Cursorowi lub VS Code sprawdzać status i zarządzać monitorami za pomocą klucza API. Jak to działa : Serwer MCP
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