Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Trabajar con políticas de notificación
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana.
Para ver los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte. Trabajando en Grafana versión 10
Para ver los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte. Trabajando en Grafana versión 9
Las políticas de notificación determinan cómo se envían las alertas a los puntos de contacto. Las políticas tienen una estructura de árbol, en la que cada política puede tener una o más políticas secundarias. Cada política, excepto la política raíz, también puede coincidir con etiquetas de alerta específicas. Cada alerta es evaluada por la política raíz y, después, por cada política secundaria. Si habilita la Continue matching subsequent sibling nodes
opción para una política específica, la evaluación continúa incluso después de una o más coincidencias. Los ajustes de configuración y la información del punto de contacto de una política principal rigen el comportamiento de una alerta que no coincide con ninguna de las políticas secundarias. Una política raíz rige cualquier alerta que no coincida con una política específica.
nota
Puede crear y editar políticas de notificación para las alertas gestionadas por Grafana. Las políticas de notificación de las alertas de Alertmanager son de solo lectura.
Agrupar las notificaciones
La agrupación clasifica las notificaciones de alerta de naturaleza similar en un único embudo. Esto le permite controlar las notificaciones de alerta durante las interrupciones más graves, cuando muchas partes de un sistema fallan al mismo tiempo, lo que provoca que se inicie un gran número de alertas simultáneamente.
Ejemplo de agrupamiento
Supongamos que tiene 100 servicios conectados a una base de datos en diferentes entornos. Estos servicios se diferencian por la etiquetaenv=environmentname
. Existe una regla de alerta para controlar si sus servicios pueden llegar a la base de datos. La regla de alerta crea alertas con un nombrealertname=DatabaseUnreachable
.
Si se produce una partición de red en la que la mitad de los servicios ya no pueden acceder a la base de datos, se inician 50 alertas diferentes. En este caso, querrá recibir una notificación de una sola página (en lugar de 50) con una lista de los entornos afectados.
Puede configurar la agrupación para que sea group_by: [alertname]
(sin utilizar la env
etiqueta, que es diferente para cada servicio). Con esta configuración, Grafana envía una única notificación compacta que incluye todos los entornos afectados por esta regla de alerta.
Grupos especiales
Grafana tiene dos grupos especiales. El grupo predeterminado group_by: null
agrupa todas las alertas en un solo grupo. También puede utilizar una etiqueta especial denominada ...
para agrupar las alertas por todas las etiquetas, lo que desactiva la agrupación y envía cada alerta a su propio grupo.
Uso de notificaciones
Los siguientes procedimientos muestran cómo crear y administrar políticas de notificación.
Para editar la política de notificaciones raíz
-
Desde la consola Grafana, en el menú de Grafana, selecciona el icono de alerta (campana) para abrir la página de alertas.
-
Selecciona Políticas de notificación.
-
En el menú desplegable Alertmanager, selecciona el Alertmanager que deseas editar.
-
En la sección Política raíz, selecciona el icono Editar (lápiz).
-
En el punto de contacto predeterminado, actualiza el punto de contacto al que se deben enviar las notificaciones de las reglas cuando las reglas de alerta no coincidan con ninguna política específica.
-
En Agrupar por, elige las etiquetas (o grupos especiales) por las que agrupar las alertas.
-
En Opciones de temporización, selecciona una de las siguientes opciones.
-
Espera grupal: tiempo de espera para almacenar en búfer las alertas del mismo grupo antes de enviar una notificación inicial. El valor predeterminado es de 30 segundos.
-
Intervalo de grupo: intervalo de tiempo mínimo entre dos notificaciones de un grupo. El valor predeterminado es 5 minutos.
-
Intervalo de repetición: intervalo de tiempo mínimo antes de volver a enviar una notificación si no se han agregado alertas nuevas al grupo. El valor predeterminado es de 4 horas.
-
-
Elija Guardar para guardar los cambios.
Para añadir una nueva política específica de nivel superior
-
Desde la consola Grafana, en el menú de Grafana, selecciona el icono de alerta (campana) para abrir la página de alertas.
-
Selecciona Políticas de notificación.
-
En el menú desplegable Alertmanager, selecciona el Alertmanager que deseas editar.
-
En la sección Enrutamiento específico, selecciona Nueva política específica.
-
En la sección Etiquetas coincidentes, agrega una o más etiquetas de alerta coincidentes. Encontrará más información sobre la coincidencia de etiquetas más adelante en este tema.
-
En Punto de contacto, añada el punto de contacto al que se van a enviar las notificaciones si la alerta coincide con esta política específica. Las políticas anidadas anulan este punto de contacto.
-
Si lo desea, seleccione Anular agrupación para especificar una agrupación diferente de la política raíz.
-
Si lo desea, seleccione Anular los tiempos generales para anular las opciones de tiempo de la política de notificaciones de grupo.
-
Elija Guardar política para guardar los cambios.
Para añadir una política anidada
-
Amplíe la política específica en la que desee crear una política anidada.
-
Selecciona Añadir política anidada y, a continuación, añade los detalles (como cuando se añade una política específica de nivel superior).
-
Elija Guardar política para guardar los cambios.
Para editar una política específica
-
En la página de alertas, selecciona Políticas de notificación para abrir la página en la que se muestran las políticas existentes.
-
Seleccione la política que desee editar y, a continuación, elija el icono Editar (lápiz).
-
Realice los cambios que desee (como cuando agrega una política específica de nivel superior).
-
Elija Guardar política.
Cómo funciona la coincidencia de etiquetas
Una política hace coincidir una alerta si las etiquetas de la alerta coinciden con todas las etiquetas coincidentes especificadas en la política.
-
Etiqueta: el nombre de la etiqueta que debe coincidir. Debe coincidir exactamente con el nombre de la etiqueta de la alerta.
-
Operador: el operador utilizado para comparar el valor de la etiqueta con el valor de la etiqueta correspondiente. Los operadores disponibles son:
-
=
Seleccione etiquetas cuyo valor coincida exactamente con la cadena proporcionada. -
!=
Seleccione etiquetas cuyo valor no coincida con la cadena proporcionada. -
=~
Seleccione etiquetas cuyo valor coincida con el valor interpretado por expresiones regulares de la cadena proporcionada (la cadena proporcionada se interpreta como una expresión regular). -
!=
Seleccione etiquetas que no coincidan con la expresión regular proporcionada.
-
-
Valor: el valor con el que debe coincidir el valor de la etiqueta. Puede coincidir como cadena o como expresión regular, según el operador elegido.
Tiempos de silencio
Un tiempo de silencio es un intervalo de tiempo recurrente en el que no se generan ni envían nuevas notificaciones para una política. Úselos para evitar que las alertas se activen durante un período específico y recurrente, por ejemplo, un período de mantenimiento regular.
Al igual que los silencios, los tiempos de silenciamiento no impiden que se evalúen las reglas de alerta ni impiden que las instancias de alerta se muestren en la interfaz de usuario. Solo impiden la creación de notificaciones.
Puede configurar los tiempos de silencio gestionados por Grafana, así como los tiempos de silencio para una fuente de datos de Alertmanager externa.
Los tiempos de silencio se comparan con los silencios
En la siguiente tabla se muestran las diferencias entre los tiempos de silencio y los tiempos de silencio.
Tiempo de silenciamiento | Silencio |
---|---|
Utiliza definiciones de intervalos de tiempo que pueden repetirse |
Tiene una hora de inicio y finalización fija |
Se crea y luego se agrega a las políticas de notificación |
Utiliza etiquetas para compararlas con una alerta y determinar si se debe silenciar o no |
Para crear una temporización de silencio
-
Desde la consola Grafana, en el menú de Grafana, selecciona el icono de alerta (campana) para abrir la página de alertas.
-
Selecciona Políticas de notificación.
-
En el menú desplegable Alertmanager, selecciona el Alertmanager que deseas editar.
-
En la sección Tiempos de silenciamiento, selecciona el botón Añadir temporización de silenciamiento.
-
Elige el intervalo de tiempo al que quieres que se aplique el tiempo de silencio.
-
Seleccione Enviar para crear el tiempo de silencio.
Para añadir un tiempo de silencio a una política de notificaciones
-
Seleccione la política de notificaciones a la que desee añadir el tiempo de silencio y pulse el botón Editar.
-
En el menú desplegable de tiempos de silencio, selecciona los tiempos de silencio que quieres añadir a la política.
Selecciona el botón Guardar política.
Intervalos de tiempo
Un intervalo de tiempo es una definición de un intervalo de tiempo. Si se inicia una alerta durante este intervalo, se suprime. Se admiten rangos utilizando :
(por ejemplo,monday:thursday
). Un tiempo de silencio puede contener varios intervalos de tiempo. Un intervalo de tiempo consta de varios campos (los detalles se muestran en la siguiente lista), todos los cuales deben coincidir para poder suprimir las alertas. Por ejemplo, si especifica los días de la semana monday:friday
y el intervalo de tiempo comprendido entre las 8:00 y las 9:00, las alertas se suprimen de las 8 a las 9, de lunes a viernes, pero no, por ejemplo, de las 8 a las 9 del sábado.
-
Intervalo de tiempo: la hora del día en la que se suprimen las notificaciones. Consta de dos subcampos: Hora de inicio y Hora de finalización. Un ejemplo de hora es
14:30
. La hora está en notación de 24 horas, en UTC. -
Días de la semana: los días de la semana. Puede ser un solo día, por ejemplo
monday
, un intervalomonday:friday
, o una lista de días separados por comas, por ejemplo.monday, tuesday, wednesday
-
Meses: los meses que se deben seleccionar. Puede especificar los meses con designaciones numéricas o con el nombre completo del mes, por ejemplo,
1
ojanuary
ambos especifican enero. Puede especificar un solo mes, un rango de meses o una lista de meses separada por comas. -
Días del mes: las fechas de un mes. Los valores pueden oscilar entre
1
-31
. Los valores negativos especifican los días del mes en orden inverso, por lo que-1
representan el último día del mes. Los días del mes se pueden especificar como un solo día, un intervalo de días o una lista de días separada por comas.