Установка Prometheus через Docker Compose для self-hosted

Для установки Prometheus в self-hosted окружении используй официальный Docker-образ. Это позволяет легко запустить и масштабировать систему мониторинга с минимальными усилиями.

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

Подготовка

1. Установите Docker: Убедитесь, что у вас установлен Docker и он запущен. Для Linux используйте sudo apt install docker.io, для macOS и Windows — Docker Desktop.
2. Создайте каталог: Создайте отдельную папку для хранения конфигурации и данных Prometheus, например, /opt/prometheus.
3. Получите официальный compose.yaml: Используйте следующий YAML-файл с безопасными placeholder’ами.

Конфигурация Docker Compose

version: '3.8'
services:
  prometheus:
    image: prom/prometheus:v3.15.0
    container_name: prometheus
    ports:
      - "9090:9090"
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
      - ./data:/prometheus/data
    environment:
      - PROMETHEUS_LOGS_LEVEL=info
      - PROMETHEUS_LOGS_FORMAT=json
    restart: unless-stopped

В этом примере:

• image: Используется официальный образ Prometheus v3.15.0.
• ports: Порт 9090 открыто для доступа через браузер.
• volumes: Конфигурационный файл и данные хранятся в локальной папке.
• environment: Установлены параметры логирования.

Запуск и проверка

1. Сохраните compose.yaml: Сохраните файл как docker-compose.yml в созданной папке.
2. Запустите контейнер: Выполните команду docker-compose up -d.
3. Проверьте запуск: Откройте браузер и перейдите по адресу http://localhost:9090/. Вы должны увидеть интерфейс Prometheus.
4. Проверьте логи: Для просмотра логов используйте docker logs prometheus.
5. Первый вход: В интерфейсе вы можете настроить источники метрик и правила алертов.

Обновление и резервное копирование

1. Обновите образ: Для обновления используйте docker-compose pull, затем docker-compose up -d --build.
2. Резервное копирование данных: Регулярно резервируйте данные из папки /opt/prometheus/data с помощью скрипта или инструмента, например, cp -r /opt/prometheus/data /backup/location.
3. Настройка HTTPS: Для безопасного доступа используйте Let’s Encrypt и обратный прокси, например Nginx или Traefik.
4. Безопасность: Убедитесь, что доступ к порту 9090 ограничен только доверенными IP-адресами. Используйте HTTPS для защиты данных в транспорте.

Частые ошибки и устранение

1. Ошибка доступа: Если вы не можете подключиться к Prometheus, проверьте, что порт 9090 открыт в брандмауэре или на уровне ОС.
2. Ошибка конфигурации: Убедитесь, что файл prometheus.yml корректно настроен и содержит все необходимые источники метрик.
3. Ошибка памяти: Если система не хранит данные, увеличьте объем дискового пространства в папке /opt/prometheus/data.
4. Ошибка версии: Убедитесь, что вы используете актуальную версию образа и соответствующие зависимости.
5. Ошибка логирования: Если логи не отображаются, проверьте параметры PROMETHEUS_LOGS_LEVEL и PROMETHEUS_LOGS_FORMAT.