Configurar las reglas de alertas gestionadas de Grafana

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

Las reglas gestionadas por Grafana son el tipo de regla de alerta más flexible. Le permiten crear alertas que pueden actuar sobre los datos de cualquiera de nuestras fuentes de datos compatibles. Además de admitir varias fuentes de datos, también puede añadir expresiones para transformar sus datos y establecer condiciones de alerta. También se admite el uso de imágenes en las notificaciones de alerta. Este es el único tipo de regla que permite enviar alertas desde varias fuentes de datos en una sola definición de regla.

Se pueden crear varias instancias de alerta como resultado de una regla de alerta (también conocida como alerta multidimensional).

Las reglas de alertas administradas de Grafana solo las pueden editar o eliminar los usuarios con permisos de edición para la carpeta que almacena las reglas.

Si eliminas un recurso de alertas creado en la interfaz de usuario, ya no podrás recuperarlo. Para hacer una copia de seguridad de tu configuración y poder restaurar los recursos de alertas eliminados, crea tus recursos de alertas con Terraform o la API de alertas.

En los siguientes procedimientos, realizaremos el proceso de creación de sus reglas de alerta gestionadas por Grafana.

Para crear una regla de alerta gestionada por Grafana, utiliza el flujo de creación de alertas en el espacio de trabajo y sigue estos pasos para ayudarte.

Establece el nombre de la regla de alerta

1. Seleccione Alertas e IRM -> Reglas de alerta -> + Nueva regla de alerta.

2. Introduzca un nombre para identificar su regla de alerta.

   Este nombre aparece en la lista de reglas de alerta. También es la alertname etiqueta de cada instancia de alerta que se crea a partir de esta regla.

A continuación, defina una consulta para obtener los datos que desea medir y una condición que debe cumplirse antes de que se active una regla de alerta.

Para definir la consulta y la condición

1. Seleccione una fuente de datos.

2. En el menú desplegable Opciones, especifique un intervalo de tiempo.

   nota

   Grafana Alerting solo admite rangos de tiempo relativos fijos, por ejemplo,. now-24hr: now

   No admite rangos de tiempo absolutos: 2021-12-02 00:00:00 to 2021-12-05 23:59:592 o rangos de tiempo semirrelativos:. now/d to: now

3. Añadir una consulta.

   Para añadir varias consultas, selecciona Añadir consulta.

   Grafana gestiona todas las reglas de alerta de forma predeterminada. Si desea cambiar a una regla de alerta administrada por una fuente de datos, haga clic en Cambiar a una regla de alerta administrada por una fuente de datos.

4. Añada una o más expresiones.

   1. Para cada expresión, seleccione la condición clásica para crear una única regla de alerta o elija entre las opciones Matemáticas, Reducir y Remuestrear para generar una alerta independiente para cada serie.

      nota

      Al usar Prometheus, puede usar un vector instantáneo y funciones integradas, por lo que no necesita agregar expresiones adicionales.

   2. Selecciona Vista previa para comprobar que la expresión es correcta.

5. [Opcional] Para añadir un umbral de recuperación, active la opción Umbral de recuperación personalizado e introduzca un valor para indicar cuándo debe dejar de funcionar la regla de alerta.

   Solo puedes añadir un umbral de recuperación en una consulta y debe ser la condición de alerta.

6. Elija Establecer como condición de alerta en la consulta o expresión que desee establecer como condición de alerta.

Utilice la evaluación de reglas de alerta para determinar con qué frecuencia debe evaluarse una regla de alerta y con qué rapidez debe cambiar su estado.

Para ello, debe asegurarse de que la regla de alerta se encuentra en el grupo de evaluación correcto y establecer un período de tiempo pendiente que se adapte mejor a su caso de uso.

Para configurar el comportamiento de evaluación de las alertas

1. Seleccione una carpeta o elija + Nueva carpeta.

