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.

# Configuración de alertas
<a name="v10-alerting-configure"></a>

****  
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).

Configure las características e integraciones que necesita para crear y administrar las alertas.

**Topics**
+ [Configuración de las reglas de alertas administradas por Grafana](v10-alerting-configure-grafanamanaged.md)
+ [Configuración de reglas de alertas administradas por orígenes de datos](v10-alerting-configure-datasourcemanaged.md)
+ [Configuración de reglas de registros](v10-alerting-configure-recordingrules.md)
+ [Configuración de puntos de contacto](v10-alerting-configure-contactpoints.md)
+ [Configuración de políticas de notificación](v10-alerting-configure-notification-policies.md)

# Configuración de las reglas de alertas administradas por Grafana
<a name="v10-alerting-configure-grafanamanaged"></a>

****  
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 reglas administradas por Grafana son el tipo de regla de alertas más flexible. Le permiten crear alertas que pueden actuar sobre los datos de cualquiera de nuestros orígenes de datos admitidos. Además de admitir varios orígenes de datos, también puede agregar expresiones para transformar los datos y establecer condiciones de alertas. 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 varios orígenes de datos en una sola definición de regla.

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

Las reglas de alerta administradas por Grafana solo las pueden editar o eliminar los usuarios con permisos de edición para la carpeta en la que se almacenan las reglas.

Si elimina un recurso de alerta que se haya creado en la interfaz de usuario, ya no podrá recuperarlo. Para hacer una copia de seguridad de la configuración y poder restaurar los recursos de alertas eliminados, cree los recursos de alertas con Terraform o la API de alertas.

En los siguientes procedimientos, llevaremos a cabo el proceso de creación de las reglas de alertas administradas por Grafana.

Para crear una regla de alertas administrada por Grafana, utilice el flujo de creación de alertas en el espacio de trabajo y siga estos pasos que le serán útiles.

**Establecimiento del nombre de regla de alertas**

1. Elija **Alertas** -> **Reglas de alertas** -> **\$1 Nueva regla de alertas**.

1. Ingrese un nombre para identificar la regla de alertas.

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

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

**Definición de la consulta y condición**

1. Elija un origen de datos.

1. En el menú desplegable **Opciones**, especifique un [intervalo de tiempo](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range).
**nota**  
Grafana Alerting solo admite intervalos de tiempo relativos fijos, por ejemplo, `now-24hr: now`.  
No admite intervalos de tiempo absolutos: `2021-12-02 00:00:00 to 2021-12-05 23:59:592` o intervalos de tiempo semirrelativos: `now/d to: now`.

