Настройка через интерфейс

Внимание

  1. Добавление объекта/хоста в Платформу АМ выполняется через установку агента на этом хосте. Установка агента недоступна через интерфейс пользователя.

  2. Необходимо развернуть агент на хосте, после чего он сам зарегистрируется на Платформе и станет доступен к конфигурированию из интерфейса пользователя.

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

  4. Если через агент будут передаваться диагностические данные с других агентов, то необходимо данный агент развертывать с установленным режимом прокси.

  1. Открыть страницу Конфигурации -> Агенты со списком установленных агентов

  2. Кликом ЛКМ по пиктограмме редактирования записи в таблице открыть форму для настройки агента

Форма содержит следующие блоки:

  • Данные агента

  • Источники данных

  • SNMP Traps

  • Логи

  1. Заполнить необходимые блоки данными и сохранить по кнопке «Сохранить»

Изменение параметров блока с данными агента

При наличии установленного агента на хосте запись объекта/агента создается автоматически с параметрами агента и узла/точки подключения, на который(ую) агент сконфигурирован при установке.

Состав блока с данными агента:

Элемент интерфейса

Описание

Имя агента

Имя агента в текстовом виде

IP/FQDN адрес

Адрес агента

Точка подключения

Имя узла подключения, на который агент передает диагностические данные

Описание

Описание агента

Роль агента-прокси

Показывает, может ли агент выполнять функцию прокси или нет

Только поля «Имя агента» и «Описание» доступны к изменениям.

Настройка экспортеров для агента

  • Добавление встроенного экспортера
    Дефолтно в блоке «Источники данных» в секции «Экспортеры» представлены управляемые агентом экспортеры, которые установлены и сконфигурированы вместе с ним. При необходимости добавить встроенный экспортер под управление агентом, нужно кликнуть по кнопке «Добавить экспортер» в секции «Источники данных/Экспортеры» и выбрать экспортер из списка.


В открывшейся форме задаются следующие параметры:

Параметр

Описание

Имя экспортера

Имя встроенного экспортера, не изменяется

Вариант настроек

args/am для собственных экспортеров, args — для опенсорсных

Адрес:порт сервера

В формате <Адрес сервера>:<Порт>, с которого собираются метрики

Args

Поле доступно, если «Вариант настроек» = args

Config

Параметры конфигурационного файла экспортера. Это либо сам конфиг-файл, либо путь к нему

Labels

Лейблы для собираемых метрик. Формат Ключ:Значение. По этим лейблам данные метрик будут фильтроваться, например, для показа графиков на дашбордах

Добавить лейбл

По кнопке в список добавляются поля для задания нового лейбла

Удалить лейбл

По кнопке соответствующий лейбл удаляется из списка

Интервал сбора метрик, сек

Интервал сбора метрик в секундах

Включить сбор данных

Включает сбор данных экспортером

По кнопке «Отмена»/ «ОК» сохранение настроек экспортера отменяется/выполняется.

  • Редактирование настроек встроенного экспортера
    Для редактирования настроек уже подключенного к агенту встроенного экспортера нужно кликнуть по имени этого экспортера в списке подключенных экспортеров в секции «Источники данных/Экспортеры».
    Откроется форма с предзаполненными полями, аналогичная форме для добавления экспортера, в которой все поля из приведенных выше доступны к изменениям, за исключением полей «Имя экспортера» и «Вариант настройки».

  • Удаление встроенного экспортера
    Если в списке подключенных к агенту встроенных экспортеров присутствуют лишние, их можно удалить, последовательно кликая по соответствующим кнопкам «Удалить» и подтверждая операцию.

  • Добавление стороннего экспортера
    Добавление стороннего экспортера выполняется кликом по кнопке «Добавить» в секции «Источники данных/Таргеты».

В открывшейся форме задаются следующие параметры:

Параметр

Описание

Имя стороннего экспортера

Имя стороннего экспортера, вводится в поле руками

Адрес:порт сервера

В формате <ip-адрес>:<порт>; адрес, с которого собираются метрики

URL путь метрик

Начинается с /

Labels

Лейблы для собираемых метрик. Формат Ключ:Значение. По этим лейблам данные метрик будут фильтроваться, например, для показа графиков на дашбордах