2. Seleccione un grupo de evaluación o haga clic en + Nuevo grupo de evaluación.

   Si va a crear un grupo de evaluación nuevo, especifique el intervalo para el grupo.

   Todas las reglas del mismo grupo se evalúan simultáneamente durante el mismo intervalo de tiempo.

3. Introduzca un período pendiente.

   El período pendiente es el período en el que una regla de alerta puede infringir la condición hasta que se active.

   Una vez que se cumple una condición, la alerta pasa al estado Pendiente. Si la condición permanece activa durante el tiempo especificado, la alerta pasa al estado de activación y, de lo contrario, vuelve al estado Normal.

4. Activa las notificaciones de alerta de pausa, si es necesario.

   nota

   Pausa la evaluación de las reglas de alerta para evitar alertas ruidosas mientras ajustas las alertas. La pausa detiene la evaluación de las reglas de alerta y no crea ninguna instancia de alerta. Esto es diferente a los tiempos de silencio, que impiden que se envíen las notificaciones, pero permiten evaluar las reglas de alerta y crear instancias de alerta.

   Puede pausar la evaluación de las reglas de alerta para evitar alertas ruidosas y, al mismo tiempo, ajustar las alertas. La pausa detiene la evaluación de las reglas de alerta y no crea ninguna instancia de alerta. Esto es diferente a los tiempos de silencio, que impiden que se envíen las notificaciones, pero permiten evaluar las reglas de alerta y crear instancias de alerta.

5. En Configurar la gestión de errores y sin datos, configure el comportamiento de las alertas en ausencia de datos.

   Utilice las directrices que aparecen más adelante en esta sección.

Añada etiquetas a sus reglas de alerta para establecer qué política de notificación debe gestionar sus casos de alerta de despido.

Todas las reglas e instancias de alerta, independientemente de sus etiquetas, coinciden con la política de notificaciones predeterminada. Si no hay políticas anidadas o ninguna política anidada coincide con las etiquetas de la regla o instancia de alerta, la política de notificación predeterminada es la política coincidente.

Para configurar notificaciones

1. Agrega etiquetas si quieres cambiar la forma en que se distribuyen las notificaciones.

   Agregue etiquetas personalizadas seleccionando los pares clave-valor existentes en el menú desplegable, o agregue etiquetas nuevas ingresando la nueva clave o valor.

2. Obtenga una vista previa de la configuración de enrutamiento de las instancias de alerta.

   En función de las etiquetas añadidas, las instancias de alerta se redirigen a las políticas de notificación que se muestran.

   Amplíe cada política de notificaciones para ver más detalles.

3. Seleccione Ver detalles para ver los detalles del enrutamiento de las alertas y una vista previa.

Agregue anotaciones para proporcionar más contexto sobre la alerta en su mensaje de notificación de alerta.

Las anotaciones añaden metadatos para proporcionar más información sobre la alerta en el mensaje de notificación de la alerta. Por ejemplo, añada una anotación resumida para indicar qué valor provocó la activación de la alerta o en qué servidor se produjo.

Para añadir anotaciones

1. [Opcional] Agrega un resumen.

   Breve resumen de lo que ocurrió y por qué.

2. [Opcional] Agrega una descripción.

   Descripción de lo que hace la regla de alerta.

3. [Opcional] Agrega una URL de Runbook.

   Página web en la que guardas el directorio de la alerta

4. [Opcional] Agrega una anotación personalizada

5. [Opcional] Agrega un panel y un enlace al panel.

   Vincula las alertas a los paneles de un panel de control.

6. Seleccione Guardar regla.

Regla única y multidimensional

Para las alertas gestionadas por Grafana, puede crear una regla con una condición clásica o puede crear una regla multidimensional.

• Regla con condición clásica

  Utilice la expresión de condición clásica para crear una regla que active una alerta única cuando se cumpla su condición. Para una consulta que devuelve varias series, Grafana no realiza un seguimiento del estado de alerta de cada serie. Como resultado, Grafana envía una sola alerta incluso cuando se cumplen las condiciones de alerta para varias series.

