Власний моніторинг: Uptime Kuma

Панель вашої машини показує графіки CPU, трафіку та пам'яті, але вона гадки не має, чи відповідає ваш сайт і чи жива база даних. Для цього потрібен власний сторож. Uptime Kuma — найпростіший варіант: один контейнер, вебінтерфейс, десятки способів сповіщення.

Встановлення

services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: uptime-kuma
    restart: unless-stopped
    volumes:
      - ./data:/app/data
    ports:
      - "127.0.0.1:3001:3001"

docker compose up -d

Порт навмисно прив'язаний до локального інтерфейсу: панель моніторингу не повинна бути відкрита назовні. Відкривайте її або через вебсервер із сертифікатом і паролем, або через SSH-тунель:

ssh -L 3001:127.0.0.1:3001 root@<machine-address>

Потім перейдіть у браузері на http://localhost:3001; перший користувач стає адміністратором.

Що моніторити

Почніть із малого, інакше потонете в шумі:

• HTTP-перевірка головної сторінки кожного сайту — код відповіді та час.
• HTTP-перевірка ключового API з перевіркою ключового слова у відповіді. Сторінка може повертати 200 і все одно показувати помилку.
• TCP-порт бази даних або ігрового сервера.
• Термін дії сертифіката — Kuma попередить за N днів до його завершення.
• Push-перевірка для запланованих завдань: після успішного запуску скрипт звертається до унікальної адреси, і якщо цього не станеться, ви отримаєте сповіщення. Добре поєднується із запланованими завданнями.

Інтервалу в 60 секунд вистачає майже завжди. Повтори — 2-3, інакше один загублений мережевий пакет спричинить хибну тривогу.

Не розміщуйте моніторинг сайту на тій самій машині, де живе цей сайт. Якщо машина впаде, сторож упаде разом із нею, і ви ніколи про це не дізнаєтеся. Для зовнішніх сайтів тримайте Kuma на окремій машині, а на цій — лише перевірки внутрішніх сервісів.

Сповіщення

Налаштуйте Telegram-бота або Discord-вебхук і додайте його в розділі сповіщень. Не використовуйте канал електронної пошти: вихідні з'єднання машини на порти 25, 465 і 587 закриті, доки їх не відкриють на запит, і листи від Kuma просто не надішлються — дивіть Поштовий сервер.

Корисні звички:

• Окремі канали для «недоступно» та «сертифікат спливає». Перший потребує реакції негайно, другий — протягом тижня.
• Увімкнені сповіщення про відновлення. Без них ви не зрозумієте, чи закінчився збій.
• Тестове повідомлення, надіслане під час налаштування. Половина всіх проблем — це неправильний токен, і ви дізнаєтеся про це лише під час реального збою.

Ресурси та обслуговування

Контейнер уміщується в 150-250 МБ пам'яті та комфортно працює на VDS-1. База даних зростає разом з історією перевірок: встановіть зберігання на 90-180 днів у налаштуваннях, інакше за рік файл виросте до гігабайтів — дивіть місце на диску.

Каталог ./data зберігає весь стан сервісу. Включіть його у свій бекап: відновлювати три десятки перевірок вручну — задоволення не з приємних.

Поширені помилки

• Перевірка за IP-адресою замість домену. Сертифікат і віртуальний хост не перевіряються, а збій DNS залишається непоміченим.
• Занадто чутливі пороги. Тривога на кожне перевищення в 2 секунди означає, що люди перестають читати сповіщення.
• Панель відкрита назовні без пароля. Вона показує всю вашу інфраструктуру: адреси, порти, назви сервісів.