Jak pobierać metryki Uptimecheck w Prometheusie

Zaktualizowano 15 listopada 2026 2 min czytania

W planach Professional i Business Prometheus może pobierać dane o każdym monitorze w Twoim obszarze roboczym z jednego endpointu, https://app.uptimecheck.com/api/v1/metrics, z kluczem API. Otrzymujesz stan, czas odpowiedzi i dostępność z 24 godzin każdego monitora jako metryki, gotowe do własnych reguł alertów i wykresów w Grafanie przez Prometheusa.

Utwórz klucz API

  1. Otwórz Ustawienia na pasku bocznym i wybierz kartę API.
  2. Wybierz Nowy klucz API, nazwij go według miejsca użycia, np. „Prometheus”, i wybierz Tylko odczyt. Do metryk nic więcej nie trzeba.
  3. Wybierz Utwórz klucz i skopiuj go. Klucz jest pokazywany tylko ten jeden raz.

Dodaj zadanie scrape

Dodaj zadanie w prometheus.yml, wstaw swój klucz w miejsce uc_your_api_key i przeładuj Prometheusa:

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"]

Ustaw scrape_interval na 60 sekund lub więcej: API pozwala na 120 żądań na minutę na klucz, wspólnie ze wszystkim innym, co używa tego klucza. Aby nie trzymać klucza w pliku, użyj credentials_file ze ścieżką do pliku, który go zawiera, zamiast credentials. Nowy cel powinien w ciągu minuty pojawić się jako aktywny na stronie celów Prometheusa.

Co otrzymujesz

  • uptimecheck_monitor_up: 1, gdy ostatnie sprawdzenie się powiodło, 0, gdy się nie powiodło. Wstrzymane monitory i monitory jeszcze niesprawdzone są pomijane.
  • 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 monitor był dostępny, od 0 do 1.
  • uptimecheck_open_incidents: incydenty otwarte w tej chwili w obszarze roboczym.

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

Alerty na tej podstawie

Reguła Prometheusa, która uruchamia się, gdy monitor nie działa od dwóch minut:

groups:
  - name: uptimecheck
    rules:
      - alert: UptimecheckMonitorDown
        expr: uptimecheck_monitor_up == 0
        for: 2m
        labels:
          severity: critical
        annotations:
          summary: "{{ $labels.name }} is down"

Uptimecheck nadal wysyła własne alerty do Twoich kanałów alertów, więc takie reguły są uzupełnieniem, a nie zamiennikiem. Więcej o integracji z Prometheusem, kluczach API i REST API.

Czy ten artykuł był pomocny?

Wypróbuj we własnym workspace

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

Nadal masz problem?

Napisz na support@uptimecheck.com, a odpowiemy w ciągu 24 godzin.

Automatyzujesz? Dokumentacja referencyjna API opisuje REST API, webhooki, pingi zadań cron i MCP.