Введение

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

Вы запустите стек мониторинга из подготовленных файлов конфигурации. Он включает:

  • Grafana: инструмент визуализации, в котором вы будете создавать свой дашборд.
  • Prometheus: база данных временных рядов, которая будет служить источником данных для Grafana.
  • Node Exporter: агент, который собирает метрики оборудования и ОС с хост-машины и предоставляет их для сбора Prometheus.

Ваша цель — создать с нуля простой дашборд, отображающий текущую загрузку процессора (CPU) в лабораторной среде.

Запуск и изучение стека мониторинга

На этом шаге вы запустите Grafana, Prometheus и Node Exporter. Node Exporter предоставляет системные метрики, Prometheus собирает их, а Grafana отображает. Файлы конфигурации и автоматической настройки источника данных уже подготовлены.

cd /home/labex/project

Каждый фиксированный тег задаёт версию, используемую в этой лабораторной работе. Загрузка может занять несколько минут. Дождитесь возврата приглашения после каждой команды. При ошибке повторите ту же команду pull: Docker повторно использует готовые слои. Не продолжайте, пока загрузка не завершена.

docker pull prom/prometheus:v3.3.0
docker pull prom/node-exporter:v1.9.1
docker pull grafana/grafana:11.6.0

docker network create создаёт сеть, в которой контейнеры могут разрешать имена друг друга. docker run -d запускает контейнер в фоне; --name задаёт имя, --network подключает к сети, а -p связывает порт хоста с портом контейнера. Монтирования -v подключают подготовленные файлы конфигурации. Суффикс :ro делает их доступными только для чтения.

docker network create monitoring-net
docker run -d --name node-exporter --network monitoring-net -p 9100:9100 prom/node-exporter:v1.9.1
docker run -d --name prometheus --network monitoring-net -p 9090:9090 -v /home/labex/project/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro prom/prometheus:v3.3.0
docker run -d --name grafana --network monitoring-net -p 8080:3000 -v /home/labex/project/grafana/provisioning:/etc/grafana/provisioning:ro grafana/grafana:11.6.0

Параметры curl сообщают об ошибках HTTP и повторяют запрос при временных ошибках запуска до 30 раз с интервалом две секунды. Работающий контейнер ещё может инициализироваться, поэтому дождитесь успешной проверки состояния перед продолжением.

curl --fail --silent --show-error --retry 30 --retry-delay 2 --retry-connrefused --retry-all-errors http://localhost:9090/-/ready
curl --fail --silent --show-error --retry 30 --retry-delay 2 --retry-connrefused --retry-all-errors http://localhost:8080/api/health

Prometheus должен сообщить о готовности, а Grafana — вернуть "database": "ok". Проверьте контейнеры командой:

docker ps

Все три именованных контейнера должны иметь состояние Up. Выберите вкладку лаборатории Grafana. Если встроенный вход заблокирован, используйте элемент открытия в новой вкладке браузера. Войдите с именем пользователя admin и паролем admin, затем нажмите Skip на экране смены пароля. Эти данные предназначены только для временной лабораторной среды.

Откройте Connections → Data sources и убедитесь в наличии Prometheus. Файл автоматической настройки подключает его к http://prometheus:9090 через общую сеть Docker. Оставьте стек работающим, чтобы Prometheus собрал несколько образцов перед вводом запроса CPU.

Создание нового дашборда в Grafana

На этом шаге вы создадите пустой дашборд и добавите первую визуализацию. Дашборд располагает панели в сетке; каждая панель показывает результат запроса данных.

Откройте Dashboards в левой боковой панели. Нажмите New и выберите New dashboard.

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

Теперь должен появиться редактор панели с предварительным просмотром, редактором запросов и параметрами отображения. На следующем шаге вы введёте запрос CPU.

Добавление панели с запросом PromQL для загрузки CPU

На этом этапе вы добавите панель на свой дашборд и используете запрос PromQL (Prometheus Query Language) для получения данных о загрузке процессора.

Вы уже должны находиться в редакторе панелей с предыдущего шага.

В нижней части редактора вы найдете раздел запросов. Источник данных Prometheus должен быть выбран по умолчанию. Переключите редактор запросов в режим Code и введите следующий запрос PromQL. Его можно скопировать и вставить целиком.

100 - (avg by (instance) (rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100)

Разберем этот запрос:

  • node_cpu_seconds_total{mode="idle"}: это метрика из Node Exporter, которая подсчитывает общее количество секунд, в течение которых процессор находился в состоянии «простоя» (idle).
  • rate(...[5m]): эта функция вычисляет среднюю скорость увеличения времени простоя в секунду за последние 5 минут. Результат — значение от 0 до 1, представляющее долю времени, в течение которого процессор простаивал.
  • avg by (instance): это агрегирует результаты, что полезно, если у вас несколько процессоров или машин.
  • * 100: это преобразует дробное значение в проценты (например, 0.95 превращается в 95%).
  • 100 - ...: наконец, мы вычитаем процент простоя из 100, чтобы получить процент активной загрузки процессора.

Нажмите Run queries. Для расчёта rate нужны хотя бы два сбора данных; если стек только что запущен, подождите около 30 секунд и выполните запрос ещё раз. В верхней области предварительного просмотра должен появиться график загрузки CPU во времени.

Ваша панель теперь отображает данные, но ее можно улучшить с помощью более понятных подписей и форматирования, что вы и сделаете на следующем этапе.

Настройка и сохранение дашборда

На этом шаге вы зададите название панели CPU, настроите проценты и сохраните дашборд. Понятные подписи облегчают интерпретацию результатов.

В разделе Panel options справа задайте Title точно как CPU Usage %.

В Standard options откройте Unit, найдите percent и выберите Misc / Percent (0-100). Запрос уже возвращает значения от 0 до 100, поэтому эта единица добавляет знак процента без изменения масштаба значений.

Нажмите Back to dashboard, чтобы сохранить изменения панели и вернуться к дашборду. Сам дашборд ещё не сохранён постоянно.

Нажмите Save dashboard. В диалоге укажите точный заголовок My System Dashboard, затем нажмите Save. Проверка находит сохранённый дашборд по этому заголовку.

Убедитесь, что сохранённый дашборд содержит панель CPU Usage % с графиком CPU и процентными единицами.

Резюме

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

  • Изучили среду, состоящую из контейнеров Grafana, Prometheus и Node Exporter.
  • Перешли по интерфейсу Grafana для создания нового пустого дашборда.
  • Добавили панель визуализации и написали запрос PromQL для получения данных о загрузке процессора из источника данных Prometheus.
  • Настроили заголовок панели и форматирование единиц измерения для лучшей читаемости.
  • Сохранили готовый дашборд для дальнейшего использования.

Теперь вы освоили базовый рабочий процесс создания визуализаций в Grafana. Вы можете развивать эти знания, добавляя на свой дашборд больше панелей для мониторинга других системных метрик, таких как использование памяти, дисковый ввод-вывод или сетевой трафик.