Registros y observabilidad

formateador PromQLComprueba la expresión antes del gráfico

Pega una consulta para analizarla; usa las muestras para etiquetas y el modo RE2 para patrones. No se ejecutan consultas de series temporales.

formateador PromQL

Expresión PromQL

Resultado

Se procesa en el navegador: no se conecta a Prometheus ni envía consultas.

Opciones

Escribe una expresión o carga un ejemplo.

Un gráfico vacío puede deberse a la sintaxis, a las etiquetas o a los datos. formateador PromQL permite separar el texto de la consulta de la pregunta concreta de qué muestras locales selecciona.

La consulta original permanece en la entrada. El formato solo cambia espacios en límites reconocidos por el analizador, para que compares antes de llevarla a una alerta.

Por qué usar formateador PromQL

Tres comprobaciones relacionadas con resultados que significan cosas distintas.

Ver qué muestra pasa el selector

formateador PromQL aplica un selector puro a cada métrica pegada. Con status=~"5..", 500 y 503 coinciden y 200 no; son tus muestras, no series recuperadas del servidor.

Un selector acepta dos métricas de muestra y descarta otra por las etiquetas status y job

Usar el mismo tipo de regex que Prometheus

RE2 compara el valor completo de la etiqueta, sin aproximarlo con RegExp de JavaScript. formateador PromQL rechaza las referencias inversas y las búsquedas alrededor no compatibles.

Un patrón RE2 anclado coincide con 500 entero pero no con una parte de 1500

Tres pasos para aislar el problema

Analizar una expresión completa no equivale a evaluar datos reales.

01

Empieza por la sintaxis completa

En el modo PromQL se muestra la línea y columna de un paréntesis o llave defectuosos. Una consulta inválida no produce una supuesta corrección descargable.

02

Extrae después el selector

Usa algo como http_requests_total{job="api"} y pega una métrica con etiquetas por línea. Si añades un número final, no participa en la comparación.

03

Prueba el patrón sobre valores enteros

En RE2 escribe un valor por línea. 5.. coincide con 500, pero no con el fragmento interno de 1500.

Qué dicen las comprobaciones locales

La estructura, las etiquetas y la regex se presentan por separado.

Sintaxis y árbol de PromQL

El formateador de consultas PromQL muestra una versión conservadora y el árbol sintáctico. Un error o un resultado antiguo impide exportar.

Coincidencia de etiquetas

El selector de etiquetas PromQL combina =, !=, =~ y !~ en cada muestra. Una etiqueta ausente cuenta como cadena vacía y se identifica cuál falló.

RE2 con coincidencia completa

Una regex PromQL usa RE2 y se aplica a todo el valor. Las construcciones exclusivas de JavaScript no se aceptan como si fueran Prometheus.

Límites antes de reutilizar la consulta

Una expresión bien formada no prueba que exista la métrica buscada.

Sin ejecución de series temporales
formateador PromQL no consulta una TSDB ni la API de Prometheus. No conoce métricas, valores, cardinalidad o gráficas de tu instalación.
Solo selectores puros sobre muestras
rate(), sum by, uniones y consultas de rango requieren datos reales. El modo de muestras solo filtra etiquetas; el modo PromQL analiza el texto completo.
Errores sin reparación inventada
Si RE2 o el analizador rechazan la entrada, no se exporta un arreglo supuesto. Al cambiar la entrada también se bloquea el resultado anterior.

Preguntas frecuentes sobre formateador PromQL

Dudas de búsquedas sobre ejemplos, agregación y regex PromQL.

¿Dónde puedo ver ejemplos de PromQL?

Carga el ejemplo de formateador PromQL para inspeccionar una expresión con rate y sum by. La herramienta muestra su estructura, pero no ejecuta la consulta ni genera series.

¿Cómo funciona PromQL group by aquí?

El análisis reconoce la estructura de agrupación. Calcular los grupos requiere una base de series temporales; las muestras locales solo prueban selectores.

¿Sirve una regex PromQL para buscar dentro de una etiqueta?

La comparación de etiquetas usa RE2 anclado al valor completo. 5.. coincide con 500, no con una parte de 1500.

¿Qué comprueba PromQL absent en esta página?

Puede analizarse la sintaxis de la función absent, pero su resultado depende de series existentes. No se infiere ausencia real a partir de unas muestras pegadas.

¿Puedo calcular PromQL sum by con este formulario?

No. La agregación necesita muestras temporales reales. El formulario local solo puede mostrar la estructura y comparar un selector puro con etiquetas.

¿Encontraste un caso límite de PromQL?

Prueba formateador PromQL con tu consulta

formateador PromQL separa el análisis sintáctico, el selector sobre muestras y la regex RE2 antes de usar una expresión en una alerta o panel.

Si cambias el texto, espera la nueva comprobación antes de copiar o descargar.