Добавить лейбл

По кнопке в список добавляются поля для задания нового лейбла

Удалить лейбл

По кнопке соответствующий лейбл удаляется из списка

Интервал сбора метрик, сек

Интервал сбора метрик в секундах, целое неотрицательное число

Включить сбор данных

Включает сбор данных экспортером

По кнопке «Отмена»/ «ОК» сохранение настроек экспортера отменяется/выполняется.

  • Редактирование настроек стороннего экспортера
    Для редактирования настроек уже подключенного к агенту стороннего экспортера нужно кликнуть по имени этого экспортера в списке подключенных экспортеров в секции «Источники данных/Таргеты».
    Откроется форма с предзаполненными полями, аналогичная форме для добавления стороннего экспортера, в которой все поля из приведенных выше доступны к изменениям, за исключением поля «Имя стороннего экспортера».

  • Клонирование стороннего экспортера
    Для клонирования экспортера из списка подключенных к агенту сторонних экспортеров нужно кликнуть по соответствующей кнопке «Клонировать». В списке появится копия с другим уникальным именем.

  • Удаление стороннего экспортера
    Если в списке подключенных к агенту сторонних экспортеров присутствуют лишние, их можно удалить, последовательно кликая по соответствующим кнопкам «Удалить» и подтверждая операцию.

  • Добавление SNMP-Poll источника
    Добавление SNMP-Poll источника выполняется кликом по кнопке «Добавить» в секции «Источники данных/SNMP-Poll».

В открывшейся форме задаются следующие параметры:

Параметр

Описание

Имя SNMP-Poll источника

Имя SNMP-Poll источника, вводится в поле руками

Адрес устройства

Адрес, с которого собираются метрики

Порт устройства

Порт, с которого собираются метрики

Описание

Доп. информация о SNMP-Poll источнике

Версия SNMP

Доступен выбор одного значения из SNMP v1, SNMP v2c, SNMP v3

Техническая учетная запись

Доступен выбор одного значения из списка технических учетных записей вида SNMP соответствующей версии

Timeout, сек

Интервал в секундах, по истечении которого соединение разрывается, если нет ответа сервиса, целое неотрицательное число

Шаблон конфига SNMP-exporter

Доступен выбор одного значения из списка готовых шаблонов

Создать новый

По кнопке открывается окно для пошагового создания нового шаблона

Labels

Лейблы для собираемых метрик. Формат Ключ:Значение. По этим лейблам данные метрик будут фильтроваться, например, для показа графиков на дашбордах

Добавить лейбл

По кнопке в список добавляются поля для задания нового лейбла

Удалить лейбл

По кнопке соответствующий лейбл удаляется из списка

Включить сбор данных

Включает сбор данных с источника

По кнопке «Отмена»/ «ОК» сохранение настроек SNMP-Poll источника отменяется/выполняется.

  • Редактирование настроек SNMP-Poll источника
    Для редактирования настроек уже подключенного к агенту SNMP-Poll источника нужно кликнуть по имени этого источника в списке подключенных источников в секции «Источники данных/SNMP-Poll».
    Откроется форма с предзаполненными полями, аналогичная форме для добавления SNMP-Poll источника, в которой все поля из приведенных выше доступны к изменениям, за исключением поля «Имя SNMP-Poll источника».

  • Клонирование SNMP-Poll источника
    Для клонирования SNMP-Poll источника из списка подключенных к агенту SNMP-Poll источников нужно кликнуть по соответствующей кнопке «Клонировать». В списке появится копия с другим уникальным именем.

  • Удаление SNMP-Poll источника
    Если в списке подключенных к агенту SNMP-Poll источников присутствуют лишние, их можно удалить, последовательно кликая по соответствующим кнопкам «Удалить» и подтверждая операцию.

  • Добавление IPMI источника
    Добавление IPMI источника выполняется кликом по кнопке «Добавить» в секции «Источники данных/IPMI».

В открывшейся форме задаются следующие параметры:

Параметр

Описание

Имя IPMI источника

Имя IPMI источника, вводится в поле руками

Адрес устройства

Адрес, с которого собираются метрики

Порт устройства

Порт, с которого собираются метрики