1. Agregue una consulta.

   Para agregar varias [consultas](v10-panels-query-xform.md#v10-panels-query-xform-add), elija **Agregar consulta**.

   Grafana administra todas las reglas de alertas de manera predeterminada. Si quiere cambiar a una regla de alertas administrada por un origen de datos, haga clic en **Cambiar a una regla de alertas administrada por un origen de datos**.

1. Agregue una o más [expresiones](v10-panels-query-xform-expressions.md).

   1. Para cada expresión, seleccione **Condición clásica** para crear una regla de alerta única o elija entre las opciones **Matemáticas**, **Reducir** y **Remuestrear** para generar una alerta independiente para cada serie.
**nota**  
Al usar Prometheus, puede utilizar un vector instantáneo y funciones integradas, por lo que no es necesario agregar expresiones adicionales.

   1. Elija **Vista previa** para verificar que la expresión es correcta.

1. [Opcional] Para agregar 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 alertas.

   Solo puede agregar un umbral de recuperación en una consulta y debe ser la condición de alerta.

1. Elija **Establecer como condición de alerta** en la consulta o expresión que quiere establecer como condición de alerta.

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

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

**Configuración del comportamiento de evaluación de alertas**

1. Seleccione una carpeta o elija **\$1 Nueva carpeta**.

1. Seleccione un grupo de evaluación o haga clic en **\$1 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.

1. Ingrese un periodo pendiente.

   El periodo pendiente es el periodo en el que una regla de alertas puede infringir la condición hasta que se active.

   Una vez cumplida una condición, la alerta pasa al estado **Pendiente**. Si la condición permanece activa durante el tiempo especificado, la alerta pasa al estado **Activación**, de lo contrario se revertirá al estado **Normal**.

1. Active las notificaciones de alerta de pausa, si es necesario.
**nota**  
Pause la evaluación de las reglas de alertas para evitar alertas excesivas mientras ajustas las alertas. La pausa detiene la evaluación de las reglas de alertas y no crea ninguna instancia de alertas. Esto es distinto a los tiempos de silencio, que impiden que se envíen las notificaciones, pero permiten evaluar las reglas de alertas y crear instancias de alertas.  
Puede pausar la evaluación de las reglas de alertas para evitar alertas excesivas mientras ajustas las alertas. La pausa detiene la evaluación de las reglas de alertas y no crea ninguna instancia de alertas. Esto es distinto a los tiempos de silencio, que impiden que se envíen las notificaciones, pero permiten evaluar las reglas de alertas y crear instancias de alertas.

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

   Use las directrices más adelante en esta sección.

Agregue etiquetas a las reglas de alertas para establecer qué política de notificación debe gestionar las instancias de alertas de activación.

Todas las reglas e instancias de alertas, 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. Agregue etiquetas si quiere cambiar la forma en que se distribuyen las notificaciones.

   Para agregar etiquetas personalizadas, seleccione los pares clave-valor existentes en el menú desplegable o, para agregar etiquetas nuevas, ingrese la nueva clave o valor.

1. Obtenga una vista previa de la configuración de enrutamiento de las instancias de alertas.

   En función de las etiquetas agregadas, las instancias de alertas se redirigen a las políticas de notificaciones que se muestran.

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

1. Elija **Ver detalles** para ver los detalles del enrutamiento de las alertas y una vista previa.

Agregue [anotaciones](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations) para proporcionar más contexto sobre la alerta en el mensaje de las notificaciones de alertas.

Las anotaciones agregan metadatos para proporcionar más información sobre la alerta en el mensaje de las notificaciones de alertas. Por ejemplo, agregue una anotación **Resumen** que le indique qué valor activó la alerta o en qué servidor se produjo.

**Adición de anotaciones**

1. [Opcional] Agregue un resumen.

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

1. [Opcional] Agregue una descripción.

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

1. [Opcional] Agregue una URL del manual de procedimientos.

   Página web en la que mantiene el manual de procedimientos de la alerta.

1. [Opcional] Agregue una anotación personalizada.

1. [Opcional] Agregue un panel y un enlace al panel.

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

1. Seleccione **Guardar regla**.

**Regla única y multidimensional**

En el caso de las alertas administradas 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. En el caso de una consulta que devuelve varias series, Grafana no hace 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 las expresiones `Math`, `Reduce` o `Resample` para crear una regla multidimensional. Por ejemplo:
  + Agregue una expresión `Reduce` 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](v10-alerting-overview-numeric.md)).
  + Agregue una expresión `Math` con la condición de la regla. No es necesario en caso de que una consulta o una expresión de reducción ya devuelve `0` si la regla no se debe activar, o un número positivo si se debe activar. Algunos ejemplos: `$B > 70` si se dispara en caso de que el valor de B query/expression sea superior a 70. `$B < $C * 100`en caso de que se dispare 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://comtemplate-variables-are-notmunity.grafana.com/t/](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514) - - /2514. supported-in-alert-queries while-setting-up-alert

**Configuración de la gestión de errores y ausencia de datos**

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

**nota**  
Las reglas de alertas configuradas para activarse cuando una evaluación no devuelve datos o genera un error, solo se activan cuando finaliza todo el periodo de evaluación. Esto significa que, en lugar de activarse inmediatamente cuando se incumple la condición de la regla de alertas, la regla de alertas espera hasta que termine el tiempo establecido en el campo **Para** y, a continuación, se activa, lo que reduce el ruido de las alertas y tolera problemas temporales de disponibilidad de los datos.

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


