Перейти к содержимому

Статья 87 из 141

Гайды

Grafana и Prometheus на VPS: мониторинг сервера через Docker Compose и node_exporter

Связка Prometheus + node_exporter + Grafana показывает, что происходит с сервером: загрузку CPU, память, диск, сеть, нагрузку за любой период. node_exporter отдаёт метрики системы, Prometheus раз в 15 секунд их собирает и хранит, Grafana рисует графики и шлёт оповещения.

Инструкция проверена на Ubuntu 24.04 в ноябре 2026: Grafana 13.3, Prometheus 3.16, node_exporter 1.12.

Ресурс Минимум
RAM 1 ГБ свободной памяти
vCPU 1
Диск 2–5 ГБ под метрики за 30 дней для одного сервера
Софт Docker и Compose

Для HTTPS нужен поддомен, например grafana.example.com, с A-записью на IP сервера (DNS).

Сервис Порт Кому доступен
node_exporter 9100 только 127.0.0.1
Prometheus 9090 только 127.0.0.1
Grafana 3000 только 127.0.0.1, наружу через Nginx + HTTPS

Все три контейнера работают в сети хоста (network_mode: host). Так node_exporter видит настоящие сетевые интерфейсы сервера, а не виртуальную сеть Docker. Каждый сервис слушает только 127.0.0.1, поэтому снаружи порты 9100, 9090 и 3000 не открыты.

Окно терминала
mkdir -p /opt/monitoring/prometheus && cd /opt/monitoring
nano prometheus/prometheus.yml
global:
scrape_interval: 15s
scrape_configs:
- job_name: prometheus
static_configs:
- targets: ["127.0.0.1:9090"]
- job_name: node
static_configs:
- targets: ["127.0.0.1:9100"]

Пароль администратора Grafana держите в отдельном файле .env:

Окно терминала
echo "GRAFANA_PASSWORD=$(openssl rand -hex 16)" > .env
chmod 600 .env
cat .env

Запишите пароль. Затем docker-compose.yml:

services:
prometheus:
image: prom/prometheus:latest
restart: unless-stopped
network_mode: host
command:
- --config.file=/etc/prometheus/prometheus.yml
- --storage.tsdb.path=/prometheus
- --storage.tsdb.retention.time=30d
- --web.listen-address=127.0.0.1:9090
volumes:
- ./prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro
- prometheus-data:/prometheus
node-exporter:
image: quay.io/prometheus/node-exporter:latest
restart: unless-stopped
network_mode: host
pid: host
command:
- --path.rootfs=/host
- --web.listen-address=127.0.0.1:9100
volumes:
- /:/host:ro,rslave
grafana:
image: grafana/grafana:latest
restart: unless-stopped
network_mode: host
environment:
GF_SERVER_HTTP_ADDR: "127.0.0.1"
GF_SERVER_HTTP_PORT: "3000"
GF_SERVER_ROOT_URL: "https://grafana.example.com/"
GF_SECURITY_ADMIN_USER: "admin"
GF_SECURITY_ADMIN_PASSWORD: "${GRAFANA_PASSWORD}"
GF_USERS_ALLOW_SIGN_UP: "false"
volumes:
- grafana-data:/var/lib/grafana
volumes:
prometheus-data:
grafana-data:
Окно терминала
docker compose up -d

--storage.tsdb.retention.time=30d хранит метрики 30 дней. Больше срок, больше места на диске.

Проверьте, что Prometheus видит обе цели и что порты слушают только localhost:

Окно терминала
curl -s 127.0.0.1:9090/api/v1/targets | grep -o '"health":"[a-z]*"'
ss -tlnp | grep -E ':(9090|9100|3000)'

Обе цели должны быть "health":"up", а в выводе ss везде 127.0.0.1. Первый запуск Grafana занимает до минуты: она создаёт базу.