Коллекторы

Доступен множественный выбор значений из списка доступных коллекторов

Driver

Доступен выбор одного значения из LAN и LANPLUS

Техническая учетная запись

Доступен выбор одного значения из списка технических учетных записей вида IPMI

Privelege

Доступен выбор одного значения из user, operator, admin

Timeout, сек

Интервал в секундах, по истечении которого соединение разрывается, если нет ответа сервиса, целое неотрицательное число

Описание

Доп. информация о SNMP-Poll источнике

Labels

Лейблы для собираемых метрик. Формат Ключ:Значение. По этим лейблам данные метрик будут фильтроваться, например, для показа графиков на дашбордах

Добавить лейбл

По кнопке в список добавляются поля для задания нового лейбла

Удалить лейбл

По кнопке соответствующий лейбл удаляется из списка

Расширенные настройки

Заголовок секции с доп.настройками

exclude_sensor_ids

Доп.настройки

workaround_flags

Доп.настройки

customArgs

Доп.настройки

Включить сбор данных

Включает сбор данных с источника

По кнопке «Отмена»/ «ОК» сохранение настроек IPMI источника отменяется/выполняется.

  • Редактирование настроек IPMI источника
    Для редактирования настроек уже подключенного к агенту IPMI источника нужно кликнуть по имени этого источника в списке подключенных источников в секции «Источники данных/IPMI».
    Откроется форма с предзаполненными полями, аналогичная форме для добавления IPMI источника, в которой все поля из приведенных выше доступны к изменениям, за исключением поля «Имя IPMI источника».

  • Клонирование IPMI источника
    Для клонирования IPMI источника из списка подключенных к агенту IPMI источников нужно кликнуть по соответствующей кнопке «Клонировать». В списке появится копия с другим уникальным именем.

  • Удаление IPMI источника
    Если в списке подключенных к агенту IPMI источников присутствуют лишние, их можно удалить, последовательно кликая по соответствующим кнопкам «Удалить» и подтверждая операцию.

Примечание

  1. Добавленные через UI экспортеры в дальнейшем автоматически устанавливаются из централизованного хранилища Платформы на хост объекта.

  2. Список добавленных на Платформу хостов доступен на странице Мониторинг → Интерфейсы по хостам.

Внимание

  1. Для корректного использования предустановленных дашбордов в Grafana нужно использовать специальные теги component, hostname, instance, group. Они позволяют корректно фильтровать необходимые объекты и показывать графики для нужных продуктов. В данный момент такие теги необходимо создавать и назначать вручную на соответствующие объекты.

  2. Из итогового списка объектов мониторинга затем формируется список targets в формате json, включающий в себя имя (hostname), адрес инстанса (instance) и теги (labels) каждого объекта мониторинга. Этот список доступен по специальному адресу <admin-ui-url>/api/endpoints?format=prometheus. Prometheus обращается к указанному адресу, считывает список объектов и, посредством механизма HTTP Service Discovery, добавляет их в свою конфигурацию, после чего начинает опрос и получение метрик от объектов мониторинга.

Настройка сбора SNMP Traps на агенте

Форма содержит следующие элементы:

Параметр

Описание

Включить сбор данных

Включает сбор трапов. Если не отмечен, то остальные поля формы недоступны для изменений

Порт приема

Порт, на который приходят трапы

Версии v1/v2c

Фильтрация трапов по версиям SNMP v1, v2

Версия v3

Фильтрация трапов по версии SNMP v3

Community string v1/v2c

Фильтрация трапов версии SNMP v1, v2 по community

Учетные записи v1/v2/v3

Фильтрация трапов по учетным записям (по community из УЗ типа SNMP v1, v2 и по username из УЗ типа SNMP v3)

Настройка сбора логов на агенте

Форма содержит следующие элементы:

Параметр

Описание

Сбор логов включен

Включает сбор логов агентом для vector. Если не отмечен, то остальные поля формы недоступны для изменений

Добавить логи агента

Включает сбор собственных логов агентом

Конфигурации сбора логов

Файлы конфигураций vector, расширяющих возможности сбора логов с различных объектов. Файлы выбираются из списка имеющихся на Платформе (их можно посмотреть на странице «Сбор логов»)