Uptime Kuma: мониторинг и статус-страница за 30 минут

Uptime Kuma — open-source инструмент для мониторинга доступности сервисов с приятным веб-интерфейсом. Если честно, это одна из лучших self-hosted замен платным UptimeRobot, Pingdom и StatusPage.io — при этом абсолютно бесплатная.

Возможности:

• Мониторинг HTTP(S), TCP, DNS, PING, Docker, SQL, MQTT, gRPC
• Уведомления в Telegram, Slack, Discord, Email, Webhook — более 90 интеграций из коробки
• Публичная статус-страница для клиентов — больше никаких звонков «а у вас сайт работает?»
• Мониторинг SSL-сертификатов с заблаговременным уведомлением об истечении
• Поддержка нескольких пользователей и 2FA
• Встроенные графики времени отклика и аптайма — сразу видно, где просадки
• Минимальные требования смешные: 256 МБ RAM и 1 vCPU

Uptime Kuma написан на Node.js и хранит данные в SQLite — никаких внешних зависимостей, никакой отдельной БД. Один контейнер Docker, пять минут — и система уже работает.

Мы всегда ставим через Docker Compose с монтированием тома — так данные переживут пересоздание контейнера:

# Создание директории
mkdir -p /opt/uptime-kuma && cd /opt/uptime-kuma

# docker-compose.yml
version: '3.8'
services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: uptime-kuma
    restart: always
    ports:
      - "3001:3001"
    volumes:
      - ./data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock:ro  # для Docker мониторинга
    environment:
      - TZ=Europe/Moscow

# Запуск
docker compose up -d

# Проверка
docker logs uptime-kuma

Откройте http://your-server:3001 в браузере. При первом входе система попросит создать учётную запись администратора. Сразу же включите 2FA в настройках безопасности — не откладывайте на потом.

После установки добавьте мониторы для своих сервисов. Вот основные типы, которые мы используем чаще всего:

HTTP(S) монитор — проверка веб-сайта:

• URL: https://example.com
• Метод: GET
• Ожидаемый код ответа: 200
• Интервал: 60 секунд
• Количество попыток: 3 — уведомление придёт только после трёх неудачных проверок подряд, случайные сбои не беспокоят
• Ключевое слово: «Добро пожаловать» — проверяет не только доступность, но и содержимое страницы

TCP монитор — проверка порта:

• Хост: 10.0.1.10
• Порт: 1433 (SQL Server)
• Интервал: 30 секунд

DNS монитор — проверка DNS-записей:

• Хост: example.com
• Тип записи: A
• DNS-сервер: 8.8.8.8
• Ожидаемый ответ: 1.2.3.4 — если IP вдруг изменится, сразу получите уведомление

Docker монитор — проверка контейнера:

• Контейнер: postgres-db
• Проверяет статус контейнера напрямую через Docker socket

Каждому монитору назначайте теги для группировки на статус-странице: «Веб-сайты», «Базы данных», «Инфраструктура». Потом скажете себе спасибо, когда мониторов станет за 30.

Telegram — самый быстрый канал уведомлений для российских IT-команд, на практике проверено. Настраивается за 10 минут:

Шаг 1: Создайте бота через @BotFather в Telegram, получите токен.

Шаг 2: Получите Chat ID. Отправьте любое сообщение боту, затем откройте: https://api.telegram.org/bot<TOKEN>/getUpdates — найдите chat.id в ответе JSON.

Шаг 3: В Uptime Kuma идём в Settings → Notifications → Setup Notification:

• Тип: Telegram
• Bot Token: ваш токен
• Chat ID: ID чата или группы — для группы это отрицательное число, не перепутайте
• Включите «Apply on all existing monitors» — иначе придётся назначать уведомление каждому монитору вручную

# Проверка бота через curl
curl -s "https://api.telegram.org/bot123456:ABC-DEF/sendMessage" \
  -d "chat_id=-1001234567890" \
  -d "text=Тест уведомления Uptime Kuma" \
  -d "parse_mode=HTML"

Uptime Kuma шлёт уведомления при каждой смене статуса: DOWN — сервис упал, UP — поднялся. В сообщении есть имя монитора, время отклика и длительность простоя. Всё что нужно дежурному в три ночи.