| Sin datos | Description (Descripción) | 
| --- | --- | 
| Sin datos | Cree una nueva alerta DatasourceNoData con el nombre y el UID de la regla de alertas y el UID del origen de datos que no devolvió ningún dato como etiquetas. | 
| Alertas | Establece el estado de la regla de alertas en Alerting. La regla de alertas espera hasta que haya terminado el tiempo establecido en el campo Para antes de activarse. | 
| Correcto | Establece el estado de la regla de alertas en Normal. | 

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


| Error | Description (Descripción) | 
| --- | --- | 
| Error | Crea una instancia de alertas DatasourceError con el nombre y el UID de la regla de alertas y el UID del origen de datos que no devolvió datos como etiquetas. | 
| Alertas | Establece el estado de la regla de alertas en Alerting. La regla de alertas espera hasta que haya terminado el tiempo establecido en el campo Para antes de activarse. | 
| Correcto | Establece el estado de la regla de alertas en Normal. | 

**Resolución de las instancias de alertas obsoletas**

Una instancia de alertas 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 alertas obsoletas que se encuentran en los estados `Alerting`, `NoData` o `Error` se marcan automáticamente como `Resolved` y la anotación `grafana_state_reason` se agrega a la instancia de alertas con el motivo `MissingSeries`.

**Creación de alertas a partir de paneles**

Cree alertas a partir de cualquier tipo de paneles. Esto significa que puede reutilizar las consultas del panel y crear alertas en función de ellas.

1. Vaya a un panel en la sección **Paneles**.

1. En la esquina superior derecha del panel, elija los tres puntos (elipses).

1. En el menú desplegable, seleccione **Más…** y, a continuación, elija **Nueva regla de alertas**.

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

# Configuración de reglas de alertas administradas por orígenes de datos
<a name="v10-alerting-configure-datasourcemanaged"></a>

****  
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).

Cree reglas de alerta para una instancia externa de Grafana Mimir o Loki que tenga habilitada la API de reglas. Se denominan reglas de alerta administradas por el origen de datos.

**nota**  
Los usuarios con roles de editor o administrador pueden editar o eliminar las reglas de alertas de una instancia externa de Grafana Mimir o Loki.  
Si elimina un recurso de alerta que se haya creado en la interfaz de usuario, ya no podrá recuperarlo. Para hacer una copia de seguridad de la configuración y poder restaurar los recursos de alertas eliminados, cree los recursos de alertas con Terraform o la API de alertas.

