Uptime Kuma + Home Assistant — monitoring smart home

Dlaczego monitoring smart home potrzebuje Uptime Kuma

Jeśli prowadzisz homelab lub smart home z Home Assistant, prawdopodobnie masz dziesiątki usług self-hosted — Nextcloud, Plex, Pi-hole, Vaultwarden, Gitea, Jellyfin i wiele innych. Każda z nich może przestać działać — po aktualizacji, awarii dysku, przepełnieniu pamięci czy restarcie serwera.

Home Assistant świetnie zarządza urządzeniami IoT i automatyzacjami domowymi, ale nie jest narzędziem do monitoringu usług sieciowych. Uptime Kuma wypełnia tę lukę — monitoruje dostępność usług, baz danych, kontenerów Docker i portów, a Home Assistant integruje te dane w jeden spójny dashboard.

Razem tworzą potężny tandem: Uptime Kuma monitoruje, HA wizualizuje i automatyzuje reakcje.

Sposoby integracji — REST API, MQTT, custom component

Istnieją trzy główne metody integracji Uptime Kuma z Home Assistant:

Dodanie Uptime Kuma jako sensora REST w Home Assistant

Najprostsza metoda — REST sensor odpytuje API Uptime Kuma o status monitorów.

Konfiguracja w configuration.yaml

# configuration.yaml
rest:
  - resource: "https://uptime.twoja-domena.pl/api/status-page/heartbeat/main"
    scan_interval: 30
    sensor:
      - name: "Uptime Kuma — Strona WWW"
        value_template: >
          {% set monitor = value_json.heartbeatList['1'][-1] %}
          {{ 'Online' if monitor.status == 1 else 'Offline' }}
        json_attributes_path: "$.heartbeatList.1[-1:]"
        json_attributes:
          - ping
          - status
          - msg

      - name: "Uptime Kuma — API"
        value_template: >
          {% set monitor = value_json.heartbeatList['2'][-1] %}
          {{ 'Online' if monitor.status == 1 else 'Offline' }}

      - name: "Uptime Kuma — Baza MySQL"
        value_template: >
          {% set monitor = value_json.heartbeatList['3'][-1] %}
          {{ 'Online' if monitor.status == 1 else 'Offline' }}

Dashboard — karty Lovelace z danymi monitoringu

Po dodaniu sensorów REST możesz tworzyć karty Lovelace wizualizujące stan monitoringu:

Entity Card — status usług

type: entities
title: "Status usług"
entities:
  - entity: sensor.uptime_kuma_strona_www
    name: "Strona WWW"
    icon: mdi:web
  - entity: sensor.uptime_kuma_api
    name: "API"
    icon: mdi:api
  - entity: sensor.uptime_kuma_baza_mysql
    name: "Baza MySQL"
    icon: mdi:database

Conditional Card — alert gdy usługa down

type: conditional
conditions:
  - condition: state
    entity: sensor.uptime_kuma_strona_www
    state: "Offline"
card:
  type: markdown
  content: "⚠️ **ALERT:** Strona WWW jest niedostępna!"
  style: |
    ha-card { background: #ff5252; color: white; }

Automatyzacje — reakcje na alerty Uptime Kuma

Home Assistant może automatycznie reagować na zmiany statusu monitorów Uptime Kuma:

Powiadomienie push gdy usługa down

automation:
  - alias: "Alert — usługa down"
    trigger:
      - platform: state
        entity_id: sensor.uptime_kuma_strona_www
        to: "Offline"
        for:
          minutes: 2
    action:
      - service: notify.mobile_app_telefon
        data:
          title: "🔴 Strona WWW DOWN"
          message: "Strona firmowa jest niedostępna od 2 minut!"
          data:
            priority: high
            channel: monitoring

Restart usługi przez SSH

automation:
  - alias: "Auto-restart Nextcloud"
    trigger:
      - platform: state
        entity_id: sensor.uptime_kuma_nextcloud
        to: "Offline"
        for:
          minutes: 5
    condition:
      - condition: time
        after: "06:00:00"
        before: "23:00:00"
    action:
      - service: shell_command.restart_nextcloud
      - service: notify.telegram_admin
        data:
          message: "⚠️ Nextcloud down — automatyczny restart wykonany"

Co warto monitorować w homelabie

Push Monitor — heartbeat dla automatyzacji HA

Push Monitor w Uptime Kuma to idealny sposób na monitorowanie automatyzacji Home Assistant. Twoja automatyzacja HA wysyła heartbeat do Uptime Kuma po zakończeniu — brak sygnału oznacza, że automatyzacja się nie wykonała.

automation:
  - alias: "Heartbeat — backup nocny"
    trigger:
      - platform: time
        at: "03:00:00"
    action:
      - service: shell_command.run_backup
      - service: rest_command.uptime_kuma_heartbeat
        data:
          monitor_id: "backup-nocny"
          status: "up"
          msg: "Backup completed"

rest_command:
  uptime_kuma_heartbeat:
    url: "https://uptime.twoja-domena.pl/api/push/{{ monitor_id }}?status={{ status }}&msg={{ msg }}"
    method: GET

Powiadomienia — HA + Telegram/Discord

Uptime Kuma może wysyłać powiadomienia bezpośrednio do Home Assistant (natywny kanał „Home Assistant"), a HA może je przetwarzać i dystrybuować — np. na Telegram w dzień, ciche push nocą, lampka LED przy biurku gdy coś jest down.

Możesz też pominąć HA i skonfigurować powiadomienia bezpośrednio w Uptime Kuma — na Telegram, Discord, Email lub dowolny z 91 kanałów. Oba podejścia działają równolegle.

Podsumowanie

Integracja Uptime Kuma + Home Assistant to idealne połączenie dla homelabowców i entuzjastów smart home. Uptime Kuma monitoruje dostępność usług, a Home Assistant wizualizuje dane i automatyzuje reakcje na awarie.

Kluczowe elementy integracji:

• REST sensor — status monitorów UK jako entity w HA
• Dashboard Lovelace — karty z kolorami, wykresami i alertami
• Automatyzacje — push notification, restart usług, lampka alarmowa
• Push Monitor — heartbeat dla automatyzacji HA (backupy, cronjobowy)
• 91 kanałów powiadomień — Telegram, Discord, HA native i więcej

Najczęściej zadawane pytania