server {
listen 80;
server_name grafana.example.com;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
Окно терминала
ln -s /etc/nginx/sites-available/grafana /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d grafana.example.com

Заголовки Upgrade нужны для живого обновления панелей. Подробнее: Nginx, Let’s Encrypt.

Откройте https://grafana.example.com и войдите как admin с паролем из .env. Страница входа открывается на английском.

Страница входа Grafana

Интерфейс переводится на русский: откройте профиль (аватар справа сверху) и в настройках выберите язык «Русский». Ниже пункты меню даны в русском варианте.

Переменная GF_SECURITY_ADMIN_PASSWORD действует только при первом запуске, пока база Grafana пустая. Потом пароль меняется в профиле пользователя.

  1. Подключения → Источники данных → Добавить источник данных → Prometheus.
  2. В поле Prometheus server URL укажите http://127.0.0.1:9090.
  3. Пролистайте вниз и нажмите Сохранить и протестировать. Должно появиться «Successfully queried the Prometheus API».

Настройка источника данных Prometheus в Grafana

Нажимайте Prometheus в списке один раз. Каждый клик создаёт новый источник данных, и потом лишние придётся удалять.

Рисовать панели вручную не нужно. Сообщество поддерживает готовый дашборд «Node Exporter Full», ID 1860.

  1. Дашборды → Новое → Импорт (или адрес /dashboard/import).
  2. В поле «URL-адрес или идентификатор дашборда Grafana.com» введите 1860 и нажмите Загрузить.
  3. Проверьте имя и папку, нажмите Import.

Импорт дашборда 1860 в Grafana

Grafana скачивает дашборд с grafana.com, поэтому серверу нужен исходящий доступ в интернет. Источник данных выбирается уже на самом дашборде, в списке Datasource сверху.

Дашборд Node Exporter Full с реальными графиками сервера

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

Раздел Оповещение состоит из трёх частей:

  • Точки контакта: куда слать уведомления. Grafana поддерживает email, Telegram, webhook и другие каналы.
  • Правила оповещения: условие, например «свободного места на / меньше 10% дольше 5 минут».
  • Политики уведомлений: какое правило в какую точку контакта уходит.

Начните с двух правил: заполнение диска и отсутствие данных от node_exporter (сервер упал или контейнер остановлен). Для проверки доступности сайтов снаружи удобнее Uptime Kuma.

  • Prometheus и node_exporter не имеют пароля. Никогда не публикуйте порты 9090 и 9100 в интернет. В нашем docker-compose.yml они слушают только 127.0.0.1.
  • Наружу открыт только Nginx на 80 и 443. Остальное закройте файрволом. Не полагайтесь на UFW в связке с проброшенными портами Docker: правильная защита здесь в адресе 127.0.0.1.
  • Регистрация новых пользователей выключена (GF_USERS_ALLOW_SIGN_UP: "false").
  • Пароль администратора длинный и случайный. Для коллег создайте отдельные учётки с ролью Viewer.
Окно терминала
cd /opt/monitoring
docker compose pull && docker compose up -d

Дашборды, источники и правила хранятся в томе grafana-data, метрики в prometheus-data. Метрики обычно не бэкапят. Дашборды стоит сохранить:

Окно терминала
docker run --rm -v monitoring_grafana-data:/data -v /root:/backup alpine \
tar -czf /backup/grafana-$(date +%F).tar.gz -C /data .

Имя тома начинается с имени папки проекта (monitoring_). Проверьте его командой docker volume ls. Копии храните вне сервера: бэкапы.

Симптом Причина и решение
Источник данных: «connection refused» Неверный адрес. При network_mode: host указывайте http://127.0.0.1:9090, имя prometheus здесь не работает
Дашборд пустой, везде «Нет данных» В списке Datasource выбран не тот источник, например пустой созданный лишним кликом. Выберите рабочий, лишний удалите
Цель node в состоянии down node_exporter не запущен или слушает другой порт. Проверьте docker compose ps и ss -tlnp
Не входит с паролем из .env Пароль из переменной применяется только к пустой базе. Если меняли .env после первого запуска, действует старый пароль
Импорт по ID 1860 не загружается Нет исходящего доступа к grafana.com. Скачайте JSON дашборда на другом компьютере и загрузите файлом
Диск быстро заполняется Уменьшите retention.time или увеличьте scrape_interval