Как настроить получение метрик в формате Prometheus для ПО WebmonitorX?
Необходимые условия для выполнения процедуры
Сервисы в составе Аккаунта:
Права доступа вашей учетной записи пользователя:
1. Создайте API-токен пользователя с правом доступа к статистике для работы с API (если API-токен уже создавали ранее используйте его)¶
- Для получения API-токена необходимо в клиентском портале NGENIX Multidesk на странице Мой профиль пользователя сгенерировать новый API-токен.
Сохраните полученный токен локально, после закрытия окна с токеном повторно посмотреть его не удастся и придется создавать новый токен.
2. На своей инфраструктуре c Prometheus настройте отправку регулярных запросов к API мониторинга¶
-
Используйте
GETзапрос к ручке API/caf/instant?customerId={id}из API мониторинга.При отправке запроса необходимо указывать:
- URL - полный путь запроса до ручки API со всеми параметрами;
- Токен авторизации - API-токен пользователя;
- Частоту отправки запросов - рекомендуем устанавливать частоту запросов не чаще 1 раза в минуту.
-
Убедитесь в получении метрик в формате Prometheus от ПО WebmonitorX WAF.
К выгрузке доступны все метрики, указанные в документации WMX с метками:
- customer_id - идентификатор Аккаунта заказчика на Платформе;
- app_id - идентификатор приложения в личном кабинете ПО WebmonitorX, совпадает с идентификатором объекта облачный WAF на Платформе;
- client_uuid - идентификатор экземпляра ПО WAF WebmonitorX на Платформе.
Например, метрики в формате Prometheus в сочетании с меткой
app_id, позволяют настраивать на своей стороне мониторинг трафика в разрезе по доменам. Чтобы настроить такой мониторинг для ПО WAF WebmonitorX на Платформе, требуется обслуживание каждого домена на отдельной Сервисной конфигурации и использование в качестве источника данных объекта облачный WAF с типом ПО WebmonitorX. Меткаapp_idпри этом позволяет фильтровать метрики веб-ресурсов по доменам.
Доступ к ручке API с метриками появляется сразу после включения сервисов Cloud WAF и Real-time Analytics в аккаунте, однако, до тех пор пока не будет настроен объект облачный WAF ручка API будет отдавать нулевые значения.
3. В своём инструменте мониторинга своей инфраструктуры c Prometheus настройте необходимые вам графики и оповещения¶
При обработке запроса к API и получении данных по запросу возможна задержка до двух минут.