**Requisitos previos**
+ Compruebe que tenga permiso de escritura para acceder al origen de datos de Prometheus o Loki. De lo contrario, no podrá crear ni actualizar las reglas de alerta administradas por Grafana Mimir.
+ En el caso de los orígenes de datos de Grafana Mimir y Loki, configure los servicios respectivos para habilitar la API de reglas.
  + **Loki**: el tipo de almacenamiento de reglas `local`, predeterminado para el origen de datos de Loki, solo admite la visualización de reglas. Para editar las reglas, configure uno de los otros tipos de almacenamiento de reglas.
  + **Grafana Mimir**: use el prefijo `/prometheus`. El origen de datos de Prometheus es compatible con Grafana Mimir y Prometheus, y Grafana espera que tanto la [API de consultas](https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#querier--query-frontend) como la [API de reglas](https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#ruler) estén en la misma URL. No puede proporcionar una URL diferente para la API de regla.

**nota**  
Si no quiere administrar las reglas de alertas para un origen de datos de Loki o Prometheus en particular, vaya a su configuración y desactive la casilla **Administrar alertas mediante la interfaz de usuario de alertas**.

En los siguientes procedimientos, le guiaremos en el proceso de creación de las reglas de alertas administradas por el origen de datos.

Para crear una regla de alertas administrada por el origen de datos, utilice el flujo de creación de alertas en el espacio de trabajo y siga estos pasos que serán útiles.

**Configuración del nombre de la regla de alertas**

1. Elija **Alertas** -> **Reglas de alertas** -> **\$1 Nueva regla de alertas**.

1. Ingrese un nombre para identificar la regla de alertas.

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

Defina una consulta para obtener los datos que quiere medir y una condición que debe cumplirse antes de que se active una regla de alerta.

**Definición de una consulta y condición**

1. Grafana administra todas las reglas de alertas de manera predeterminada. Para cambiar a una regla de alerta administrada por un origen de datos, elija **Cambiar a una regla de alerta administrada por un origen de datos**.

1. Seleccione un origen de datos de la lista desplegable.

   También puede elegir **Abrir el selector avanzado de orígenes de datos** para ver más opciones, incluida la adición de un origen de datos (solo para administradores).

1. Ingrese una consulta PromQL o LogQL.

1. Elija **Vista previa de alertas**.

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

**Configuración del comportamiento de evaluación de alertas**

1. Seleccione un espacio de nombres o elija **\$1 Nuevo espacio de nombres**.

1. Seleccione un grupo de evaluación o elija **\$1 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 secuencialmente durante el mismo intervalo de tiempo.

1. Ingrese un periodo pendiente.

   El periodo pendiente es el periodo en el que una regla de alertas puede infringir la condición hasta que se active.

   Una vez cumplida una condición, la alerta pasa al estado `Pending`. Si la condición permanece activa durante el tiempo especificado, la alerta pasa al estado `Firing`, de lo contrario se revertirá al estado `Normal`.

Agregue etiquetas a las reglas de alertas para establecer qué política de notificación debe gestionar las instancias de alertas de activación.

Todas las reglas e instancias de alertas, 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.

**Configuración de las notificaciones**
+ Agregue etiquetas si quiere cambiar la forma en que se distribuyen las notificaciones.

  Para agregar etiquetas personalizadas, seleccione los pares clave-valor existentes en el menú desplegable o, para agregar etiquetas nuevas, ingrese la nueva clave o valor.

Agregue [anotaciones](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations) para proporcionar más contexto sobre la alerta en las notificaciones de alerta.

Las anotaciones agregan metadatos para proporcionar más información sobre la alerta en las notificaciones de alertas. Por ejemplo, agregue una anotación `Summary` que le indique qué valor activó la alerta o en qué servidor se produjo.

**Adición de anotaciones**

1. [Opcional] Agregue un resumen.

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

1. [Opcional] Agregue una descripción.

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

1. [Opcional] Agregue una URL del manual de procedimientos.

   Página web en la que mantiene el manual de procedimientos de la alerta.

1. [Opcional] Agregue una anotación personalizada.

1. [Opcional] Agregue un panel y un enlace al panel.

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

1. Seleccione **Guardar regla**.

# Configuración de reglas de registros
<a name="v10-alerting-configure-recordingrules"></a>

****  
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).

Puede crear y administrar reglas de registros para una instancia externa de Grafana Mimir o Loki. Las reglas de registro calculan por anticipado expresiones que se necesitan con frecuencia o que son costosas desde el punto de vista de la computación y guardan el resultado como un nuevo conjunto de series temporales. La consulta de esta nueva serie temporal es más rápida, especialmente en el caso de los paneles, ya que consultan la misma expresión cada vez que se actualizan.

**nota**  
Las reglas de registros se ejecutan como reglas de instancia y se ejecutan cada 10 segundos.

**Requisitos previos**
+ Compruebe que tenga permisos de escritura para acceder al origen de datos de Prometheus o Loki. Creará o actualizará las reglas de alertas en el origen de datos.
+ En el caso de los orígenes de datos de Grafana Mimir y Loki, configure los servicios respectivos para habilitar la API de reglas.
  + **Loki**: el tipo de almacenamiento de reglas `local`, predeterminado para el origen de datos de Loki, solo admite la visualización de reglas. Para editar las reglas, configure uno de los otros tipos de almacenamiento.
  + **Grafana Mimir**: use el prefijo `/prometheus`. El origen de datos de Prometheus es compatible con Grafana Mimir y Prometheus, y Grafana espera que tanto la API de consultas como la API de reglas estén en la misma URL. No puede proporcionar una URL diferente para la API de regla.

