Логи и наблюдаемость

форматирование PromQLСначала проверьте текст запроса

Вставьте выражение для локального разбора или переключитесь на образцы меток и RE2. Реальный запрос к временным рядам не выполняется.

форматирование PromQL

Выражение PromQL

Результат

Обработка идёт в браузере: без подключения к Prometheus и отправки запроса.

Параметры

Введите выражение или загрузите пример.

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

Исходный запрос остаётся видимым. Форматирование меняет пробелы только на распознанных границах синтаксиса, чтобы результат можно было сравнить перед переносом в правило оповещения.

Зачем нужно форматирование PromQL

Три проверки отвечают на разные вопросы и не подменяют выполнение запроса.

Проверьте селектор построчно

форматирование PromQL применяет чистый векторный селектор к вставленным строкам метрик. status=~"5.." выберет 500 и 503, но не 200; живые ряды при этом не загружаются.

Векторный селектор выбирает два образца метрик и отклоняет третий по меткам status и job

Используйте настоящее RE2

Метка сравнивается целиком движком RE2, без приближения на JavaScript RegExp. форматирование PromQL отклоняет обратные ссылки и просмотр вперёд вместо ложного совпадения.

Закреплённый шаблон RE2 совпадает с целым значением 500, но не с частью 1500

Три шага для поиска причины

Разбор полного выражения и фильтрация образцов — разные операции.

01

Разберите выражение целиком

Режим PromQL показывает строку и столбец ошибки скобки или селектора. Неисправное выражение не превращается в якобы готовый файл.

02

Выделите чистый селектор

Введите http_requests_total{job="api"} и вставьте по одной метрике с метками на строку. Число в конце допускается, но не участвует в сравнении.

03

Сверьте всю строку с RE2

В режиме RE2 проверяйте по одному значению на строку. Шаблон 5.. совпадает с 500, но не с фрагментом внутри 1500.

Что показывают локальные результаты

Дерево выражения, метки образцов и регулярное выражение выводятся отдельно.

Синтаксис и структура PromQL

Разбор запроса PromQL даёт осторожно отформатированный текст и дерево. Ошибку показываем на странице; устаревший результат нельзя выгрузить.

Селектор и образцы метрик

Сопоставление меток PromQL объединяет =, !=, =~ и !~. Отсутствующая метка считается пустой строкой; для каждой строки указаны причины несовпадения.

Полное совпадение RE2

Регулярные выражения PromQL используют RE2. Синтаксис обратных ссылок или lookaround отвергается; значение проверяется целиком.

Границы проверки перед экспортом

Верный синтаксис не доказывает наличие метрик в вашей системе.

Без выполнения запроса к данным
форматирование PromQL не подключается к TSDB или API Prometheus. Оно не знает существующие метрики, их значения, число рядов и вид графика в вашей установке.
Только чистый селектор для образцов
rate(), sum by, соединения и диапазонные запросы здесь не вычисляются. Полное выражение можно разобрать, но для фильтрации образцов нужен селектор.
Никакой догадочной правки
Ошибку RE2 или PromQL нельзя обойти автоматической «починкой». После изменения ввода прежний результат сразу перестаёт быть доступен для копирования.

Вопросы про форматирование PromQL

Ответы на запросы о синтаксисе, метках, regex и агрегации.

Что такое PromQL?

Это язык запросов Prometheus для выбора и агрегации временных рядов. форматирование PromQL проверяет текст, но не запускает вычисление на сервере.

Можно ли здесь выполнить запросы PromQL?

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

Как работает PromQL regex для меток?

RE2 сравнивает шаблон со всей строкой метки. 5.. совпадает с 500 и не совпадает с частью значения 1500.

Применяется ли PromQL group by к образцам?

Структуру группировки видно в дереве. Расчёт групп требует настоящих рядов; локальные строки поддерживают только фильтрацию селектором.

Чем отличаются PromQL increase и rate в этом инструменте?

Оба вызова можно проверить как текст. Их числовые результаты вычисляет Prometheus по реальным интервалам, а не эта страница.

Нашли пограничный случай PromQL?

Проверить запрос через форматирование PromQL

форматирование PromQL отдельно показывает синтаксис, совпадения локальных образцов и RE2 до переноса выражения в панель или оповещение.

При изменении текста старый результат недоступен для экспорта до новой проверки.