Моніторинг доступності (HealthCheck)

🛡 Моніторинг доступності (Healthcheck)

Цей функціонал реалізований як модульне доповнення (package) для пристроїв на базі ESPHome. Ви можете використовувати його як у складі екосистеми SvitloBot, так і як незалежний інструмент для будь-якого іншого вашого проєкту.

Моніторинг дозволяє миттєво дізнатися, якщо пристрій зник із мережі (через вимкнення світла, проблеми з інтернетом або зависання) за допомогою сервісу Healthchecks.io.

📝 Як це працює (Принцип «Dead Man's Switch» | «Кнопки мерця»)

Пристрій: Раз на хвилину відправляє сигнал («пінг») на сервер.
Сервер: Очікує на цей сигнал. Якщо він не приходить вчасно, сервер розуміє, що зв'язок розірвано.
Ви: Отримуєте повідомлення у Telegram або на пошту.

Принцип моніторингу: Пристрій використовує метод «Dead Man's Switch» | «Кнопки мерця». Він не чекає на запит, а сам активно повідомляє сервер, що він «живий». Якщо сигнал припиняється — сервер б'є на сполох.
Автоматизація адреси: Вам не потрібно вводити повний URL. Прошивка сама формує коректний запит, додаючи ваш ключ до адреси сервера.

📦 Варіанти підключення пакетів

Завдяки модульній структурі, ви можете гнучко налаштувати конфігурацію у секції packages:

Варіант 1: Повний набір SvitloBot, HealthChecks і CustomURL

SvitloBot | HealthChecks | Custom URL

packages:
  remote_package:
    url: https://github.com/andrewjswan/svitlobot
    files:
      - packages/common.yaml (1)
      - packages/svitlobot.yaml (2)
      - packages/healthcheck.yaml (3)
      - packages/custom_url.yaml (4)
      - packages/sub_devices_svitlobot_all_in_one.yaml (5)
      - packages/esp32.yaml (6)
    refresh: 1s

Базові налаштування
Ядро Світлобота
Моніторинг доступності (HealthChecks)
Моніторинг доступності (Custom URL)
Окремі пристрої для SvitloBot і HealthChecks
Специфічні параметри платформи ESP32 для 8266 використовуйте esp8266.yaml

Варіант 1: Набір SvitloBot і HealthChecks

SvitloBot | HealthChecks

packages:
  remote_package:
    url: https://github.com/andrewjswan/svitlobot
    files:
      - packages/common.yaml (1)
      - packages/svitlobot.yaml (2)
      - packages/healthcheck.yaml (3)
      - packages/sub_devices_svitlobot_healthcheck.yaml (4)
      - packages/esp32.yaml (5)
    refresh: 1s

Базові налаштування
Ядро Світлобота
Моніторинг доступності (HealthChecks)
Окремі пристрої для SvitloBot і HealthChecks
Специфічні параметри платформи ESP32 для 8266 використовуйте esp8266.yaml

Варіант 2: Набір HealthChecks і CustomURL

HealthChecks | Custom URL

packages:
  remote_package:
    url: https://github.com/andrewjswan/svitlobot
    files:
      - packages/common.yaml (1)
      - packages/healthcheck.yaml (2)
      - packages/custom_url.yaml (3)
      - packages/sub_devices_svitlobot_healthcheck.yaml (4)
      - packages/esp32.yaml (5)
    refresh: 1s

Базові налаштування
Моніторинг доступності (HealthChecks)
Моніторинг доступності (Custom URL)
Окремі пристрої для HealthChecks і Custom URL
Специфічні параметри платформи ESP32 для 8266 використовуйте esp8266.yaml

Варіант 3: Тільки моніторинг

HealthChecks

packages:
  remote_package:
    url: https://github.com/andrewjswan/svitlobot
    files:
      - packages/common.yaml
      - packages/healthcheck.yaml
      - packages/esp32.yaml (1)
    refresh: 1s

Специфічні параметри платформи ESP32 для 8266 використовуйте esp8266.yaml

Пакет healthcheck.yaml дозволяє додати функцію «контролю життя» до будь-якого вашого пристрою на базі ESPHome. Якщо пристрій зависне, зникне інтернет або вимкнеться живлення — ви миттєво отримаєте сповіщення через сервіс Healthchecks.io.

⚙️ Швидке налаштування

Для активації моніторингу виконайте ці три прості кроки:

Отримайте ключ: Зареєструйтесь на Healthchecks.io та створіть новий «Check».
Скопіюйте ID: Скопіюйте унікальний набір символів (UUID) з кінця вашого посилання.
Активуйте пристрій:

Зайдіть у веб-інтерфейс вашого пристрою (через браузер за його IP-адресою).
Вставте скопійований ID у поле Healthcheck Key.

⏱ Налаштування часових лімітів (Важливо)

Щоб ви не отримували «хибні тривоги» під час короткочасних збоїв інтернету або перезавантаження роутера, налаштуйте часові межі на сайті Healthchecks.io:

Period (Інтервал): встановіть 2 minutes. Це частота, з якою пристрій надсилає сигнал.
Grace Period (Відстрочка): встановіть 3 minutes.

Info

Це «запасний час», який сервіс чекає після пропущеного сигналу, перш ніж надіслати вам сповіщення.

🔔 Повідомлення в Telegram

Сервіс підтримує багато каналів зв'язку, але Telegram є найзручнішим:

У вашому кабінеті Healthchecks.io перейдіть до розділу Integrations -> Telegram.
Натисніть Add Integration та дотримуйтесь підказок офіційного бота @healthchecks_io_bot.
Докладніша інструкція доступна за посиланням: Attaching Telegram.

Або WebHook:

У вашому кабінеті Healthchecks.io перейдіть до розділу Integrations -> WebHook.
Натисніть Add Integration.
Введіть необхідні URL-адреси та повідомлення для обох варіантів статусів.

Telegram Bot

URL:

POST | https://api.telegram.org/bot88888888888:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA/sendMessage

Request Body:

{
"chat_id": "-888888888",
"text": "🔴 <b>Світло зникло</b>",
"parse_mode": "HTML"
}

Request Headers:

Content-Type: application/json