**nota**  
Si no desea administrar las reglas de alerta para un origen de datos de Loki o Prometheus en particular, vaya a su configuración y desactive la casilla **Administrar alertas mediante la interfaz de usuario de alertas**.

**Creación de reglas de registros**

1. En la consola de Grafana, en el menú de Grafana, elija **Alerta**, **Reglas de alertas**.

1. Elija **Nueva regla de registros**.

1. Elija un nombre de regla.

   El nombre de la regla de registro debe ser un nombre de métrica de Prometheus y no debe contener espacios en blanco.

1. Definición de la consulta
   + Seleccione el origen de datos de Loki o Prometheus.
   + Ingrese una consulta.

1. Agregue un espacio de nombres y un grupo.
   + En el menú desplegable **Espacio de nombres**, seleccione un espacio de nombres de reglas existente o agregue uno nuevo. Los espacios de nombres pueden contener uno o más grupos de reglas y solo tienen un propósito organizativo.
   + En el menú desplegable **Grupo**, seleccione un grupo existente del espacio de nombres seleccionado o agregue uno nuevo. Las reglas recién creadas se agregan al final del grupo. Las reglas de un grupo se ejecutan secuencialmente a intervalos regulares, con el mismo tiempo de evaluación.

1. Agregue etiquetas.
   + Para agregar etiquetas personalizadas, seleccione los pares clave-valor existentes en el menú desplegable o, para agregar etiquetas nuevas, ingrese la nueva clave o valor.

1. Elija **Guardar regla** para guardar la regla o **Guardar regla y salir** para guardar la regla y volver a la página Alertas.

# Configuración de puntos de contacto
<a name="v10-alerting-configure-contactpoints"></a>

****  
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).

Utilice los puntos de contacto para definir cómo se notifica a los contactos cuando se activa una regla de alerta.

**nota**  
Puede crear y editar puntos de contacto para las alertas administradas por Grafana. Los puntos de contacto para las alertas administradas por el origen de datos son de solo lectura.

## Uso de puntos de contacto
<a name="v10-alerting-configure-contactpoints-working"></a>

Los procedimientos siguientes muestran cómo agregar, editar y probar un punto de contacto.

**Cómo agregar un punto de contacto**

1. En el menú de la izquierda, seleccione **Alertas**.

1. Seleccione **Puntos de contacto**.

1. En el menú desplegable **Elegir Alertmanager**, seleccione un Alertmanager. De forma predeterminada, está seleccionado Grafana Alertmanager.

1. En la pestaña **Puntos de contacto**, elija **\$1 Agregar punto de contacto**.

1. Ingrese un **nombre** para el punto de contacto.

1. En **Integración**, elija un tipo y rellene los campos obligatorios en función de ese tipo. Por ejemplo, si elige Slack, ingrese los canales y usuarios de Slack con los que debe contactar.

1. Si está disponible para el punto de contacto que seleccionó, elija **Configuración opcional** para especificar configuraciones adicionales.

1. En **Configuración de notificaciones**, si lo desea, seleccione **Deshabilitar el mensaje resuelto** si no desea recibir una notificación cuando se resuelva una alerta.

1. Para agregar otra integración de puntos de contacto, seleccione **Agregar integración de puntos de contacto** y repita los pasos para cada tipo de punto de contacto que necesite.

1. Guarde los cambios.

**Edición de un punto de contacto**

1. En el menú de la izquierda, seleccione **Alertas**.

1. Elija **Puntos de contacto** para ver una lista de los puntos de contacto existentes.

1. Seleccione el punto de contacto que quiere editar y, a continuación, elija **Editar**.

1. Actualice el punto de contacto y, a continuación, guarde los cambios.

Puede eliminar los puntos de contacto que la política de notificaciones no esté utilizando.

**Eliminación de un punto de contacto**

1. En el menú de la izquierda, seleccione **Alertas**.

1. Elija **Puntos de contacto** para abrir la lista de los puntos de contacto existentes.

1. En **Puntos de contacto**, seleccione el punto de contacto que quiere eliminar y, a continuación, elija **Más**, **Eliminar**.

1. En el cuadro de diálogo de confirmación, elija **Sí, eliminar**.