Статус-страница — это публичная витрина состояния ваших сервисов для клиентов. Вместо того чтобы отвечать на звонки «а у вас сайт работает?», просто даёте ссылку. Работает 24/7, без вашего участия.

Создание: Settings → Status Pages → New Status Page.

Настройки:

• Title: Статус сервисов ITfresh
• Slug: /status (страница будет доступна по адресу https://status.example.com/status)
• Theme: Auto — подстраивается под тему браузера или системы пользователя
• Show powered by: Off — убираем ссылку на Uptime Kuma, клиентам это незачем знать
• Custom CSS: для брендирования под корпоративный стиль — логотип, цвета, шрифты

Добавьте группы мониторов на страницу — клиент сразу видит структуру:

• Группа «Веб-сервисы»: корпоративный сайт, клиентский портал, API
• Группа «Почта»: SMTP, IMAP, Webmail
• Группа «Инфраструктура»: VPN, DNS — но не выносите внутренние сервисы на публичную страницу, клиентам это не нужно

Статус-страница открывается без логина и пароля. Посетитель видит аптайм за последние 90 дней, текущий статус каждого сервиса и историю инцидентов. Плюс можно заранее публиковать объявления о плановых работах (Maintenance) с точным временем начала и окончания — клиенты будут знать, что происходит, и не будут звонить в панике.

Просроченный SSL — это, пожалуй, самая обидная причина простоя. Всё работает, сертификат просто забыли продлить. Uptime Kuma сама проверяет срок действия для каждого HTTPS-монитора, и мы в своей практике давно перестали следить за этим вручную.

Настройка: в параметрах HTTPS-монитора раздел «Certificate Expiry Notification»:

• Уведомить за 30 дней — есть время спокойно всё продлить
• Уведомить за 14 дней — второй звонок, если первый проигнорировали
• Уведомить за 7 дней — уже серьёзно, откладывать некуда

А вот с самоподписанными сертификатами на внутренних сервисах, до которых снаружи не достучаться по HTTP, придётся чуть повозиться отдельно:

# Добавьте TCP-монитор с проверкой сертификата
# Или используйте скрипт для отправки в Uptime Kuma через Push Monitor

#!/bin/bash
# check_cert.sh — проверка сертификата и Push в Uptime Kuma
HOST="internal-service.local"
PORT=443
PUSH_URL="https://status.example.com/api/push/abc123"

EXPIRY=$(echo | openssl s_client -servername $HOST -connect $HOST:$PORT 2>/dev/null | \
  openssl x509 -noout -enddate | cut -d= -f2)

EXPIRY_EPOCH=$(date -d "$EXPIRY" +%s)
NOW_EPOCH=$(date +%s)
DAYS_LEFT=$(( (EXPIRY_EPOCH - NOW_EPOCH) / 86400 ))

if [ $DAYS_LEFT -gt 7 ]; then
  curl -s "${PUSH_URL}?status=up&msg=SSL+OK:+${DAYS_LEFT}+days+left"
else
  curl -s "${PUSH_URL}?status=down&msg=SSL+EXPIRING:+${DAYS_LEFT}+days+left"
fi

Скрипт запускайте через cron каждые 6 часов — этого вполне достаточно.

Все данные Uptime Kuma живут в одном SQLite-файле. Бэкап элементарный:

# Бэкап данных
tar czf /backup/uptime-kuma-$(date +%Y%m%d).tar.gz /opt/uptime-kuma/data/

# Автоматический бэкап через cron
0 3 * * * tar czf /backup/uptime-kuma-$(date +\%Y\%m\%d).tar.gz /opt/uptime-kuma/data/ && find /backup/ -name 'uptime-kuma-*' -mtime +30 -delete

# Обновление до последней версии
cd /opt/uptime-kuma
docker compose pull
docker compose up -d

# Проверка версии
docker logs uptime-kuma 2>&1 | head -5

Ещё есть встроенный экспорт прямо из веб-интерфейса: Settings → Backup → Export. Получаете JSON со всеми мониторами, уведомлениями и статус-страницами. Мы пользуемся этим каждый раз, когда переезжаем на другой сервер — занимает минуты.