IPMI

Примечание

Для корректного отображения устройств на дашбоарде в Grafana следует использовать значение тега component как IP-адрес или имя устройства, которое мониторится с помощью ipmi-exporter

Для мониторинга удаленных устройств по протоколу IPMI применяется ipmi-exporter. Экспортер опрашивает устройства и выводит метрики в формате Prometheus для дальнейшего анализа.

Требования

Для работы экспортера необходим компонент FreeIPMI, включающий следующие приложения:

  • ipmimonitoring/ipmi-sensors

  • ipmi-dcmi

  • ipmi-raw

  • bmc-info

  • ipmi-sel

  • ipmi-chassis

Документация:

Ключи запуска экспортера

Ключ

Описание

--config.file=CONFIG.FILE

Путь к файлу конфигурации.

--freeipmi.path=FREEIPMI.PATH

Путь к исполняемым файлам FreeIPMI (по умолчанию: используется $PATH).

--web.listen-address=:9290

Адреса для экспорта метрик и веб-интерфейса. Можно указать несколько.

--web.config.file=""

Путь к файлу конфигурации для TLS или аутентификации.

--log.level=info

Уровень логирования: debug, info, warn, error.

--log.format=logfmt

Формат логов: logfmt или json.

Запуск ipmi-exporter с помощью агента мониторинга

Для установки экспортера как сервиса см.руководство.

Для корректного запуска экспортера необходимо выполнить следующие настройки агента:

Настройка раздела exporters

В конфигурационном файле агента укажите параметры экспортера:

exporters:
  - name: ipmi_exporter
    is_custom: true
    args: "--config.file=/opt/astramon-agent/exporters/config/ipmi-conf.yml"
    health_address: 127.0.0.1:9290/metrics

  • Поле name должно совпадать с названием бинарного файла (например: astramon-ipmi_exporter-custom).

  • Параметр is_custom указывает, что это сторонний экспортер, но агент может управлять им (запуск, health check, остановка).

  • Параметр args содержит путь к файлу конфигурации экспортера.

Начстройка раздела metrics

Настройте целевые устройства для сбора метрик:

custom_targets:
  - name: ipmi_exporter1
    component: 10.177.248.234
    target: 127.0.0.1:9290
    metrics_path: /ipmi?target=10.177.248.234
  - name: ipmi_exporter2
    component: 10.177.248.228
    target: 127.0.0.1:9290
    metrics_path: /ipmi?target=10.177.248.228

  • Поле name должно быть уникальным (особенность vmagent).

  • Параметр component добавляет лейбл для различения метрик устройств.

  • Параметр target указывает адрес и порт экспортера.

  • Параметр metrics_path задает эндпоинт для сбора метрик. По умолчанию используется /metrics, но в примере используется /ipmi?target=<адрес>. Этот эндпоинт выводит метрики по запуску скриптов, а не метрики самих скриптов. Если необходимо можно создать еще одну запись и собирать непосредственно метрики из /metrics.