**nota**  
Si una política de notificaciones está utilizando el punto de contacto, debe eliminarla o editarla para usar un punto de contacto diferente antes de eliminar el punto de contacto.

Una vez creado el punto de contacto, puede enviar una notificación de prueba para comprobar que está configurado correctamente.

**Envío de una notificación de prueba**

1. En el menú de la izquierda, seleccione **Alertas**.

1. Elija **Puntos de contacto** para abrir la lista de los puntos de contacto existentes.

1. En **Puntos de contacto**, seleccione el punto de contacto que quiere probar y, a continuación, elija **Editar**. También puede crear un nuevo punto de contacto si lo necesita.

1. Elija **Probar** para abrir el cuadro de diálogo de prueba del punto de contacto.

1. Elija si desea enviar una notificación de prueba predefinida o seleccione **Personalizar** para agregar sus propias anotaciones y etiquetas personalizadas a la notificación de prueba.

1. Elija **Enviar notificación de prueba** para probar la alerta con los puntos de contacto indicados.

## Configuración de las integraciones de puntos de contacto
<a name="v10-alerting-configure-contactpoints-integration"></a>

Configure las integraciones de puntos de contacto en Grafana para seleccionar el canal de comunicación preferido para recibir notificaciones cuando se activen las reglas de alerta. Cada integración tiene sus propias opciones de configuración y proceso de configuración. En la mayoría de los casos, esto implica proporcionar una clave de API o una URL de Webhook.

Una vez configuradas, puede utilizar las integraciones como parte de los puntos de contacto para recibir notificaciones cada vez que la alerta cambie de estado. En esta sección, abordaremos los pasos básicos para configurar una integración, PagerDuty como ejemplo, para que pueda comenzar a recibir alertas en tiempo real y estar al tanto de sus datos de monitoreo.

**Lista de integraciones admitidas**

En la siguiente tabla, se muestran los tipos de puntos de contacto de admitidos por Grafana.


| Name | Tipo | 
| --- | --- | 
| Amazon SNS | `sns` | 
| OpsGenie | `opsgenie` | 
| PagerDuty | `pagerduty` | 
| Slack | `slack` | 
| VictorOps | `victorops` | 

**¿Cómo configurar PagerDuty las alertas?**

Para configurarlo PagerDuty, debe proporcionar una clave de integración. Proporcione los siguientes detalles.


| Opción | Description (Descripción) | 
| --- | --- | 
| Clave de integración | Clave de integración para PagerDuty | 
| Gravedad | Nivel para notificaciones dinámicas. El valor predeterminado es critical. | 
| Detalles personalizados | Detalles adicionales sobre el evento | 

El campo `CustomDetails` es un objeto que contiene pares de clave-valor arbitrarios. Los detalles definidos por el usuario se combinan con los que se utilizan de manera predeterminada.

Los valores predeterminados para `CustomDetails` son:

```
{
	"firing":       `{{ template "__text_alert_list" .Alerts.Firing }}`,
	"resolved":     `{{ template "__text_alert_list" .Alerts.Resolved }}`,
	"num_firing":   `{{ .Alerts.Firing | len }}`,
	"num_resolved": `{{ .Alerts.Resolved | len }}`,
}
```

En caso de claves duplicadas, los detalles definidos por el usuario sobrescriben los predeterminados.

# Configuración de políticas de notificación
<a name="v10-alerting-configure-notification-policies"></a>

****  
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 determinan cómo se dirigen las alertas a los puntos de contacto.

Las políticas tienen una estructura de árbol, en la que cada política puede incluir una o varias políticas anidadas. Cada política, excepto la política predeterminada, también puede coincidir con etiquetas de alerta específicas.

La política predeterminada evalúa cada alerta y, posteriormente, las evalúa cada política anidada.

Si habilita la opción `Continue matching subsequent sibling nodes` para una política anidada, 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 predeterminada rige cualquier alerta que no coincida con una política anidada.

Para obtener más información sobre las políticas de notificaciones, consulte [Notificaciones](v10-alerting-explore-notifications.md).

