Formulador e Validador de Consultas PromQL

Formatar e validar consultas PromQL do Prometheus instantaneamente

O PromQL Query Formatter & Validator organiza as consultas que você escreve contra o Prometheus e outros bancos de dados compatíveis de séries temporais. Cole uma expressão métrica e a ferramenta normaliza os espaços ao redor de operadores binários, organiza agregações, chamadas de função e correspondências de rótulos em linhas separadas quando a consulta se torna longa, e aponta erros sintáticos como parênteses desbalanceados, chaves incorretas, faltas de duração e outros problemas antes de você colar a consulta em um painel ou regra de alerta. Tudo é executado localmente no seu navegador, então as consultas — que muitas vezes revelam nomes internos de métricas e rótulos — nunca deixam seu dispositivo.

Como usar

1. Cole sua consulta PromQL na área de entrada ou carregue um .promql ou arquivo de texto usando o seletor de arquivo.
2. Escolha a largura da indentação — 2 espaços, 4 espaços ou um caractere literal de tab — para qualquer expansão em múltiplas linhas.
3. Defina o comprimento máximo de linha. Chamadas de função, conjuntos de correspondência de rótulos e operadores booleanos de baixa precedência (and, or, unless) são quebradas em linhas separadas quando a linha formatada ultrapassar essa largura.
4. Alternar Sempre quebre se você quiser que cada agregação, lista de argumentos de chamada de função e conjunto de correspondência de rótulos esteja em uma linha separada, independentemente do comprimento.
5. Alternar Envolver como regra de registro e forneça um nome de métrica (como job:http_errors:rate5m) para emitir a consulta formatada como uma regra de registro pronta para colar em YAML do Prometheus.
6. Copie a saída formatada ou baixe-a como um .promql arquivo.

Características

• Espaçamento consciente ao PromQL – Insere um espaço único ao redor de operadores aritméticos, de comparação e booleanos, mantendo os rótulos de correspondência compactos dentro { } chaves.
• Layout inteligente em múltiplas linhas – Quebra consultas longas em and / or / unless primeiro, depois em limites de argumentos de função, depois em correspondências individuais de rótulos, para manter o resultado fácil de escanear.
• Suporte a agregação e correspondência de vetores – Reconhece sum, avg, topk, quantile e amigos juntos com by, without, on, ignoring, group_left e group_right modificadores.
• Tokenizador de duração e subconsulta – Analisa intervalos compostos como 1h30m e subconsultas como [5m:1m] como unidades únicas, para que nunca sejam divididas no meio de um token.
• Validação de sintaxe – Detecta parênteses, colchetes e chaves desbalanceados, abertos e fechados incorretos, corpos de correspondência de rótulos inválidos, intervalos de subíndice inválidos e strings não terminadas, cada um relatado com um número de linha.
• Exportação de regra de registro – Opcionalmente envolve a consulta formatada como um bloco de regra de registro do Prometheus em YAML, usando um escalar de bloco YAML para expressões multilinhas para preservar a indentação.

Casos de uso comuns

• Limpeza de consultas PromQL ad-hoc copiadas de editores de painéis do Grafana antes de commit-las para painéis ou regras de alerta.
• Preparação de expressões PromQL para revisão de código — consultas longas de taxa de erro ou saturação tornam-se diffs legíveis uma vez que cada ramo está em uma linha separada.
• Detecção de erros sintáticos sutis (falta de duração, vírgula estranha, parêntese não fechado { após edição de correspondências de rótulos) sem necessidade de passar pela instância do Prometheus ativa.
• Conversão de consultas brutas em YAML de regra de registro do Prometheus para pipelines de pré-agregação.
• Ensinar PromQL — a saída normalizada torna a precedência dos operadores e o agrupamento de agregações imediatamente evidentes para leitores aprendendo a linguagem.