Documentation
Table of Contents
18 Prometheus проверки
Обзор
Zabbix может запрашивать метрики, которые представлены в формате строк Prometheus.
Чтобы начать сбор данных Prometheus, необходимо выполнить два шага:
- Основной HTTP элемент данных, указывающий на соответствующую конечную точку, например,
https://<хост_prometheus>/метрики - зависимые элементы данных, которые используют опцию Prometheus предобработки, для запроса данных с метрик, полученных основным элементом данных
Имеется две опции предобработки Prometheus данных:
- Prometheus шаблон - используется в обычных элементах данных для запроса Prometheus данных
- Prometheus в JSON - используется в обычных и элементах данных и для низкоуровневого обнаружения. В этом случае запрошенные Prometheus данные возвращаются в JSON формате.
Настройка
При условии, что у вас уже есть настроенный основной элемент данных HTTP, вам необходимо создать зависимый элемент данных, который будет использовать шаг Prometheus предобработки:
- введите общие параметры зависмому элементу данных в диалоге настройки
- перейдите на вкладку Предобработка
- выберите опцию Prometheus предобработки (Prometheus шаблон или Prometheus в JSON)
| Параметр | Описание | Примеры |
|---|---|---|
| Шаблон | Чтобы задать требуемый шаблон данных вы можете использовать язык запросов, походий на Prometheus язык запросов (смотрите таблицу сравнения), e.g.: <имя метрики> - выбор по имени метрики {__имя__="<имя метрики>"} - выбор по имени метрики {__имя__=~"<рег. выражение>"} - выбор по имени метрики соответствующей регулярному выражению {<имя метки>="<значение метки>",...} - выбор по имени метки {<имя метки>=~"<рег. выражение>",...} - выбор по имени метки соответствующей регулярному выражению {__имя__=~".*"}==<значение> - выбор по значению метрики Или комбинация всего выше обозначенного: <имя метрики>{<имя метки1>="<значение метки1>",<имя метки2>=~"<рег. выражение>",...}==<значение> Значением метки может быть любая последовательность UTF-8 символов, но обратная косая черта, двойные кавычки и символы перевода строки необходимо экранировать следующим образом \\, \" и \n соответственно; другие символы не должны быть экранированы. |
wmi_os_physical_memory_free_bytes cpu_usage_system{cpu="cpu-total"} cpu_usage_system{cpu=~".*"} cpu_usage_system{cpu="cpu-total",host=~".*"} wmi_service_state{name="dhcp"}==1 wmi_os_timezone{timezone=~".*"}==1 |
| Вывод | Задается имя метки (опционально). В этом случае возвращается значение, которое соответствует имени метки. Это поле доступно только для опции Prometheus шаблон. |
|
Prometheus в JSON
Данные с Prometheus можно использовать для низкоуровневого обнаружения. В этом случае требуются данные в JSON формате и, как раз, в этом формате данных возвращает опция предобработки Prometheus в JSON.
Для получения более подробных сведений смотрите Обнаружение с использованием Prometheus данных.
Сравнение языков запросов
Следующая таблица перечисляет различия и сходства между языками запросов PromQL и Zabbix Prometheus предобработкой.
| PromQL instant vector selector | Zabbix Prometheus предобработка | |
|---|---|---|
| Различия | ||
| Цель запроса | Prometheus сервер | Простой текст в формате толкования Prometheus |
| Возвращает | Instant vector | Метрика или значение метки (Prometheus шаблон) Массив метрик для одного значения в JSON (Prometheus в JSON) |
| Операторы соответствия меткам | =, !=, =~, !~ | =, =~ |
| Регулярные выражения используемые поиске соответствия в метках или именах метрик | RE2 | PCRE |
| Операторы сравнения | Смотрите список | Для фильтрации значений поддерживается только == (равно) |
| Сходства | ||
| Выбор по имени метрики, которое равно строке | <имя метрики> или {__имя__="<имя метрики>"} | <имя метрики> или {__имя__="<имя метрики>"} |
| Выбор по имени метрики, которое соответствует регулярному выражению | {__имя__=~"<рег. выражение>"} | {__имя__=~"<рег. выражение>"} |
| Выбор значения по <имени метки>, которое равно строке | {<имя метки>="<значение метки>",...} | {<имя метки>="<значение метки>",...} |
| Выбор значения по <имени метки>, которое соответствует регулярному выражению | {<имя метки>=~"<рег. выражение>",...} | {<имя метки>=~"<рег. выражение>",...} |
| Выбор по значению, которое равно строке | {__имя__=~".*"} == <значение> | {__имя__=~".*"} == <значение> |