Netdata: типичные ошибки и как их исправить

Коротко о главном

Netdata собирает метрики системы и приложений и показывает их с секундной детализацией. В отличие от связки Prometheus и Grafana, он готов к работе сразу после установки: дашборд, графики и базовые оповещения доступны без настройки.

Для домашнего сервера Netdata — быстрый способ увидеть, что происходит: нагрузка, диск, сеть, контейнеры. Он помогает находить узкие места без долгой настройки стека мониторинга.

Большинство проблем с Netdata сводится к нескольким повторяющимся ошибкам. Ниже — что проверить в первую очередь и как не усугубить ситуацию.

Почему это происходит

Ошибки почти всегда связаны с контекстом: другая версия пакета, не тот пользователь, устаревший конфиг или команда из руководства для другой системы. Netdata не исключение. Поэтому сначала фиксируем исходное состояние, затем меняем одну вещь за раз.

Типичные ошибки

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

1. Дашборд не открывается

Проверьте, что служба запущена и слушает нужный адрес. Если порт ограничен localhost, используйте SSH-туннель.

2. Быстро растёт диск

Уменьшите срок хранения и размер базы, проверьте, не включена ли избыточная детализация.

3. Оповещения не приходят

Проверьте конфигурацию health и настройки уведомлений, затем перезагрузите правила и отправьте тест.

Как настроить правильно

Правильная последовательность проста: проверить версию и зависимости, сделать резервную копию конфигурации, внести минимальное изменение, проверить логи и только потом двигаться дальше.

Установка

В Debian, Ubuntu и Linux Mint используется пакетный менеджер APT:

sudo apt install netdata

В Fedora и RHEL-совместимых системах пакет ставится через DNF:

sudo dnf install netdata

В Arch Linux и производных пакет доступен в официальных репозиториях:

sudo pacman -S netdata

1. Установите и запустите

После установки служба стартует и слушает порт 19999. Сразу ограничьте адрес прослушивания локальным интерфейсом.

sudo systemctl enable --now netdata
ss -ltnp | grep 19999

2. Откройте дашборд

Локально дашборд доступен по адресу 127.0.0.1:19999. Для удалённого доступа используйте SSH-туннель, а не публикацию порта.

ssh -L 19999:127.0.0.1:19999 user@server
# затем откройте http://localhost:19999

3. Настройте хранение

По умолчанию история короткая. Для более длительного хранения увеличьте объём базы и следите за диском.

sudo nano /etc/netdata/netdata.conf
df -h /var/lib/netdata
sudo systemctl restart netdata

4. Добавьте проверки

Netdata умеет проверять HTTP-эндпоинты, порты и сертификаты. Настройте хотя бы доступность сайта и срок действия TLS.

ls /etc/netdata/go.d/
sudo systemctl restart netdata

Рабочий конфиг

Начните с минимального рабочего варианта. Не копируйте большой конфиг целиком: добавляйте параметры по одному и проверяйте результат после каждого изменения.

# /etc/netdata/netdata.conf
[web]
    bind to = 127.0.0.1:19999
[global]
    memory mode = dbengine

Практические советы

Эти рекомендации проверены на повседневных задачах. Начните с тех, которые закрывают вашу текущую боль, а не со всего списка сразу.

Совет 1. Не открывайте порт 19999 в интернет: дашборд не предназначен для публи

Не открывайте порт 19999 в интернет: дашборд не предназначен для публичного доступа.

Совет 2. Ограничьте память и объём базы, иначе Netdata займёт диск.

Ограничьте память и объём базы, иначе Netdata займёт диск.

Совет 3. Для нескольких серверов используйте Netdata Cloud или собственный роди

Для нескольких серверов используйте Netdata Cloud или собственный родительский узел.

Совет 4. Проверяйте, что оповещения действительно доходят: тестовое уведомление

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

Профилактика

Большинство повторяющихся сбоев с Netdata связано не с ошибкой в самой программе, а с окружением: обновились зависимости, изменился путь, закончилось место или другой администратор поправил конфиг. Поэтому профилактика начинается с фиксации исходного состояния.

Сохраните рабочий конфиг в систему контроля версий, добавьте короткий комментарий о том, зачем нужен каждый нестандартный параметр, и запишите команду проверки. Через месяц вы скажете себе спасибо: восстановить логику по чужому файлу без пояснений почти невозможно.

Итог

Большинство ошибок с Netdata лечится не переустановкой, а проверкой конфигурации, логов и прав доступа. Действуйте по одному изменению за раз — и причина быстро найдётся.