Мониторинг сервера с помощью Netdata
Установите Netdata на Debian или Ubuntu, защитите панель управления с помощью Nginx, HTTPS и пароля, а затем настройте оповещения по e-mail.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
Это руководство расскажет, как установить Netdata на VPS или выделенный сервер под управлением Debian 12/13 или Ubuntu 22.04/24.04. Netdata каждую секунду собирает системные метрики (CPU, память, диски, сеть, службы) и отображает их в веб-панели.
К концу руководства у вас будут:
- агент Netdata, установленный из официального репозитория, из стабильного канала;
- панель управления, доступная только по HTTPS, за Nginx и под паролем;
- оповещения по e-mail, включая одно собственное оповещение;
- процедура обновления и резервного копирования.
Заказать сервер
Для мониторинга ваших служб HostMyServers предлагает несколько вариантов:
Предварительные требования
- Сервер под управлением Debian 12/13 или Ubuntu 22.04/24.04
- SSH-доступ с пользователем, имеющим права
sudo - Доменное имя с записью A:
netdata.ваш-домен.comдолжно указывать на IP-адрес сервера - Около 4 ГиБ свободного места на диске: при настройках по умолчанию Netdata ограничивает метрики 3 ГиБ, к которым добавляются его метаданные
- SMTP-аккаунт, если вы хотите получать оповещения по e-mail
Используемые порты
| Порт | Протокол | Назначение | Доступ |
|---|---|---|---|
| 22 | TCP | SSH (или ваш нестандартный порт) | Открыт, по возможности ограничьте |
| 80 | TCP | Проверка Let’s Encrypt и перенаправление на HTTPS | Открыт |
| 443 | TCP | Панель управления через Nginx | Открыт |
| 19999 | TCP | Агент Netdata | Только локально (127.0.0.1) |
Подготовка сервера
Обновите систему и установите необходимые инструменты:
sudo apt update
sudo apt upgrade -y
sudo apt install -y curl ufw nginx apache2-utils certbot python3-certbot-nginxНастройка брандмауэра
Разрешите SSH до включения UFW, иначе вы потеряете доступ к серверу. Если вы используете другой порт SSH, замените 22 на этот порт.
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp
sudo ufw allow 80,443/tcp
sudo ufw enable
sudo ufw status verboseПорта 19999 в этих правилах нет, поэтому снаружи он остаётся закрытым. Чтобы узнать больше, обратитесь к руководству Защитите ваш сервер.
Установка Netdata
Скачайте официальный скрипт, затем запустите его со стабильным каналом. Без этой опции скрипт предложит канал nightly, в который попадают версии для разработки.
curl -fsSL https://get.netdata.cloud/kickstart.sh -o /tmp/netdata-kickstart.sh
sh /tmp/netdata-kickstart.sh --release-channel=stable --disable-telemetryСкрипт определяет ваш дистрибутив, добавляет репозиторий Netdata и устанавливает нативные пакеты. Он запрашивает подтверждение и при необходимости использует sudo. Опция --disable-telemetry отключает отправку анонимной статистики.
Затем проверьте службу и тип установки:
sudo systemctl status netdata --no-pager
sudo netdata -W buildinfo | grep -E 'Installation Type|Install type:'
curl -s http://127.0.0.1:19999/api/v1/info | head -n 5Служба должна иметь статус active (running), тип установки — binpkg-deb, а последняя команда должна вернуть JSON.
Ограничение Netdata локальным интерфейсом
Откройте конфигурацию с помощью инструмента, входящего в Netdata:
cd /etc/netdata
sudo ./edit-config netdata.confВ секции [web] добавьте или измените строку bind to:
[web]
bind to = 127.0.0.1Перезапустите агент и проверьте адрес прослушивания:
sudo systemctl restart netdata
sudo ss -tlnp | grep 19999В выводе должно быть 127.0.0.1:19999, а не 0.0.0.0:19999 или *:19999.
Публикация панели управления через Nginx
Создание пароля
Создайте файл с учётными данными. Команда попросит вас задать пароль для пользователя admin:
sudo htpasswd -c /etc/nginx/.htpasswd-netdata admin
sudo chown root:www-data /etc/nginx/.htpasswd-netdata
sudo chmod 640 /etc/nginx/.htpasswd-netdataСоздание сайта Nginx
sudo nano /etc/nginx/sites-available/netdata.confВставьте следующую конфигурацию, указав свой домен:
upstream netdata_backend {
server 127.0.0.1:19999;
keepalive 64;
}
server {
listen 80;
listen [::]:80;
server_name netdata.ваш-домен.com;
location / {
auth_basic "Netdata";
auth_basic_user_file /etc/nginx/.htpasswd-netdata;
proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-Server $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://netdata_backend;
proxy_http_version 1.1;
proxy_pass_request_headers on;
proxy_set_header Connection "keep-alive";
proxy_store off;
}
}Включите сайт и перезагрузите Nginx:
sudo ln -s /etc/nginx/sites-available/netdata.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginxВключение HTTPS
Запросите сертификат Let’s Encrypt и включите перенаправление на HTTPS:
sudo certbot --nginx -d netdata.ваш-домен.com -m admin@ваш-домен.com --agree-tos --no-eff-email --redirect
sudo certbot renew --dry-runПодробнее — в руководстве Установка SSL-сертификата с Let's Encrypt.
Проверка доступа
С вашего компьютера выполните эти три проверки:
curl -s -o /dev/null -w '%{http_code}\n' https://netdata.ваш-домен.com/
curl -s -o /dev/null -w '%{http_code}\n' -u admin https://netdata.ваш-домен.com/
curl -m 5 http://IP_ВАШЕГО_СЕРВЕРА:19999/| Проверка | Ожидаемый результат |
|---|---|
| Без учётных данных | 401 |
| С учётными данными | 200 |
| Прямой доступ к порту 19999 | Ошибка соединения или превышено время ожидания |
Затем откройте https://netdata.ваш-домен.com в браузере и войдите. Если интерфейс предложит подключить агент к Netdata Cloud, этот шаг необязателен: локальная панель работает и без аккаунта.
Настройка оповещений
Netdata поставляется с множеством готовых оповещений (диск, память, CPU, сеть и т. д.). Чтобы вывести все загруженные оповещения:
curl -s 'http://127.0.0.1:19999/api/v1/alarms?all' | head -n 30Включение отправки e-mail
Netdata отправляет письма командой sendmail. Её предоставляет пакет msmtp-mta, который передаёт сообщения на ваш SMTP-сервер:
sudo apt install -y msmtp msmtp-mta
sudo nano /etc/msmtprcЕсли при установке появится вопрос об AppArmor, оставьте вариант по умолчанию. Затем укажите данные вашего SMTP-аккаунта:
defaults
auth on
tls on
tls_trust_file /etc/ssl/certs/ca-certificates.crt
syslog on
account alertes
host smtp.ваш-домен.com
port 587
from netdata@ваш-домен.com
user netdata@ваш-домен.com
password ВАШ_ПАРОЛЬ_SMTP
account default : alertesЭтот файл содержит пароль: изменять его должен только root, а читать — только группа netdata.
sudo chown root:netdata /etc/msmtprc
sudo chmod 640 /etc/msmtprc
printf 'Subject: Тест msmtp\n\nТестовое сообщение.\n' | sudo -u netdata msmtp alertes@ваш-домен.comВыбор получателя
cd /etc/netdata
sudo ./edit-config health_alarm_notify.confИзмените эти три переменные:
EMAIL_SENDER="netdata@ваш-домен.com"
SEND_EMAIL="YES"
DEFAULT_RECIPIENT_EMAIL="alertes@ваш-домен.com"Изменение вступит в силу со следующего оповещения. Отправьте тестовое уведомление:
sudo su -s /bin/bash netdata
export NETDATA_ALARM_NOTIFY_DEBUG=1
/usr/libexec/netdata/plugins.d/alarm-notify.sh test
exitВы должны получить три тестовых сообщения, соответствующих состояниям WARNING, CRITICAL и CLEAR.
Добавление собственного оповещения
Создайте файл в каталоге оповещений:
sudo nano /etc/netdata/health.d/cpu-15min.confЭтот пример отслеживает среднюю загрузку CPU за 15 минут:
alarm: cpu_usage_15min
on: system.cpu
lookup: average -15m unaligned of user,system,softirq,irq,guest
units: %
every: 1m
warn: $this > 80
crit: $this > 95
delay: down 15m multiplier 1.5 max 1h
summary: Высокая загрузка CPU за 15 минут
info: Средняя загрузка CPU за последние 15 минут
to: sysadminПерезагрузите оповещения без перезапуска агента, затем убедитесь, что ваше оповещение загружено:
sudo netdatacli reload-health
curl -s 'http://127.0.0.1:19999/api/v1/alarms?all' | grep cpu_usage_15minОбновление Netdata
Скрипт установки по умолчанию включает ежедневное автоматическое обновление. Чтобы проверить его расписание:
systemctl list-timers netdata-updater.timer --no-pagerВ зависимости от системы расписание может также задаваться через cron, если таймер systemd не используется. Чтобы запустить обновление вручную, снова выполните официальный скрипт:
curl -fsSL https://get.netdata.cloud/kickstart.sh -o /tmp/netdata-kickstart.sh
sh /tmp/netdata-kickstart.shЧтобы отключить автоматические обновления:
sudo /usr/libexec/netdata/netdata-updater.sh --disable-auto-updatesРезервное копирование и восстановление
| Данные | Расположение |
|---|---|
| Конфигурация | /etc/netdata |
| Метрики | /var/cache/netdata |
| Идентификатор агента и возможный токен | /var/lib/netdata |
Остановите агент на время копирования метрик, чтобы получить согласованную резервную копию:
sudo systemctl stop netdata
sudo tar -czpf "/root/netdata-$(date +%F).tar.gz" /etc/netdata /var/cache/netdata /var/lib/netdata
sudo systemctl start netdata
sudo chmod 600 /root/netdata-*.tar.gzЗатем скопируйте архив за пределы сервера. Сохраните также /etc/msmtprc и файлы Nginx, если хотите воссоздать всё в точности.
Для восстановления при необходимости переустановите Netdata, затем выполните:
sudo systemctl stop netdata
sudo rm -rf /var/cache/netdata
sudo tar -xzpf /root/netdata-ГГГГ-ММ-ДД.tar.gz -C /
sudo systemctl start netdataЕсли что-то не работает
Ошибка 502 Bad Gateway
Nginx не может связаться с агентом.
sudo systemctl status netdata --no-pager
sudo ss -tlnp | grep 19999
sudo tail -n 30 /var/log/nginx/error.logУбедитесь, что агент работает и что bind to совпадает с адресом в upstream, здесь это 127.0.0.1.
Браузер постоянно запрашивает пароль
Проверьте права на файл и учётные данные:
sudo ls -l /etc/nginx/.htpasswd-netdata
sudo htpasswd -v /etc/nginx/.htpasswd-netdata adminФайл должен быть доступен для чтения группе www-data. Ошибка Permission denied в /var/log/nginx/error.log подтверждает проблему с правами.
Порт 19999 отвечает из Интернета
Убедитесь, что секция [web] находится в /etc/netdata/netdata.conf, перезапустите агент, затем проверьте sudo ss -tlnp | grep 19999 и sudo ufw status verbose.
Certbot завершается с ошибкой
Проверьте с помощью getent hosts netdata.ваш-домен.com, что домен указывает на сервер, что порт 80 открыт и что sudo nginx -t не сообщает об ошибках.
Письма не приходят
- Повторите тест
alarm-notify.sh testи прочитайте его подробный вывод. - Посмотрите журналы msmtp командой
sudo journalctl -t msmtp -n 30 --no-pager. - Если
command -v sendmailничего не возвращает, пакетmsmtp-mtaне установлен. - Ошибка
Permission deniedдля/etc/msmtprcуказывает на проблему с правами на этот файл. - Если SMTP-соединение прерывается по тайм-ауту, попробуйте другой порт, указанный вашим почтовым провайдером. Чтобы узнать, действует ли фильтрация для вашей службы, обратитесь в поддержку из личного кабинета.
Netdata занимает слишком много места на диске
Проверьте фактическое занятое место, затем уменьшите срок хранения в секции [db] файла netdata.conf:
sudo du -sh /var/cache/netdata
cd /etc/netdata
sudo ./edit-config netdata.conf[db]
dbengine tier 0 retention size = 500MiB
dbengine tier 1 retention size = 500MiB
dbengine tier 2 retention size = 500MiBЗатем перезапустите агент командой sudo systemctl restart netdata.
Что дальше
Чтобы хранить метрики нескольких серверов и создавать собственные панели, обратитесь к руководству Установка Prometheus и Grafana.