Форматировщик и проверщик запросов PromQL

Мгновенное форматирование и проверка запросов PromQL

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

Как использовать

1. Вставьте свой запрос PromQL в область ввода или загрузите .promql или текстовый файл с помощью выбора файла.
2. Выберите ширину отступа — 2 пробела, 4 пробела или буквальный символ табуляции — для любых расширений на несколько строк.
3. Установите максимальную длину строки. Вызовы функций, наборы совпадений меток и низкоквалифицированные логические операторы (and, or, unless) переносятся на отдельные строки, если длина отформатированной строки превышает заданную ширину.
4. Переключать Всегда разбивайте если вы хотите, чтобы каждая агрегация, список аргументов функции и набор совпадений меток находились на отдельной строке независимо от длины.
5. Переключать Переносить как правило записи и предоставьте имя метрики (например, job:http_errors:rate5m) для вставки отформатированного запроса как готового к вставке правила записи Prometheus в формате YAML.
6. Скопируйте отформатированный результат или скачайте его как .promql файл.

Возможности

• Сознательное расстояние между элементами — добавляет один пробел вокруг арифметических, сравнительных и логических операторов, сохраняя совпадения меток внутри { } скобок.
• Умное форматирование на нескольких строках — разбивает длинные запросы на and / or / unless первое, затем на границы аргументов функции, затем на отдельные совпадения меток, чтобы результат оставался легко сканируемым.
• Поддержка агрегации и векторных совпадений — распознаёт sum, avg, topk, quantile и подобные элементы вместе с by, without, on, ignoring, group_left и group_right модификаторами.
• Токенизатор длительности и подзапросов — разбирает составные временные интервалы, такие как 1h30m и подзапросы, такие как [5m:1m] как единые единицы, чтобы они не разрывались на части.
• Проверка синтаксиса — обнаруживает несбалансированные скобки, скобки и фигурные скобки, несоответствующие открывающие и закрывающие скобки, неверные тела совпадений меток, неверные диапазоны индексов и незавершённые строки, каждый из которых указывается с номером строки.
• Экспорт правила записи — опционально переносит отформатированный запрос как блок правила записи Prometheus в формате YAML, используя литеральный блок скаляр для многострочных выражений, чтобы сохранить отступы.

Распространенные случаи использования

• Очистка временных запросов, скопированных из редакторов панелей Grafana, до их вставки в дашборды или правила оповещения.
• Подготовка выражений PromQL для проверки кода — длинные запросы по ошибочному или насыщению становятся легко читаемыми изменениями, когда каждый ветвь находится на отдельной строке.
• Обнаружение тонких синтаксических ошибок (отсутствующий временной интервал, лишняя запятая, незакрытый { после редактирования совпадений меток) без необходимости проходить через рабочий экземпляр Prometheus.
• Преобразование сырого запроса в YAML правила записи Prometheus для предварительных потоков агрегации.
• Обучение PromQL — нормализованный вывод делает операторы приоритета и группировку агрегаций очевидными для читателей, изучающих язык.