Consultas y condiciones

Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana.

Para ver los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte. Trabajando en Grafana versión 9

Para ver los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte. Trabajando en Grafana versión 8

En Grafana, las consultas desempeñan un papel fundamental a la hora de obtener y transformar datos de fuentes de datos compatibles, que incluyen bases de datos como MySQL y PostgreSQL, bases de datos de series temporales como Prometheus, InfluxDB y Graphite, y servicios como Amazon, Azure Monitor y Google Cloud Monitoring. OpenSearch CloudWatch

Para obtener más información sobre las fuentes de datos compatibles, consulte. Fuentes de datos y alertas de Grafana

El proceso de ejecución de una consulta implica definir la fuente de datos, especificar los datos que se desean recuperar y aplicar los filtros o transformaciones pertinentes. Para crear estas consultas se utilizan lenguajes de consulta o sintaxis específicos de la fuente de datos elegida.

En las alertas, se define una consulta para obtener los datos que se desean medir y una condición que debe cumplirse antes de que se active una regla de alerta.

Una regla de alerta consta de una o más consultas y expresiones que seleccionan los datos que se desean medir.

Para obtener más información sobre consultas y expresiones, consulteConsulta y transforma datos.

Consultas de fuentes de datos

Las consultas en Grafana se pueden aplicar de varias maneras, según la fuente de datos y el lenguaje de consulta que se utilice. El editor de consultas de cada fuente de datos proporciona una interfaz de usuario personalizada que le ayuda a escribir consultas que aprovechen sus capacidades únicas.

Debido a las diferencias entre los lenguajes de consulta, cada editor de consultas de fuentes de datos tiene un aspecto y un funcionamiento diferentes. Según la fuente de datos, el editor de consultas puede proporcionar funciones de autocompletado, nombres de métricas, sugerencias de variables o una interfaz visual de creación de consultas.

Algunos tipos comunes de componentes de consulta incluyen:

Métricas o campos de datos: especifique las métricas o los campos de datos específicos que desea recuperar, como el uso de la CPU, el tráfico de red o las lecturas de los sensores.

Rango de tiempo: defina el rango de tiempo para el que desea obtener datos, como la última hora, un día específico o un rango de tiempo personalizado.

Filtros: aplique filtros para restringir los datos en función de criterios específicos, como filtrar los datos por una etiqueta, un host o una aplicación específicos.

Agregaciones: realice agregaciones de los datos para calcular métricas como promedios, sumas o recuentos durante un período de tiempo determinado.

Agrupación: agrupe los datos por dimensiones o etiquetas específicas para crear vistas agregadas o desgloses.

nota

Grafana no admite consultas de alertas con variables de plantilla. Hay más información disponible aquí en los foros de Grafana Labs.

Consultas de expresión

En Grafana, una expresión se utiliza para realizar cálculos, transformaciones o agregaciones en los datos consultados de la fuente de datos. Permite crear métricas personalizadas o modificar las métricas existentes en función de operaciones matemáticas, funciones o expresiones lógicas.

Al aprovechar las consultas de expresión, los usuarios pueden realizar tareas como calcular el cambio porcentual entre dos valores, aplicar funciones como las funciones logarítmicas o trigonométricas, agregar datos en intervalos de tiempo o dimensiones específicos e implementar la lógica condicional para gestionar diferentes escenarios.

En Alerting, solo puedes usar expresiones para las reglas de alerta gestionadas por Grafana. Para cada expresión, puedes elegir expresiones matemáticas, reducir y volver a muestrear. Se denominan reglas multidimensionales porque generan una alerta independiente para cada serie.

También puede usar una condición clásica, que crea una regla de alerta que activa una sola alerta cuando se cumple su condición. Como resultado, Grafana envía una sola alerta incluso cuando se cumplen las condiciones de alerta para varias series.

nota

Las condiciones clásicas existen principalmente por motivos de compatibilidad y, si es posible, deben evitarse.

Reducir

Agrega los valores de las series temporales del rango de tiempo seleccionado en un solo valor.

Math (Matemática)

Realiza funciones/operaciones matemáticas de formato libre sobre series temporales y datos numéricos. Se puede utilizar para preprocesar datos de series temporales o para definir una condición de alerta para datos numéricos.

Remuestrear

Realinea un rango de tiempo con un nuevo conjunto de marcas temporales, lo que resulta útil cuando se comparan datos de series temporales de diferentes fuentes de datos en las que, de otro modo, las marcas temporales no se alinearían.

