Установка Prometheus и Grafana
Установите Prometheus, node_exporter и Grafana без Docker на Debian или Ubuntu: панели мониторинга, защищённый доступ по HTTPS, обновления и резервное копирование.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
Это руководство расскажет, как установить полноценную платформу мониторинга без Docker на VPS или выделенный сервер под управлением Debian 12/13 или Ubuntu 22.04/24.04.
| Компонент | Назначение | Порт | Прослушивание |
|---|---|---|---|
| node_exporter | Предоставляет системные метрики | 9100 | 127.0.0.1 |
| Prometheus | Собирает и хранит метрики | 9090 | 127.0.0.1 |
| Grafana | Отображает панели мониторинга | 3000 | 127.0.0.1 |
| Nginx | Публикует Grafana по HTTPS | 80, 443 | Публичное |
Публикуется только Grafana: за Nginx, по HTTPS и с учётной записью. Prometheus и node_exporter никогда не открываются в Интернет.
Заказать сервер
Для размещения системы мониторинга HostMyServers предлагает несколько вариантов:
Предварительные требования
- Сервер под управлением Debian 12/13 или Ubuntu 22.04/24.04 с архитектурой
amd64илиarm64 - SSH-доступ с пользователем, имеющим права
sudo - Доменное имя с записью A:
grafana.ваш-домен.comдолжно указывать на IP-адрес сервера - Для Grafana согласно её документации необходимо минимум 512 МБ ОЗУ и 1 ядро CPU — дополнительно к ресурсам, нужным Prometheus
- Место на диске для метрик: оно зависит от числа собираемых рядов и срока хранения
Подготовка сервера
sudo apt update
sudo apt upgrade -y
sudo apt install -y curl wget tar jq gnupg ufw nginx certbot python3-certbot-nginx apache2-utilsНастройте брандмауэр. Разрешите SSH до включения UFW и замените 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Порты 3000, 9090 и 9100 открывать нельзя.
Установка Prometheus
Создание пользователя и каталогов
sudo useradd --system --no-create-home --shell /usr/sbin/nologin prometheus
sudo mkdir -p /etc/prometheus /var/lib/prometheus
sudo chown prometheus:prometheus /var/lib/prometheusЗагрузка и проверка архива
VERSION=3.13.5
ARCH=$(dpkg --print-architecture)
cd "$(mktemp -d)"
wget "https://github.com/prometheus/prometheus/releases/download/v${VERSION}/prometheus-${VERSION}.linux-${ARCH}.tar.gz"
wget "https://github.com/prometheus/prometheus/releases/download/v${VERSION}/sha256sums.txt"
sha256sum --check --ignore-missing sha256sums.txt
tar -xzf "prometheus-${VERSION}.linux-${ARCH}.tar.gz"
sudo install -m 0755 "prometheus-${VERSION}.linux-${ARCH}/prometheus" "prometheus-${VERSION}.linux-${ARCH}/promtool" /usr/local/bin/
prometheus --versionПроверка должна вывести OK для загруженного архива.
Настройка сбора метрик
sudo nano /etc/prometheus/prometheus.ymlglobal:
scrape_interval: 15s
evaluation_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"]Проверьте файл:
sudo chown -R root:prometheus /etc/prometheus
sudo chmod 750 /etc/prometheus
sudo chmod 640 /etc/prometheus/prometheus.yml
sudo promtool check config /etc/prometheus/prometheus.ymlСоздание службы systemd
sudo nano /etc/systemd/system/prometheus.service[Unit]
Description=Prometheus
Wants=network-online.target
After=network-online.target
[Service]
User=prometheus
Group=prometheus
Type=simple
ExecStart=/usr/local/bin/prometheus \
--config.file=/etc/prometheus/prometheus.yml \
--storage.tsdb.path=/var/lib/prometheus \
--storage.tsdb.retention.time=30d \
--web.listen-address=127.0.0.1:9090 \
--web.enable-admin-api
ExecReload=/bin/kill -HUP $MAINPID
Restart=on-failure
NoNewPrivileges=true
ProtectSystem=full
ProtectHome=true
PrivateTmp=true
[Install]
WantedBy=multi-user.target| Опция | Действие |
|---|---|
--storage.tsdb.retention.time=30d |
Хранит метрики 30 дней (по умолчанию — 15 дней) |
--web.listen-address=127.0.0.1:9090 |
Слушает только локальный интерфейс |
--web.enable-admin-api |
Включает API, используемый для резервного копирования через снимки |
Запустите службу:
sudo systemctl daemon-reload
sudo systemctl enable --now prometheus
sudo systemctl status prometheus --no-pagerУстановка node_exporter
sudo useradd --system --no-create-home --shell /usr/sbin/nologin node_exporter
VERSION=1.13.0
ARCH=$(dpkg --print-architecture)
cd "$(mktemp -d)"
wget "https://github.com/prometheus/node_exporter/releases/download/v${VERSION}/node_exporter-${VERSION}.linux-${ARCH}.tar.gz"
wget "https://github.com/prometheus/node_exporter/releases/download/v${VERSION}/sha256sums.txt"
sha256sum --check --ignore-missing sha256sums.txt
tar -xzf "node_exporter-${VERSION}.linux-${ARCH}.tar.gz"
sudo install -m 0755 "node_exporter-${VERSION}.linux-${ARCH}/node_exporter" /usr/local/bin/
sudo nano /etc/systemd/system/node_exporter.service[Unit]
Description=Prometheus Node Exporter
Wants=network-online.target
After=network-online.target
[Service]
User=node_exporter
Group=node_exporter
Type=simple
ExecStart=/usr/local/bin/node_exporter --web.listen-address=127.0.0.1:9100
Restart=on-failure
NoNewPrivileges=true
[Install]
WantedBy=multi-user.targetsudo systemctl daemon-reload
sudo systemctl enable --now node_exporter
curl -s http://127.0.0.1:9100/metrics | head -n 5Убедитесь, что Prometheus собирает метрики с обеих целей. Подождите около пятнадцати секунд после запуска:
curl -s http://127.0.0.1:9090/api/v1/targets | jq -r '.data.activeTargets[] | "\(.labels.job) \(.health)"'Ожидаемый результат:
node up
prometheus upУстановка Grafana
Добавление официального репозитория
sudo mkdir -p /etc/apt/keyrings
sudo wget -O /etc/apt/keyrings/grafana.asc https://apt.grafana.com/gpg-full.key
sudo chmod 644 /etc/apt/keyrings/grafana.asc
echo "deb [signed-by=/etc/apt/keyrings/grafana.asc] https://apt.grafana.com stable main" | sudo tee /etc/apt/sources.list.d/grafana.list
sudo apt update
sudo apt install -y grafanaОграничение Grafana локальным интерфейсом
Начальная учётная запись Grafana — admin / admin. Ограничьте прослушивание до первого запуска:
sudo nano /etc/grafana/grafana.iniВ секции [server] раскомментируйте или добавьте:
[server]
http_addr = 127.0.0.1
http_port = 3000Запустите службу и убедитесь, что она отвечает:
sudo systemctl daemon-reload
sudo systemctl enable --now grafana-server
sudo ss -tlnp | grep 3000
curl -s http://127.0.0.1:3000/api/healthСмена пароля администратора
Смените пароль до публикации Grafana. С вашего компьютера откройте SSH-туннель и не закрывайте эту сессию:
ssh -L 3000:127.0.0.1:3000 ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_ВАШЕГО_СЕРВЕРАОткройте http://localhost:3000, войдите с admin / admin, затем задайте надёжный пароль, когда Grafana об этом попросит. После этого туннель можно закрыть.
Добавление Prometheus как источника данных
sudo nano /etc/grafana/provisioning/datasources/prometheus.yamlapiVersion: 1
datasources:
- name: Prometheus
type: prometheus
access: proxy
url: http://127.0.0.1:9090
isDefault: true
editable: falsesudo chown root:grafana /etc/grafana/provisioning/datasources/prometheus.yaml
sudo chmod 640 /etc/grafana/provisioning/datasources/prometheus.yaml
sudo systemctl restart grafana-serverПубликация Grafana по HTTPS
Создание сайта Nginx
sudo nano /etc/nginx/sites-available/grafana.confmap $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
upstream grafana {
server 127.0.0.1:3000;
}
server {
listen 80;
listen [::]:80;
server_name grafana.ваш-домен.com;
location / {
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_pass http://grafana;
}
location /api/live/ {
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_set_header Host $host;
proxy_pass http://grafana;
}
}sudo ln -s /etc/nginx/sites-available/grafana.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
sudo certbot --nginx -d grafana.ваш-домен.com -m admin@ваш-домен.com --agree-tos --no-eff-email --redirect
sudo certbot renew --dry-runПодробнее о сертификатах — в руководстве Установка SSL-сертификата с Let's Encrypt.
Завершение настройки Grafana
sudo nano /etc/grafana/grafana.iniИзмените следующие секции:
[server]
http_addr = 127.0.0.1
http_port = 3000
domain = grafana.ваш-домен.com
root_url = https://grafana.ваш-домен.com/
[security]
cookie_secure = true
cookie_samesite = lax
strict_transport_security = true
[users]
allow_sign_up = falsesudo systemctl restart grafana-serverИмпорт панели мониторинга
- Откройте
https://grafana.ваш-домен.comи войдите. - Нажмите Dashboards в главном меню.
- Нажмите New, затем Import dashboard.
- Введите идентификатор
1860(Node Exporter Full) и нажмите Load. - Выберите источник данных Prometheus, затем нажмите Import.
Проверка установки
На сервере ни одна внутренняя служба не должна слушать публичный адрес:
sudo ss -tlnp | grep -E ':(3000|9090|9100)\b'Каждая строка должна начинаться с 127.0.0.1. С вашего компьютера эти команды должны завершаться ошибкой:
curl -m 5 http://IP_ВАШЕГО_СЕРВЕРА:3000/
curl -m 5 http://IP_ВАШЕГО_СЕРВЕРА:9090/
curl -m 5 http://IP_ВАШЕГО_СЕРВЕРА:9100/metricsНаконец, https://grafana.ваш-домен.com должен показывать страницу входа с действительным сертификатом.
Чтобы открыть интерфейс Prometheus, воспользуйтесь SSH-туннелем, затем откройте http://localhost:9090:
ssh -L 9090:127.0.0.1:9090 ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_ВАШЕГО_СЕРВЕРАЗащита Prometheus паролем (необязательно)
Локальное прослушивание уже исключает любой доступ из Интернета. Добавьте пароль, если к серверу имеют доступ другие пользователи или приложения.
Сначала сгенерируйте хеш пароля:
htpasswd -nBC 12 "" | tr -d ':\n'; echoСоздайте /etc/prometheus/web.yml с помощью sudo nano и вставьте в него этот хеш:
basic_auth_users:
admin: "ХЕШ_BCRYPT"Сохраните также пароль в открытом виде: он нужен Prometheus для сбора собственных метрик:
sudo install -o root -g prometheus -m 640 /dev/null /etc/prometheus/web-password
sudo nano /etc/prometheus/web-password
sudo chown root:prometheus /etc/prometheus/web.yml
sudo chmod 640 /etc/prometheus/web.yml
sudo promtool check web-config /etc/prometheus/web.ymlЗатем внесите эти три изменения:
-
В
prometheus.serviceдобавьте--web.config.file=/etc/prometheus/web.ymlв командуExecStart. -
В
prometheus.ymlдополните заданиеprometheus:YAML- job_name: prometheus basic_auth: username: admin password_file: /etc/prometheus/web-password static_configs: - targets: ["127.0.0.1:9090"] -
В источнике данных Grafana добавьте учётные данные:
YAMLbasicAuth: true basicAuthUser: admin secureJsonData: basicAuthPassword: ВАШ_ПАРОЛЬ_PROMETHEUS
Перезагрузите конфигурацию и перезапустите службы:
sudo promtool check config /etc/prometheus/prometheus.yml
sudo systemctl daemon-reload
sudo systemctl restart prometheus grafana-serverТеперь добавляйте -u admin к командам curl, обращающимся к порту 9090.
Мониторинг другого сервера
Установите node_exporter на второй сервер, указав в его службе --web.listen-address=0.0.0.0:9100. На этом втором сервере разрешите доступ только вашему серверу Prometheus:
sudo ufw allow from IP_ВАШЕГО_СЕРВЕРА to any port 9100 proto tcpЗатем добавьте цель в /etc/prometheus/prometheus.yml и перезагрузите Prometheus:
- job_name: node
static_configs:
- targets: ["127.0.0.1:9100", "IP_ВТОРОГО_СЕРВЕРА:9100"]sudo promtool check config /etc/prometheus/prometheus.yml
sudo systemctl reload prometheusОбновление
Сначала сделайте резервную копию данных и прочитайте примечания к выпуску.
Prometheus: повторите блок загрузки с новым значением VERSION, затем выполните:
sudo promtool check config /etc/prometheus/prometheus.yml
sudo systemctl restart prometheus
prometheus --versionnode_exporter: аналогично повторите его загрузку и установку, затем выполните:
sudo systemctl restart node_exporter
node_exporter --versionGrafana: пакет обновляется через APT.
sudo apt update
sudo apt install --only-upgrade grafana
sudo systemctl restart grafana-serverРезервное копирование и восстановление
Prometheus
Документация Prometheus рекомендует снимки (snapshots):
SNAPSHOT=$(curl -fsS -X POST http://127.0.0.1:9090/api/v1/admin/tsdb/snapshot | jq -r '.data.name')
sudo tar -czpf "/root/prometheus-${SNAPSHOT}.tar.gz" -C /var/lib/prometheus/snapshots "$SNAPSHOT"
sudo rm -rf "/var/lib/prometheus/snapshots/${SNAPSHOT}"
sudo tar -czpf "/root/prometheus-config-$(date +%F).tar.gz" /etc/prometheus /etc/systemd/system/prometheus.serviceЧтобы восстановить снимок:
sudo systemctl stop prometheus
sudo mv /var/lib/prometheus /var/lib/prometheus.old
sudo mkdir /var/lib/prometheus
sudo tar -xzpf /root/prometheus-ИМЯ_СНИМКА.tar.gz --strip-components=1 -C /var/lib/prometheus
sudo chown -R prometheus:prometheus /var/lib/prometheus
sudo systemctl start prometheusGrafana
По умолчанию Grafana хранит учётные записи и панели мониторинга в базе SQLite /var/lib/grafana/grafana.db. Остановите службу на время копирования:
sudo systemctl stop grafana-server
sudo tar -czpf "/root/grafana-$(date +%F).tar.gz" /var/lib/grafana /etc/grafana
sudo systemctl start grafana-serverДля восстановления:
sudo systemctl stop grafana-server
sudo tar -xzpf /root/grafana-ГГГГ-ММ-ДД.tar.gz -C /
sudo chown -R grafana:grafana /var/lib/grafana
sudo systemctl start grafana-serverЭти архивы содержат секретные данные: ограничьте права на них командой sudo chmod 600 /root/*.tar.gz и скопируйте их за пределы сервера.
Если что-то не работает
Prometheus не запускается
sudo journalctl -u prometheus -n 50 --no-pager
sudo promtool check config /etc/prometheus/prometheus.yml
sudo ls -ld /var/lib/prometheusОшибка permission denied для каталога данных исправляется командой sudo chown -R prometheus:prometheus /var/lib/prometheus. Ошибка address already in use означает, что порт 9090 занят другим процессом: найдите его командой sudo ss -tlnp | grep 9090.
Цель находится в состоянии down
Посмотрите поле lastError:
curl -s http://127.0.0.1:9090/api/v1/targets | jq '.data.activeTargets[] | {job: .labels.job, health, lastError}'connection refused означает, что экспортёр остановлен или слушает другой адрес. Ошибка context deadline exceeded при обращении к другому серверу скорее указывает на брандмауэр.
Ошибка 502 Bad Gateway в Grafana
sudo systemctl status grafana-server --no-pager
sudo journalctl -u grafana-server -n 50 --no-pager
curl -s http://127.0.0.1:3000/api/healthБесконечный цикл входа или сообщение «origin not allowed»
Убедитесь, что domain и root_url точно совпадают с адресом, который вы используете в браузере, и что Nginx передаёт заголовок Host. Параметр cookie_secure = true требует доступа по HTTPS.
На панели мониторинга нет данных
- Убедитесь, что обе цели находятся в состоянии
up. - Увеличьте отображаемый период до нескольких часов.
- На панели мониторинга проверьте, что выбраны правильные источник данных,
jobи экземпляр.
Потерян пароль администратора Grafana
Сбросьте его на сервере, затем снова смените в интерфейсе:
sudo -u grafana grafana cli --homepath /usr/share/grafana --config /etc/grafana/grafana.ini admin reset-admin-password ВРЕМЕННЫЙ_ПАРОЛЬДиск заполняется
Уменьшите --storage.tsdb.retention.time или добавьте ограничение через --storage.tsdb.retention.size=10GB, затем выполните sudo systemctl daemon-reload и sudo systemctl restart prometheus. Руководство Проверка места на диске и использования в Linux поможет определить, что занимает место.
Что дальше
Если вам нужно более простое решение для одного сервера, обратитесь к руководству Мониторинг сервера с помощью Netdata.