Traduza entre LogQL e PromQL.

Ele traduz os formatos comuns de consultas de métricas entre o LogQL do Grafana Loki e o PromQL do Prometheus, nos dois sentidos. Cole uma consulta, escolha uma direção e o ajudante reescreve os seletores, as funções de intervalo e as agregações para a outra linguagem — e então sinaliza tudo o que não pode ser convertido de forma limpa. Ele funciona inteiramente no seu navegador, sem conta e sem upload.

Não. O ajudante é 100% no lado do cliente. Suas consultas são analisadas e reescritas dentro da aba do seu navegador — nada é enviado para um servidor e não há cadastro. Você pode colar com total segurança nomes de labels internos, namespaces e identificadores de serviços.

Não, e o ajudante deixa isso claro. LogQL e PromQL compartilham a mesma gramática de seletores e agregações para consultas de métricas, então formatos como rate(), count_over_time(), sum by (…) e comparações de limite são traduzidos bem. Mas as consultas de logs do LogQL — filtros de linha como |= "error", label_format, line_format e os analisadores de padrão ou expressão regular — não têm equivalente em PromQL, porque o PromQL só enxerga amostras já agregadas. Essas partes são informadas como notas em vez de descartadas silenciosamente.

Os seletores de labels ({app="checkout", env=~"prod|stage"}), as funções de vetor de intervalo (rate, irate, increase, *_over_time), os operadores de agregação (sum, avg, max, min, count, topk) com agrupamento by/without e as comparações binárias ou de limite compartilham uma sintaxe quase idêntica. O ajudante converte tudo isso diretamente e mantém intactos os nomes dos seus labels e suas durações.

As equipes costumam usar Loki e Prometheus ao mesmo tempo e querem que uma métrica já validada em um exista também no outro — por exemplo, transformar uma taxa de erros derivada de logs no Loki em um formato de recording rule sobre o qual possam raciocinar comparando com as métricas do Prometheus, ou portar um limite de alerta do PromQL para um equivalente em LogQL sobre um fluxo de logs. O ajudante te dá um primeiro rascunho rápido mais uma lista clara do que vale conferir com atenção.

O PromQL consulta métricas numéricas já agregadas armazenadas no Prometheus; o LogQL consulta fluxos de logs no Grafana Loki e pode derivar métricas deles em tempo de consulta. Ambos compartilham uma sintaxe de seletores de labels idêntica e os mesmos operadores de agregação (sum, avg, max), mas o LogQL adiciona uma pipeline final de filtros e analisadores — separados por | — que não tem contrapartida em PromQL. A diferença está no modelo de dados: amostras numéricas versus linhas de log em estado bruto.

Mantenha os seletores de labels como estão — os seletores de fluxo do LogQL usam a mesma sintaxe {label="value"}. Depois, envolva o seletor em uma agregação de intervalo como rate(), count_over_time() ou sum_over_time() e adicione um intervalo como [5m]. Como o Loki não tem séries de métricas preexistentes, você também precisará apontar o seletor para um fluxo de logs real e, com frequência, adicionar uma etapa de análise (| json ou | logfmt) para extrair os labels pelos quais você quer agrupar.

As funções que pressupõem séries instrumentadas preexistentes não se traduzem diretamente. histogram_quantile não tem contrapartida direta em LogQL (em vez dela, você precisaria de quantile_over_time com um label desempacotado). irate() é aproximado por rate() em LogQL, já que o Loki não tem uma função equivalente de taxa instantânea. A correspondência binária de vetores do PromQL sobre pares de métricas também é mais limitada em LogQL, que opera sobre fluxos de logs em vez de séries numéricas.

Sim. O LogQL foi modelado deliberadamente com base no PromQL: os seletores de fluxo usam a sintaxe {label="value"} idêntica e as consultas de métricas do LogQL reutilizam os mesmos operadores de agregação — sum, avg, max, topk, by/without. A adição principal é a pipeline de logs para filtrar e analisar linhas de log em estado bruto, de modo que engenheiros já familiarizados com PromQL conseguem ler as consultas de métricas do LogQL com um ajuste mínimo.

Não. Esta é uma ferramenta independente e comunitária, e não é afiliada nem endossada pelo Grafana Labs nem pelo projeto Prometheus. Loki e Grafana são marcas registradas da Raintank, Inc.; Prometheus é marca registrada da The Linux Foundation. Os nomes dos fornecedores são usados apenas para descrever as linguagens de consulta que o ajudante traduz.