Threshold

Comprueba si algún dato de la serie temporal coincide con la condición de umbral.

La expresión de umbral permite comparar dos valores individuales. Vuelve 0 cuando la condición es falsa y 1 si es verdadera. Están disponibles las siguientes funciones de umbral:

• Está por encima de (x > y)

• Está por debajo de (x < y)

• Está por debajo de (x y1 Y x < y2)

• < y1 AND x >Está fuera del rango (x y2)

Condición clásica

Comprueba si algún dato de la serie temporal coincide con la condición de alerta.

nota

Las consultas de expresiones de condición clásicas siempre generan solo una instancia de alerta, independientemente del número de series temporales que cumplan la condición. Las condiciones clásicas existen principalmente por motivos de compatibilidad y, si es posible, deben evitarse.

Agregaciones

Grafana Alerting proporciona las siguientes funciones de agregación para que pueda refinar aún más su consulta.

Estas funciones solo están disponibles para las expresiones de condición Reduce y Classic.

Función	Expression	¿Qué hace?
avg	Reduce//Classic	Muestra el promedio de los valores
min	Reducir//Clásico	Muestra el valor más bajo
max	Reducir/Clásico	Muestra el valor más alto
sum	Reducir//Clásico	Muestra la suma de todos los valores
count	Reducir//Clásico	Cuenta el número de valores del resultado
last	Reducir/Clásico	Muestra el último valor
median	Reducir/Clásico	Muestra el valor medio
diferencia	Classic	Muestra la diferencia entre el valor más reciente y el más antiguo
diff_abs	Classic	Muestra el valor absoluto de diff
percent_diff	Classic	Muestra el valor porcentual de la diferencia entre el valor más reciente y el más antiguo
percent_diff_abs	Classic	Muestra el valor absoluto de percent_diff
count_non_null	Classic	Muestra un recuento de los valores del conjunto de resultados que no lo son null

Condición de alerta

Una condición de alerta es la consulta o expresión que determina si la alerta se activará o no en función del valor que arroje. Solo puede haber una condición que determine la activación de la alerta.

Una vez definidas las consultas o expresiones, elija una de ellas como condición de la regla de alerta.

Cuando los datos consultados cumplen la condición definida, Grafana activa la alerta asociada, que se puede configurar para enviar notificaciones a través de varios canales como el correo electrónico, Slack o. PagerDuty Las notificaciones le informan sobre la condición que se cumple, lo que le permite tomar las medidas adecuadas o investigar el problema subyacente.

De forma predeterminada, la última expresión añadida se utiliza como condición de alerta.

Umbral de recuperación

Para reducir el ruido de las alertas que parpadean, puedes establecer un umbral de recuperación diferente del umbral de alerta.

Las alertas fluctuantes se producen cuando una métrica se sitúa cerca de la condición de umbral de alerta y pueden provocar cambios de estado frecuentes, lo que provoca la generación de demasiadas notificaciones.

Las reglas de alerta gestionadas por Grafana se evalúan durante un intervalo de tiempo específico. Durante cada evaluación, el resultado de la consulta se compara con el umbral establecido en la regla de alerta. Si el valor de una métrica supera el umbral, se activa una regla de alerta y se envía una notificación. Cuando el valor cae por debajo del umbral y hay una alerta activa para esta métrica, la alerta se resuelve y se envía otra notificación.

Crear una regla de alerta para una métrica ruidosa puede resultar complicado. Es decir, cuando el valor de una métrica está continuamente por encima y por debajo de un umbral. Esto se denomina inestabilidad y da como resultado una serie de notificaciones de activación (resueltas) y un historial de estados de alerta ruidosos.

Por ejemplo, si tienes una alerta de latencia con un umbral de 1000 ms y el número fluctúa alrededor de 1000 (por ejemplo, 980 ->1010 -> 990 -> 1020, etc.), cada una de ellas activará una notificación.

Para solucionar este problema, puedes establecer un umbral de recuperación (personalizado), que básicamente significa tener dos umbrales en lugar de uno. Se activa una alerta cuando se cruza el primer umbral y se resuelve solo cuando se cruza el segundo umbral.

Por ejemplo, puede establecer un umbral de 1000 ms y un umbral de recuperación de 900 ms. De esta forma, una regla de alerta solo dejará de activarse cuando pase por debajo de los 900 ms y se reduzca el aleteo.