Развёртывание в Docker: первый запуск Prometheus

«Лучше один раз запустить, чем сто раз прочитать»

1. Изоляция — Prometheus не загрязняет систему зависимостями
2. Портативность — одинаково работает на Linux, macOS, Windows
3. Версионность — легко переключаться между версиями
4. Production-like — в продакшене вы скорее всего тоже будете использовать контейнеры

• Docker и Docker Compose установлены
• Базовое понимание работы с контейнерами

monitoring/
├── docker-compose.yml
├── prometheus/
│   └── prometheus.yml
└── grafana/
    └── provisioning/
        └── datasources/
            └── prometheus.yml

• scrape_interval — глобальная частота опроса целей (15 секунд по умолчанию). Можно переопределить для каждой job отдельно.
• evaluation_interval — как часто вычислять правила алертинга и recording rules.
• job_name — имя логической группы целей. Prometheus автоматически добавит лейбл job="prometheus" ко всем метрикам от этой job.
• targets — список адресов для опроса. localhost:9090 — это сам Prometheus (он отдаёт метрики о себе).

• image: prom/prometheus:v2.52.0 — официальный образ Prometheus. Всегда фиксируйте версию в production — не используйте latest.
• ports: "9090:9090" — пробрасываем порт 9090 на хост. Web UI Prometheus будет доступен по адресу http://localhost:9090.
• volumes — монтируем:
  • Конфигурацию (prometheus.yml) в /etc/prometheus/
  • Данные в volume prometheus_data (сохраняется после перезапуска)
• command — аргументы командной строки:
  • --config.file — путь к конфигу
  • --storage.tsdb.path — где хранить данные
  • --storage.tsdb.retention.time — сколько хранить данные (15 дней)
• restart: unless-stopped — автоматически перезапускать при падении

• image: grafana/grafana:10.4.0 — официальный образ Grafana.
• ports: "3000:3000" — Grafana будет доступна по http://localhost:3000.
• volumes — монтируем:
  • Данные (дашборды, пользователи) в volume grafana_data
  • Provisioning (автоконфигурация источников данных)
• environment — переменные окружения:
  • GF_SECURITY_ADMIN_USER/PASSWORD — логин/пароль администратора
  • GF_INSTALL_PLUGINS — плагины для установки
• restart: unless-stopped — автоперезапуск

• prometheus_data — хранение метрик Prometheus
• grafana_data — хранение дашбордов и настроек Grafana

NAME          STATUS         PORTS
prometheus    Up (healthy)   0.0.0.0:9090->9090/tcp
grafana       Up (healthy)   0.0.0.0:3000->3000/tcp

• Таблицу с временными рядами
• Лейблы (например, code="200", instance="localhost:9090")
• Значения метрик

1. Нажмите ⚙️ (Settings) → Data sources
2. Должен быть Prometheus с URL http://prometheus:9090

1. В Grafana нажмите Create → Dashboard
2. Нажмите Add visualization
3. Выберите источник данных Prometheus
4. В редакторе запросов введите: rate(promhttp_metric_handler_requests_total[5m])
5. Нажмите Run
6. Должен появиться график — запросы в секунду к Prometheus

• promhttp_metric_handler_requests_total — counter обработанных запросов
• rate(...[5m]) — скорость изменения за последние 5 минут (запросов в секунду)

1. Target не запущен
2. Неправильный адрес (например, localhost вместо имени сервиса)
3. Фаервол блокирует порт

• Проверьте docker compose ps — все ли контейнеры запущены
• Убедитесь, что используете имя сервиса Docker Compose (cadvisor:8080, а не localhost:8080)
• Попробуйте curl http://cadvisor:8080/metrics из контейнера Prometheus

1. Метрики ещё не накопились (подождите 1-2 минуты)
2. Неправильное имя метрики
3. Неправильные лейблы

• Подождите пару минут, Prometheus должен собрать данные
• Используйте автодополнение в Prometheus UI для проверки имён метрик
• Проверьте лейблы через {job="cadvisor"}

• Закончилось место на диске
• Volume не настроен, данные пишутся в контейнер

• Проверьте место: df -h
• Убедитесь, что volume prometheus_data существует
• Увеличьте storage.tsdb.retention.time или уменьшите scrape_interval

• Писать запросы на PromQL
• Добавлять метрики в свои приложения
• Создавать информативные дашборды в Grafana
• Настраивать алерты

1. Запустите стек из docker-compose
2. Откройте Prometheus UI, поэкспериментируйте с запросами:
   • up — показывает статус всех targets (1 = доступен, 0 = недоступен)
   • prometheus_tsdb_head_samples_appended_total — сколько метрик записано
3. Откройте Grafana, создайте дашборд с 2-3 панелями для Prometheus
4. Добавьте cAdvisor, найдите метрики использования памяти контейнерами

1. Docker Compose — удобный способ развернуть Prometheus и Grafana локально.
2. Volumes — обязательны для сохранения данных между перезапусками.
3. Конфигурация Prometheus — YAML-файл с scrape_configs, определяющий, какие цели опрашивать.
4. Сетевое взаимодействие — в Docker Compose сервисы обращаются друг к другу по имени (http://prometheus:9090).
5. cAdvisor — готовый экспортёр для мониторинга Docker контейнеров.
6. Первые запросы — up, rate(), базовые метрики Prometheus.