Entiende cualquier consulta de PromQL.

El PromQL Explainer es una herramienta gratuita, que funciona en el navegador, que toma una consulta PromQL de Prometheus y la descompone en una explicación en lenguaje claro. Recorre cada parte de la expresión —el selector de métrica y sus emparejadores de etiquetas, cualquier rango u offset, el rate o la agregación que lo envuelve, y la comparación de umbral al final— para que puedas leer lo que una consulta hace realmente sin analizarla mentalmente.

No. El explainer se ejecuta 100% en el lado del cliente. Tu consulta se analiza y se explica dentro de la pestaña de tu navegador: nada se sube a un servidor, y no hay cuenta ni registro. Puedes pegar con seguridad consultas que hagan referencia a nombres internos de métricas o etiquetas.

El explainer cubre los patrones que encuentras con más frecuencia en alertas y paneles: selectores de vectores instantáneos y de rango con emparejadores de etiquetas (=, !=, =~, !~), duraciones de rango y offsets, rate / irate / increase, los operadores de agregación (sum, avg, max, min, count y compañía) con agrupación by / without, funciones comunes como histogram_quantile y clamp, y comparaciones binarias contra un umbral. Las subconsultas exóticas o profundamente anidadas pueden resumirse en lugar de descomponerse por completo.

Prometheus te dice el resultado de una consulta; el explainer te dice su significado. No se conecta a un servidor de Prometheus ni devuelve datos de series temporales: lee la propia expresión y describe su intención. Eso lo hace útil para revisar la regla de alerta de un compañero, aprender PromQL o comprobar la cordura de una consulta antes de publicarla.

Sí. Como cada cláusula se nombra y describe, el explainer también sirve como apoyo didáctico: pega un ejemplo de un runbook o un panel y lee de qué selector, rango, agregación y comparación está construido exactamente. Combínalo con la documentación oficial de consultas de Prometheus para la gramática formal.

No. Es una herramienta independiente y comunitaria, y no está afiliada ni respaldada por el proyecto Prometheus ni por la Cloud Native Computing Foundation. Prometheus es una marca registrada de The Linux Foundation. La herramienta modela la sintaxis de PromQL por familiaridad y usa el nombre del proveedor solo para describir lo que explica.

rate() calcula la tasa media de incremento por segundo de un contador a lo largo de la ventana de rango; por ejemplo, rate(http_requests_total[5m]) promedia el incremento por segundo durante los cinco minutos completos. Suaviza los picos y es la opción estándar para métricas de contador y reglas de alerta. El explainer identifica rate() y nombra la duración del rango para que puedas leer la ventana de un vistazo.

rate() promedia el incremento por segundo a lo largo de todo el vector de rango, produciendo valores estables que se adaptan a las alertas y a los contadores de movimiento lento. irate() usa solo las dos últimas muestras de la ventana, lo que lo hace más reactivo pero más ruidoso: lo mejor es reservarlo para graficar contadores de movimiento rápido donde quieras ver picos breves. El explainer etiqueta el que aparezca en tu consulta y describe su comportamiento.

Los corchetes con una duración definen un vector de rango: le indican a PromQL que devuelva todas las muestras de cada serie coincidente durante esa ventana de retrospección. [5m] significa los últimos cinco minutos de datos. Funciones como rate(), increase() y avg_over_time() requieren un vector de rango como entrada, así que los corchetes son lo que hace que esas funciones funcionen.

Las llaves contienen una lista separada por comas de emparejadores de etiquetas que filtran qué series temporales se seleccionan. El operador = coincide con un valor exacto, != lo excluye, =~ coincide por expresión regular y !~ excluye por expresión regular. Así que {job="api", status!="200"} selecciona las series del job api descartando cualquiera con un estado HTTP 200. El explainer nombra cada emparejador y su operador en lenguaje claro.