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.
# Notificaciones
****
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 los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
Elegir cómo, cuándo y dónde enviar las notificaciones de alertas es una parte importante de la configuración del sistema de alertas. Estas decisiones tendrán un impacto directo en su capacidad para resolver los problemas rápidamente y no pasar por alto nada importante.
Como primer paso, defina los [puntos de contacto](v10-alerting-explore-contacts.md), que definen dónde enviar las notificaciones de alertas. Un punto de contacto es un conjunto de una o más integraciones que se utilizan para enviar notificaciones. Agregue plantillas de notificaciones a los puntos de contacto para reutilizarlas y enviar mensajes coherentes en las notificaciones.
A continuación, cree una política de notificaciones que sea un conjunto de reglas sobre dónde, cuándo y cómo se envían las alertas a los puntos de contacto. En una política de notificaciones, para definir dónde enviar las notificaciones de alerta, elija uno de los puntos de contacto que ha creado.
## Instancias de Alertmanager
Grafana utiliza Alertmanagers para enviar notificaciones de alertas resueltas y de activación. Grafana tiene su propio Alertmanager, denominado **Grafana** en la interfaz de usuario, pero también admite el envío de notificaciones desde otros Alertmanagers, como [Prometheus Alertmanager](https://prometheus.io/docs/alerting/latest/alertmanager/). Grafana Alertmanager utiliza políticas de notificación y puntos de contacto para configurar cómo y dónde se envía una notificación, con qué frecuencia debe enviarse una notificación y si las alertas deben enviarse todas en la misma notificación, en notificaciones agrupadas según un conjunto de etiquetas o como notificaciones independientes.
## Políticas de notificaciones
Las políticas de notificaciones controlan cuándo y dónde se envían las notificaciones. Una política de notificaciones puede optar por enviar todas las alertas juntas en la misma notificación, enviar las alertas agrupadas en función de un conjunto de etiquetas o enviar las alertas como notificaciones independientes. Puede configurar cada política de notificaciones para controlar la frecuencia con la que se deben enviar las notificaciones, así como disponer de uno o varios temporizadores de silencio para evitar que se envíen notificaciones a horas del día determinadas y días de la semana determinados.
Las políticas de notificaciones se organizan en una estructura de árbol en la que, en la raíz del árbol, hay una política de notificaciones denominada política predeterminada. Solo puede haber una política predeterminada y no se puede eliminar.
Las políticas de enrutamiento específicas son secundarias a la política raíz y se pueden utilizar para coincidir con todas las alertas o un subconjunto de alertas en función de un conjunto de etiquetas coincidentes. Una política de notificaciones coincide con una alerta cuando sus etiquetas coincidentes coinciden con las etiquetas de la alerta.
Una política anidada puede tener sus propias políticas anidadas, que permiten una mayor coincidencia de alertas. Un ejemplo de política anidada podría ser el envío de alertas de infraestructura al equipo de operaciones, mientras que una política secundaria podría enviar alertas de alta prioridad a PagerDuty y alertas de baja prioridad a Slack.
Todas las alertas, independientemente de sus etiquetas, coinciden con la política predeterminada. Sin embargo, cuando la política predeterminada recibe una alerta, examina cada política anidada y envía la alerta a la primera política anidada que coincide con la alerta. Si la política anidada tiene más políticas anidadas, puede intentar establecer una coincidencia entre la alerta y una de sus políticas anidadas. Si ninguna política anidada coincide con la alerta, la política en sí es la política coincidente. Si no hay políticas anidadas o ninguna política anidada coincide con la alerta, la política predeterminada es la política coincidente.
Para obtener información más detallada acerca de las políticas de notificaciones, consulte [Políticas de notificaciones](v10-alerting-explore-notifications-policies-details.md).
## Plantillas de notificaciones
Puede personalizar las notificaciones con plantillas. Por ejemplo, las plantillas se pueden utilizar para cambiar el título y el mensaje de las notificaciones que se envían a Slack.
Las plantillas no se limitan a una integración o punto de contacto individual, sino que se pueden utilizar en varias integraciones en el mismo punto de contacto e incluso en integraciones entre diferentes puntos de contacto. Por ejemplo, un usuario de Grafana puede crear una plantilla llamada `custom_subject_or_title` y utilizarla tanto para los temas de PagerDuty como para los títulos de los mensajes de Slack sin tener que crear dos plantillas independientes.
Todas las plantillas de notificaciones están escritas en el [lenguaje de plantillas de Go](https://pkg.go.dev/text/template) y se encuentran en la pestaña Puntos de contacto de la página Alertas.
Para obtener información más detallada acerca de la personalización de las notificaciones, consulte [Personalización de las notificaciones](v10-alerting-manage-notifications.md).
## Silencios
Puede utilizar los silencios para silenciar las notificaciones de una o más reglas de activación. Los silencios no impiden que las alertas se activen o se resuelvan, ni ocultan las alertas de activación en la interfaz de usuario. Un silencio se mantiene durante el tiempo configurado, que puede ser en minutos, horas, días, meses o años.
Para obtener información más detallada acerca del uso de los silencios, consulte [Silenciamiento de las notificaciones de alertas](v10-alerting-silences.md).
# Políticas de notificaciones
****
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 los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
Las políticas de notificaciones le proporcionan una forma flexible de dirigir las alertas a varios receptores diferentes. Con los criterios de coincidencia de etiquetas, puede modificar la entrega de las notificaciones de alertas sin tener que actualizar cada regla de alerta individual.
En esta sección, se presenta más información sobre cómo funcionan y están estructuradas las políticas de notificaciones, de modo que pueda aprovechar al máximo la configuración de las políticas de notificaciones.
## Árbol de políticas
Las políticas de notificaciones *no* son una lista, sino que se estructuran según una estructura de árbol. Esto significa que cada política puede tener políticas secundarias, etc. La raíz del árbol de políticas de notificaciones se denomina **política de notificaciones predeterminada**.
Cada política se compone de un conjunto de criterios de coincidencia de etiquetas (0 o más) que especifican qué etiquetas quieren gestionar o no.
Para obtener más información sobre la coincidencia de etiquetas, consulte [Cómo funciona la búsqueda de coincidencias de etiquetas](v10-alerting-overview-labels-matching.md).
**nota**
Si no ha configurado ningún criterio de coincidencia de etiquetas para la política de notificaciones, esta coincidirá con *todas* las instancias de alertas. Esto puede evitar que se evalúen las políticas secundarias, a menos que haya activado la opción **Continuar con la coincidencia del mismo nivel** en la política de notificaciones.
## Enrutamiento
Para determinar qué política de notificaciones gestionará qué instancias de alertas, debe empezar por analizar el conjunto de políticas de notificaciones existente. La política de notificaciones predeterminada debe ser la primera.
Si no se configura ninguna política distinta de la política predeterminada, la política predeterminada gestionará la instancia de alertas.
Si se definen políticas distintas de la política predeterminada, evaluará esas políticas de notificaciones en el orden en que se muestran.
Si una política de notificaciones tiene criterios de coincidencia de etiquetas que coinciden con las etiquetas de la instancia de alertas, pasará a sus políticas secundarias y, si las hubiera, seguirá buscando políticas secundarias que puedan tener criterios de coincidencia de etiquetas que reduzcan aún más el conjunto de etiquetas, y así sucesivamente hasta que no se encuentren más políticas secundarias.
Si no se define ninguna política secundaria en una política de notificaciones o si ninguna de las políticas secundarias tiene criterios de coincidencia de etiquetas que coincidan con las etiquetas de la instancia de alertas, se utiliza la política de notificaciones principal.
En cuanto se encuentra una política coincidente, el sistema deja de buscar otras políticas coincidentes. Si quiere seguir buscando otras políticas que puedan coincidir, habilite **Continuar con la coincidencia del mismo nivel** en esa política concreta.
Por último, si no se selecciona ninguna de las políticas de notificaciones, se utilizará la política de notificaciones predeterminada.
### Enrutamiento de ejemplo
A continuación, se muestra un ejemplo de un árbol de políticas de notificaciones relativamente simple y de algunas instancias de alertas.
![\[Imagen que muestra un conjunto de políticas de notificaciones en una estructura de árbol y un conjunto de instancias de alertas con distintas etiquetas para que coincidan con las políticas.\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/images/notification-routing.png)
A continuación, se muestra un desglose de cómo se seleccionan estas políticas:
El **pod stuck in CrashLoop** no tiene `severity` etiqueta, por lo que ninguna de sus políticas para niños coincide. Tiene una etiqueta `team=operations`, por lo que la primera política coincide.
La política `team=security` no se evalúa porque ya hemos encontrado una coincidencia y la opción **Continuar con la coincidencia del mismo nivel** no está configurada para esa política.
**Uso del disco: 80 %** tiene una etiqueta `team` y `severity` y coincide con una política secundaria del equipo de operaciones.
**Entrada de registro no autorizada** tiene una etiqueta `team`, pero no coincide con la primera política (`team=operations`), ya que los valores no son los mismos, por lo que seguirá buscando y coincidirá con la política `team=security`. No tiene políticas secundarias, por lo que se ignora la etiqueta `severity=high` adicional.
## Herencia
Las políticas secundarias, además de ser un concepto útil para enrutar las instancias de alertas, también heredan propiedades de su política principal. Esto también se aplica a cualquier política que sea secundaria a la política de notificaciones predeterminada.
Las políticas secundarias heredan las siguientes propiedades:
+ Punto de contacto
+ Opciones de agrupación
+ Opciones de temporización
+ Temporizadores de silencio
Una política individual puede sobrescribir cada una de estas propiedades si desea anular las propiedades heredadas.
Para heredar un punto de contacto de la política principal, déjelo en blanco. Para anular las opciones de agrupación heredadas, habilite **Anular agrupación**. Para anular las opciones de temporización heredadas, habilite **Anular temporizadores generales**.
### Ejemplo de herencia
El siguiente ejemplo muestra cómo el árbol de políticas de notificaciones de nuestro ejemplo anterior permite que las políticas secundarias de `team=operations` hereden su punto de contacto.
De esta forma, podemos evitar tener que especificar el mismo punto de contacto varias veces para cada política secundaria.
![\[Una imagen que muestra un conjunto de políticas de notificaciones en una estructura de árbol, con puntos de contacto asignados a algunas de las políticas, pero algunas políticas secundarias heredan los puntos de contacto de sus políticas principales, en lugar de definir los suyos propios.\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/images/notification-inheritance.png)
## Opciones de configuración adicionales
### Agrupación
La agrupación es una característica importante de Grafana Alerting, ya que le permite agrupar las alertas relevantes en un número menor de notificaciones. Esto es especialmente importante si las notificaciones se envían a los primeros responsables, como los ingenieros de guardia, ya que recibir muchas notificaciones en un periodo corto puede resultar abrumador y, en algunos casos, puede afectar negativamente a la capacidad de los primeros responsables para responder a un incidente. Por ejemplo, pensemos en una interrupción importante en la que muchos de los sistemas están inactivos. En este caso, la agrupación puede marcar la diferencia entre recibir 1 llamada telefónica y 100 llamadas telefónicas.
Usted elige cómo se agrupan las alertas mediante la opción Agrupar por de una política de notificaciones. De manera predeterminada, las políticas de notificaciones de Grafana agrupan las alertas por regla de alertas mediante las etiquetas `alertname` y `grafana_folder` (ya que los nombres de las alertas no son únicos en varias carpetas). Si desea agrupar las alertas por algo distinto a la regla de alerta, cambie la agrupación por cualquier otra combinación de etiquetas.
#### Deshabilitación de grupos
Si desea recibir cada alerta como una notificación independiente, agrupe según una etiqueta especial llamada `...`. Esto resulta útil cuando las alertas se envían a un sistema automatizado en lugar de a un primer responsable.
#### Un solo grupo para todas las alertas
Si desea recibir todas las alertas juntas en una sola notificación, deje en blanco la opción Agrupar por.
### Opciones de temporización
Las opciones de temporización deciden la frecuencia con la que se envían las notificaciones para cada grupo de alertas. Hay tres temporizadores que debe conocer: espera grupal, intervalo grupal e intervalo de repetición.
#### Espera grupal
La espera grupal es la cantidad de tiempo que Grafana espera antes de enviar la primera notificación de un nuevo grupo de alertas. Cuanto más larga sea la espera grupal, más tiempo tendrá para que lleguen otras alertas. Cuanto más corta sea la espera grupal, antes se enviará la primera notificación, pero se corre el riesgo de que se envíen notificaciones incompletas. Siempre debe elegir la espera grupal que mejor se adapte a su caso de uso.
**Valor predeterminado**: 30 segundos.
#### Intervalo grupal
Una vez que se ha enviado la primera notificación para un nuevo grupo de alertas, Grafana inicia el temporizador de intervalos grupales. Esta es la cantidad de tiempo que Grafana espera antes de enviar notificaciones sobre cambios en el grupo. Por ejemplo, es posible que se haya agregado otra alerta de activación al grupo y que se haya resuelto una alerta existente. Si una alerta llegó demasiado tarde para incluirse en la primera notificación debido a la espera grupal, se incluirá en las notificaciones subsiguientes después del intervalo grupal. Una vez transcurrido el intervalo grupal, Grafana restablece el temporizador de intervalo grupal. Esto se repite hasta que no haya más alertas en el grupo, tras lo cual se elimina el grupo.
**Valor predeterminado**: 5 minutos
#### Intervalo de repetición
El intervalo de repetición decide la frecuencia con la que se repiten las notificaciones si el grupo no ha cambiado desde la última notificación. Puede considerarlas como recordatorios de que algunas alertas siguen activándose. El intervalo de repetición está estrechamente relacionado con el intervalo grupal, lo que significa que el intervalo de repetición no solo debe ser mayor o igual que el intervalo grupal, sino que también debe ser un múltiplo del intervalo grupal. Si el intervalo de repetición no es un múltiplo del intervalo grupal, se convertirá en uno. Por ejemplo, si el intervalo grupal es de 5 minutos y el intervalo de repetición es de 9 minutos, el intervalo de repetición se redondeará al múltiplo de 5 más cercano, que es 10 minutos.
**Valor predeterminado**: 4 horas