• Regla multidimensional

  Para generar una alerta independiente para cada serie, cree una regla multidimensional. Utilice MathReduce, o Resample expresiones para crear una regla multidimensional. Por ejemplo:

  • Agregue una Reduce expresión para cada consulta para agregar los valores del intervalo de tiempo seleccionado en un solo valor (no es necesario para las reglas que utilizan datos numéricos).

  • Agregue una Math expresión con la condición de la regla. No es necesario si ya se devuelve una consulta o una expresión reducida 0 si la regla no se debe activar, o si se debe activar un número positivo. Algunos ejemplos: $B > 70 si debería activarse en caso de que el valor de la consulta/expresión B sea superior a 70. $B < $C * 100en caso de que se active si el valor de B es menor que el valor de C multiplicado por 100. Si las consultas que se comparan tienen varias series en sus resultados, las series de consultas diferentes coinciden si tienen las mismas etiquetas o si una es un subconjunto de la otra.

nota

Grafana no admite consultas de alertas con variables de plantilla. Hay más información disponible en https://community.grafana.com/t/ template-variables-are-not - supported-in-alert-queries - while-setting-up-alert /2514.

No configure la gestión de datos y errores

Configure el comportamiento de las alertas cuando la evaluación de la regla de alerta no arroje datos o arroje un error.

nota

Las reglas de alerta que están configuradas para activarse cuando una evaluación no devuelve datos o genera un error, solo se activan cuando finaliza todo el período de evaluación. Esto significa que, en lugar de activarse inmediatamente cuando se incumple la condición de la regla de alerta, la regla de alerta espera hasta que finalice el tiempo establecido en el campo Para y, a continuación, se activa, lo que reduce el ruido de la alerta y permite que surjan problemas temporales de disponibilidad de los datos.

Si la evaluación de la regla de alerta no arroja datos, puede configurar el estado de la regla de alerta para que aparezca de la siguiente manera:

Sin datos	Descripción
Sin datos	Crea una nueva alerta DatasourceNoData con el nombre y el UID de la regla de alerta y el UID de la fuente de datos que no devolvió datos como etiquetas.
Alertas	Establece el estado de la regla de alerta en. Alerting La regla de alerta espera hasta que finalice el tiempo establecido en el campo Para antes de disparar.
Ok	Establece el estado de la regla de alerta enNormal.

Si la evaluación arroja un error, puede configurar el estado de la regla de alerta para que aparezca de la siguiente manera:

Error	Descripción
Error	Crea una instancia de alerta DatasourceError con el nombre y el UID de la regla de alerta y el UID de la fuente de datos que no devolvió datos como etiquetas.
Alertas	Establece el estado de la regla de alerta en. Alerting La regla de alerta espera hasta que finalice el tiempo establecido en el campo Para antes de disparar.
Ok	Establece el estado de la regla de alerta enNormal.

Resuelva las instancias de alerta obsoletas

Una instancia de alerta se considera obsoleta si su dimensión o serie ha desaparecido por completo de los resultados de la consulta durante dos intervalos de evaluación.

Las instancias de alerta obsoletas que se encuentran en los Error estados AlertingNoData//se marcan automáticamente como Resolved y la grafana_state_reason anotación se añade a la instancia de alerta con el motivo. MissingSeries

Cree alertas a partir de paneles

Crea alertas desde cualquier tipo de panel. Esto significa que puede reutilizar las consultas del panel y crear alertas en función de ellas.

1. Navegue hasta un panel de control en la sección Paneles de control.

2. En la esquina superior derecha del panel, selecciona los tres puntos (elipses).

3. En el menú desplegable, selecciona Más... y, a continuación, selecciona Nueva regla de alerta.

Se abrirá el formulario de reglas de alerta, que te permitirá configurar y crear tu alerta en función de la consulta del panel actual.