Los procedimientos que aparecen a continuación le muestran cómo crear y administrar políticas de notificaciones.

**Edición de la política de notificación predeterminada**

1. En el menú de la izquierda, seleccione **Alertas**.

1. Elija **Políticas de notificación**.

1. En el menú desplegable **Elegir Alertmanager**, seleccione el Alertmanager que quiere editar.

1. En la sección **Política predeterminada**, elija **...**, **Editar**.

1. En **Punto de contacto predeterminado**, actualice 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.

1. En **Agrupar por**, elija las etiquetas para agruparlas. Si coinciden varias alertas para esta política, se agrupan según estas etiquetas. Se envía una notificación por grupo. Si el campo está vacío (valor predeterminado), todas las notificaciones se envían en un solo grupo. Use una etiqueta especial, `...` para agrupar las alertas según todas las etiquetas (lo que desactiva la agrupación).

1. En **Opciones de temporización**, seleccione una de las siguientes opciones.
   + **Espera de grupo**: 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 4 horas.

1. Elija **Guardar** para guardar los cambios.

Para crear una nueva política de notificaciones, debe seguir su estructura de árbol. Las nuevas políticas que se crean en el tronco del árbol (la política predeterminada) son las ramas del árbol. Cada rama puede tener sus propias políticas anidadas. Este es el motivo por el que siempre agregará una nueva política **anidada**, ya sea en la política predeterminada o en una política ya anidada.

**Adición de una nueva política anidada**

1. En el menú de la izquierda, seleccione **Alertas**.

1. Elija **Políticas de notificación**.

1. En el menú desplegable **Elegir Alertmanager**, seleccione el Alertmanager que quiere editar.

1. Para agregar una política específica superior, vaya a la sección de enrutamiento específico (ya sea a la política predeterminada o a otra política existente a la que quiere agregar una nueva política anidada) y seleccione **\$1 Nueva política anidada.**

1. En la sección Etiquetas coincidentes, agregue una o más reglas de etiquetas de alerta coincidentes.

1. En el menú desplegable **Punto de contacto**, seleccione el punto de contacto al que se van a enviar las notificaciones si una alerta coincide solo con esta política específica y no con cualquiera de las políticas anidadas.

1. Si lo desea, habilite la opción **Continuar con la coincidencia de los nodos subsiguientes del mismo nivel** para seguir haciendo coincidir las políticas del mismo nivel incluso después de que la alerta coincida con la política actual. Cuando esta opción está habilitada, puede recibir más de una notificación para una alerta.

1. Si lo desea, habilite la opción **Anular agrupación** para especificar la misma agrupación que la política predeterminada. Si la opción no está habilitada, se utiliza la agrupación de políticas predeterminada.

1. Si lo desea, habilite la opción **Anular temporizadores generales** para anular las opciones de temporización configuradas de la política de notificaciones de grupo.

1. Elija **Guardar política** para guardar los cambios.

**Edición de una política anidada**

1. En el menú de la izquierda, seleccione **Alertas**.

1. Elija **Políticas de notificación**.

1. Seleccione la política que quiere modificar y elija **...**, **Editar**.

1. Haga los cambios que desee (como cuando agrega una política anidada).

1. Guarde los cambios.

**Búsqueda de políticas**

Puede buscar en el árbol de políticas por *Criterios de coincidencia de etiquetas* o *puntos de contacto*.
+ Para buscar por punto de contacto, ingrese el nombre parcial o completo de un punto de contacto en el campo **Buscar por punto de contacto**. Las políticas que utilizan ese punto de contacto se resaltarán en la interfaz de usuario.
+ Para buscar por etiqueta, introduzca un criterio de coincidencia de etiquetas válido en el campo de entrada **Buscar por criterios de coincidencia**. Se pueden ingresar varios criterios de coincidencia separados por una coma. Por ejemplo, una entrada de criterio de coincidencia válida podría ser `severity=high, region=~EMEA|NA`.
**nota**  
Al buscar por etiqueta, todas las políticas coincidentes coincidirán será coincidencias exactas. No se admiten las coincidencias parciales ni las coincidencias de estilo regular.