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.
# Alertas de Grafana
****
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 los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).
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).
Grafana Alerting le proporciona alertas sólidas y procesables que lo ayudan a conocer los problemas de los sistemas momentos después de que se produzcan, lo que minimiza la interrupción de sus servicios.
Amazon Managed Grafana incluye acceso a un sistema de alertas actualizado, *Grafana Alerting*, que centraliza la información de las alertas en una única vista en la que se pueden hacer búsquedas. Incluye las siguientes características:
+ Cree y administre las alertas de Grafana en una vista centralizada.
+ Cree y administre las alertas administradas por Cortex y Loki a través de una única interfaz. Para obtener más información, consulte [Administración de reglas de alerta](v9-alerting-managerules.md).
+ Consulte la información de alertas de Prometheus, Amazon Managed Service para Prometheus y otros orígenes de datos compatibles con Alertmanager.
+ Crear varias instancias de alerta a partir de una única regla de alerta. Para obtener más información, consulte [Reglas unidimensionales y multidimensionales](v9-alerting-managerules-grafana.md#v9-alerting-single-multi-rule).
+ Administre sus recursos de alertas con terraform o aprovisionamiento. APIs Para obtener más información, consulte [Aprovisionamiento de recursos de Grafana Alerting](v9-alerting-setup-provision.md).
En el caso del espacio de trabajo de Amazon Managed Grafana existente, las [Alertas clásicas del panel](old-alerts-overview.md) son las predeterminadas. Para migrar a las alertas de Grafana, debe [migrar a las alertas de Grafana](alert-opt-in.md).
Para obtener más información sobre las alertas de Grafana, consulte [Novedades de las alertas de Grafana](alerts-whats-new.md).
Las alertas de Grafana tienen cuatro componentes clave:
+ [Regla de alerta](alert-rules.md): criterios de evaluación que determinan si se inicia una alerta. Consta de una o más consultas y expresiones, una condición, la frecuencia de la evaluación y, opcionalmente, el tiempo durante el cual se cumple la condición.
+ [Punto de contacto](alert-contact-points.md): canal para enviar notificaciones cuando se cumplen las condiciones de una regla de alerta.
+ [Política de notificaciones](alert-notifications.md): conjunto de criterios de coincidencia y agrupación que se utilizan para determinar la frecuencia de las notificaciones.
+ [Silencios](alert-silences.md): fecha y criterios de coincidencia utilizados para silenciar las notificaciones.
Cuando las alertas de Grafana están habilitadas, puede hacer lo siguiente:
+ [Crear reglas de alerta administradas por Grafana](alert-rules.md#create-grafana-alert-rule)
+ [Crear reglas de alerta administradas por Cortex o Loki](alert-rules.md#create-alert-rule)
+ [Consultar las reglas de alerta existentes y administrar su estado actual](alert-rules.md#manage-alert-rules)
+ [Consultar el estado de las reglas de alerta](alert-fundamentals.md#alerts-state)
+ [Agregar o editar un punto de contacto de alerta](alert-contact-points.md#alert-working-contact-points)
+ [Agregar o editar políticas de notificaciones](alert-notifications.md#alert-notifications-working)
+ [Agregar o editar silencios](alert-silences.md)
## Limitaciones
+ El sistema de Grafana Alerting puede recuperar reglas de todos los orígenes de datos disponibles de Amazon Managed Service para Prometheus, Prometheus, Loki y Alertmanager. Es posible que no pueda obtener las reglas de otros orígenes de datos compatibles.
+ Las reglas de alerta definidas en Grafana, en lugar de en Prometheus, envían múltiples notificaciones a su punto de contacto. Si utiliza alertas nativas de Grafana, le recomendamos que siga usando las alertas clásicas del panel y no habilite la nueva característica Grafana Alerting. Si desea ver las alertas definidas en su origen de datos de Prometheus, le recomendamos que habilite Grafana Alerting, que envían solo una notificación para las alertas creadas en la instancia de Alertmanager de Prometheus.
**nota**
Esta limitación ya no existe en los espacios de trabajo de Amazon Managed Grafana que admiten la versión 10.4 y posteriores de Grafana.
**Topics**
+ [Limitaciones](#alert-limitations)
+ [Novedades de las alertas de Grafana](alerts-whats-new.md)
+ [Migración de las alertas clásicas del panel de control a Grafana Alerting](alert-opt-in.md)
+ [Conceptos básicos de alertas](alert-fundamentals.md)
+ [Creación y administración de reglas de alerta de Grafana](alert-rules.md)
+ [Grupos de alertas](alert-groups.md)
+ [Silenciamiento de las notificaciones de alertas para los orígenes de datos de Prometheus](alert-silences.md)
+ [Uso de puntos de contacto](alert-contact-points.md)
+ [Uso de plantillas de mensajes](alert-message-templates.md)
+ [Uso de políticas de notificaciones](alert-notifications.md)
# Novedades de las alertas de Grafana
****
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 los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).
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).
Las alertas de Grafana presentan varias mejoras con respecto a las alertas clásicas del panel.
## Creación de alertas multidimensionales
Ahora puede crear una única regla de alerta que le brinde visibilidad en todo el sistema y generar múltiples instancias de alerta a partir de una sola regla de alerta. Por ejemplo, puede crear una regla para supervisar el uso del disco de varios puntos de montaje de un único host. El motor de evaluación devuelve varias series temporales a partir de una sola consulta y cada serie temporal se identifica mediante su conjunto de etiquetas.
**nota**
Cada instancia de alerta se tiene en cuenta para la cuota de alertas. Las reglas multidimensionales que crean más instancias de las que se pueden incluir en la cuota de alertas no se evalúan y devuelven un error de cuota. Para obtener más información, consulte [Errores de cuota alcanzada](alert-rules.md#rule-quota-reached).
## Creación de alertas fuera de los paneles de control
A diferencia de las alertas clásicas del panel, con las alertas de Grafana puede crear consultas y expresiones que combinen datos de múltiples orígenes de formas únicas. Puede seguir vinculando los paneles a las reglas de alerta mediante su ID y solucionar rápidamente los problemas del sistema que se encuentre en observación.
Como las alertas unificadas ya no están directamente vinculadas a las consultas de los paneles, no incluyen imágenes ni valores de consulta en el correo electrónico de notificación. Puede utilizar plantillas de notificación personalizadas para ver los valores de las consultas.
## Creación de reglas de alerta de Cortex y Loki
En las alertas de Grafana, puede administrar las reglas de alerta de Loki y Cortex utilizando la misma interfaz de usuario y API que las alertas administradas por Grafana.
## Consulta y búsqueda de alertas de Amazon Managed Service para Prometheus y otros orígenes de datos compatibles con Prometheus
Las alertas de Amazon Managed Service para Prometheus y los orígenes de datos compatibles con Prometheus ahora se indican en la interfaz de alertas. Puede buscar etiquetas en varios orígenes de datos para encontrar rápidamente las alertas pertinentes.
## Alertas especiales de estado de alerta NoData y error
Las alertas de Grafana generan alertas especiales que tienen las siguientes etiquetas cuando la evaluación de una regla de alerta produce un estado `NoData` o `Error`:
+ `alertname` con el valor `DatasourceNoData` o `DatasourceError` en función del estado.
+ `rulename` con el nombre de la regla de alerta a la que pertenece la alerta especial.
+ `datasource_uid` tiene el UID del origen de datos que provocó el estado.
+ Todas las etiquetas y anotaciones de la regla original.
Puede gestionar estas alertas de la misma manera que las alertas normales, por ejemplo, agregando un silencio o dirigiéndolas a un punto de contacto.
**nota**
Si la regla usa varios orígenes de datos y uno o más no devuelve ningún dato, la alerta especial se crea para cada origen de datos que provocó el estado de alerta.
# Migración de las alertas clásicas del panel de control a Grafana Alerting
****
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 los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).
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).
Los espacios de trabajo existentes, o los espacios de trabajo que eligen no usar las alertas de Grafana, utilizan las alertas clásicas del panel. Para migrar a la nueva característica de alertas de Grafana, primero debe registrarse en ella.
Puedes configurar tu instancia de Grafana gestionada por Amazon para que utilice las alertas de Grafana mediante la Consola de administración de AWS, la AWS CLI o la API de Grafana gestionada por Amazon. Para obtener más información sobre cómo configurar Amazon Managed Grafana, incluida la activación o desactivación de Grafana Alerting, consulte [Configuración de un espacio de trabajo de Amazon Managed Grafana](AMG-configure-workspace.md).
**nota**
Al utilizar Grafana Alerting, las reglas de alerta definidas en Grafana, en lugar de en Prometheus, envían múltiples notificaciones a su punto de contacto. Si utiliza alertas nativas de Grafana, le recomendamos que siga usando las alertas clásicas del panel y no habilite la nueva característica Grafana Alerting. Si desea ver las alertas definidas en su origen de datos de Prometheus, le recomendamos que habilite Grafana Alerting, que envían solo una notificación para las alertas creadas en la instancia de Alertmanager de Prometheus.
Esta limitación se elimina en los espacios de trabajo de Amazon Managed Grafana que admiten la versión 10.4 y posteriores de Grafana.
## Migración al sistema de Grafana Alerting
Cuando Grafana Alerting está activado, las alertas clásicas existentes del panel se migran en un formato compatible con Grafana Alerting. En la página Alertas de su instancia de Grafana, puede ver las alertas migradas junto con las alertas nuevas. Con Grafana Alerting, las reglas de alerta administradas por Grafana envían varias notificaciones en lugar de una sola alerta cuando coinciden.
El acceso de lectura y escritura a las alertas clásicas del panel y a las alertas de Grafana se rige por los permisos de las carpetas que las almacenan. Durante la migración, los permisos de las alertas clásicas del panel se comparan con los permisos de las nuevas reglas de la siguiente manera:
+ Si el panel de la alerta original tiene permisos, la migración crea una carpeta cuyo nombre sigue el formato `Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1}` para que coincida con los permisos del panel original (incluidos los permisos heredados de la carpeta).
+ Si no hay permisos del panel y el panel está en una carpeta, la regla se vincula a esta carpeta y hereda sus permisos.
+ Si no hay permisos del panel y el panel está en la carpeta General, la regla se vincula a la carpeta General Alerting y hereda los permisos predeterminados.
**nota**
Como en Grafana Alerting no hay ninguna opción `Keep Last State` para `NoData`, esta opción se convierte en `NoData` durante la migración de reglas clásicas. La opción `Keep Last State` para la gestión de `Error` se migra a una nueva opción `Error`. Para establecer coincidencias con el comportamiento de `Keep Last State`, en ambos casos, durante la migración, Amazon Managed Grafana crea automáticamente un silencio para cada regla de alerta con una duración de un año.
Los canales de notificación se migran a una configuración de Alertmanager con las rutas y los receptores adecuados. Los canales de notificación predeterminados se agregan como puntos de contacto a la ruta predeterminada. Los canales de notificación que no están asociados a ninguna alerta del panel van a la ruta `autogen-unlinked-channel-recv`.
### Limitaciones
+ El sistema de Grafana Alerting puede recuperar reglas de todos los orígenes de datos disponibles de Prometheus, Loki y Alertmanager. Es posible que no pueda obtener las reglas de alerta de otros orígenes de datos compatibles.
+ La migración entre las alertas de Grafana y las alertas clásicas del panel puede provocar la pérdida de datos para las características compatibles con un sistema, pero no el otro.
**nota**
Si vuelve a migrar a las alertas clásicas del panel de control, perderá todos los cambios aplicados en la configuración de alertas mientras tenía habilitado Grafana Alerting, incluidas las reglas de alerta nuevas que se hayan creado.
# Conceptos básicos de alertas
****
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 los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).
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).
En esta sección, se proporciona información sobre los conceptos fundamentales de las alertas de Grafana.
## Conceptos relacionados con las alertas
En la siguiente tabla se describen los conceptos clave de las alertas de Grafana.
| Característica o concepto clave | Definición |
| --- | --- |
| Orígenes de datos de alertas | Seleccione los orígenes de datos desde los que desee consultar y visualizar las métricas, los registros y los rastros. |
| Programador | Evalúa las reglas de alerta; es el componente que ejecuta consultas periódicas en los orígenes de datos. Solo se aplica a las reglas administradas por Grafana. |
| Alertmanager | Administra el enrutamiento y la agrupación de las instancias de alerta. |
| Regla de alerta | Un conjunto de criterios de evaluación para determinar cuándo debe activarse una regla de alerta. Una regla de alerta consta de una o más consultas y expresiones, una condición, la frecuencia de la evaluación y el tiempo durante el cual se cumple la condición. Una regla de alerta puede generar varias instancias de alerta. |
| Instancia de alerta | Una instancia de alerta es una instancia de una regla de alerta. Una regla de alerta unidimensional tiene una instancia de alerta. Una regla de alerta multidimensional tiene una o más instancias de alerta. Una sola regla de alerta que coincide con varios resultados, como un valor de CPU frente a 10 VMs, se cuenta como varias instancias de alerta (en este caso 10). Este número puede variar con el tiempo. Por ejemplo, una regla de alerta que monitorea el uso de la CPU para todos los VMs componentes de un sistema tiene más instancias de alerta a medida que VMs se van añadiendo. Para obtener más información acerca de las cuotas de las instancias de alerta, consulte [Errores de cuota alcanzada](alert-rules.md#rule-quota-reached). |
| Grupo de alertas | Alertmanager agrupa las instancias de alerta de forma predeterminada mediante las etiquetas de la política de notificaciones raíz. Esto controla la eliminación de duplicados y los grupos de instancias de alerta que se envían a los puntos de contacto. |
| Punto de contacto | Defina cómo se notifica a sus contactos cuando se activa una regla de alerta. |
| Plantillas de mensajes | Cree plantillas personalizadas reutilizables y utilícelas en los puntos de contacto. |
| Política de notificaciones | Conjunto de reglas sobre dónde, cuándo y cómo se agrupan las alertas y se dirigen a los puntos de contacto. |
| Etiquetas y comparadores de etiquetas | Las etiquetas identifican de forma unívoca a reglas de alerta. Vinculan las reglas de alerta con las políticas de notificaciones y los silencios, determinando qué política debe gestionarlos y qué reglas de alerta deben silenciarse. |
| Silencios | Detienen las notificaciones de una o más instancias de alerta. La diferencia entre un silencio y un temporizador de silencio es que el silencio dura un periodo de tiempo especificado, mientras que un temporizador de silencio se produce de forma periódica. Utiliza comparadores de etiquetas para silenciar las instancias de alerta. |
| Temporizadores de silencio | Especifique un intervalo de tiempo en el que no quiere que se generen o envíen nuevas notificaciones. Puede congelar las notificaciones de alerta durante periodos de tiempo recurrentes, por ejemplo, durante un periodo de mantenimiento. Deben estar vinculados a una política de notificaciones existente. |
## Orígenes de datos de alertas
Las alertas administradas por Grafana consultan los siguientes orígenes de datos de backend que tienen las alertas habilitadas.
+ Orígenes de datos integrados o desarrollados y mantenidos por Grafana: `Alertmanager`, `Graphite`, `Prometheus` (incluido Amazon Managed Service para Prometheus), `Loki`, `InfluxDB`, `Amazon OpenSearch Service`, `Google Cloud Monitoring`, `Amazon CloudWatch`, `Azure Monitor`, `MySQL`, `PostgreSQL`, `MSSQL`, `OpenTSDB`, `Oracle` y `Azure Monitor`.
## Alertas sobre datos numéricos
Los datos numéricos que no están en un formato de serie temporal pueden generar una alerta directamente o convertirse en expresiones del servidor. Esto permite un mayor procesamiento y, por lo tanto, una mayor eficiencia en el origen de datos, y también puede simplificar las reglas de alerta. Al alertar sobre datos numéricos en lugar de datos de serie temporal, no es necesario reducir cada serie temporal etiquetada a un solo número. En su lugar, los números etiquetados se devuelven a Grafana.
### Datos tabulares
Esta característica es compatible con los orígenes de datos de backend que consultan datos tabulares, incluidos los orígenes de datos de SQL, como MySQL, Postgres, MSSQL y Oracle.
Una consulta con alertas administradas por Grafana o expresiones del servidor se considera numérica con los siguientes orígenes de datos:
+ Si la opción `Format AS` está establecida en `Table` en la consulta del origen de datos.
+ Si la respuesta de la tabla devuelta a Grafana desde la consulta incluye solo una columna numérica (por ejemplo, int, double o float) y, opcionalmente, columnas de cadenas adicionales.
Si hay columnas de cadenas, esas columnas se convierten en etiquetas. El nombre de la columna pasa a ser el nombre de la etiqueta y el valor de cada fila pasa a ser el valor de la etiqueta correspondiente. Si se devuelven varias filas, cada fila debe identificarse de forma única por sus etiquetas.
### Ejemplo
Si tiene una tabla MySQL llamada Diskspace, como la siguiente.
| Time | Host | Disk | PercentFree |
| --- | --- | --- | --- |
| 2021-June-7 | web1 | /etc | 3 |
| 2021-June-7 | web2 | /var | 4 |
| 2021-June-7 | web3 | /var | 8 |
| … | … | … | … |
Para poder consultar los datos, filtre por tiempo, pero sin devolver la serie temporal a Grafana. Por ejemplo, una alerta que se iniciaría por host, disco cuando haya menos del 5 % de espacio libre podría tener el siguiente aspecto.
```
SELECT Host, Disk, CASE WHEN PercentFree < 5.0 THEN PercentFree ELSE 0 END FROM (
SELECT
Host,
Disk,
Avg(PercentFree)
FROM DiskSpace
Group By
Host,
Disk
Where __timeFilter(Time)
```
Esta consulta devuelve la siguiente respuesta de tabla a Grafana.
| Host | Disk | PercentFree |
| --- | --- | --- |
| web1 | /etc | 3 |
| web2 | /var | 4 |
| web3 | /var | 0 |
Cuando esta consulta se utiliza como **condición** en una regla de alerta, se genera una alerta en los casos en los que el valor es distinto de cero. Como resultado, se producen tres instancias de alerta, como se muestra en la siguiente tabla.
| Etiquetas | Status |
| --- | --- |
| \$1Host=web1,disk=/etc\$1 | Alertas |
| \$1Host=web2,disk=/var\$1 | Alertas |
| \$1Host=web3,disk=/var\$1 | Normal |
## Alertmanager
Grafana incluye compatibilidad integrada con la instancia de Alertmanager de Prometheus. Alertmanager ayuda a agrupar y administrar las reglas de alerta y agrega una capa de orquestación sobre los motores de alertas. De forma predeterminada, las notificaciones de las alertas administradas por Grafana las gestiona la instancia de Alertmanager incrustado que forma parte del núcleo de Grafana. Puede configurar los puntos de contacto, las políticas de notificaciones y las plantillas de la instancia de Alertmanager desde la interfaz de usuario de alertas de Grafana; para ello, seleccione la opción Grafana en el menú desplegable Alertmanager.
Las alertas de Grafana admiten la configuración de la instancia externa de Alertmanager (para obtener más información sobre Alertmanager como origen de datos externo, consulte [Conexión a un origen de datos de Alertmanager](data-source-alertmanager.md)). Al agregar una instancia externa de Alertmanager, en el menú desplegable Alertmanager se muestra una lista de los orígenes de datos de Alertmanager externos disponibles. Seleccione un origen de datos para crear y administrar las alertas para los orígenes de datos independientes de Cortex o Loki.
## Estado de las reglas de alerta
El estado de las reglas de alerta ayuda a comprender varios indicadores clave del estado de las alertas. Hay tres componentes clave: estado de alerta, estado de regla de alerta e integridad de regla de alerta. Aunque están relacionados, cada componente transmite información ligeramente diferente.
**Estado de regla de alerta**
+ **Normal**: ninguna de las series temporales devueltas por el motor de evaluación está en estado `Pending` o `Firing`.
+ **Pendiente**: al menos el estado de una de las series temporales devueltas por el motor de evaluación es `Pending`.
+ **Activándose**: al menos el estado de una de las series temporales devueltas por el motor de evaluación es `Firing`.
**Estado de alerta**
+ **Normal**: la condición de la regla de alerta **no se cumple** para cada serie temporal devuelta por el motor de evaluación.
+ **En alerta**: la condición de la regla de alerta **se cumple** durante al menos una serie temporal devuelta por el motor de evaluación. El periodo durante el cual la condición debe cumplirse antes de que se inicie una alerta, si se ha establecido, se cumple o se supera.
+ **Pendiente**: la condición de la regla de alerta **se cumple** durante al menos una serie temporal devuelta por el motor de evaluación. No se ha cumplido el periodo durante el cual la condición debe cumplirse antes de que se inicie una alerta, si se ha establecido.
+ **NoData**— La regla de alerta no ha devuelto una serie temporal, todos los valores de la serie temporal son nulos o todos los valores de la serie temporal son cero.
+ **Error**: se produce un error al intentar evaluar una regla de alerta.
**Integridad de regla de alerta**
+ **Correcto**: no hay ningún error al evaluar una regla de alerta.
+ **Error**: error al evaluar una regla de alerta.
+ **NoData**— La ausencia de datos en al menos una serie temporal devuelta durante la evaluación de una regla.
# Creación y administración de reglas de alerta de Grafana
****
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 los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).
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).
Una regla de alerta es un conjunto de criterios de evaluación que determinan si se inicia una alerta. La regla consta de una o más consultas y expresiones, una condición, la frecuencia de la evaluación y, opcionalmente, el tiempo durante el cual se cumple la condición.
Si bien las consultas y las expresiones seleccionan el conjunto de datos que se va a evaluar, una condición establece el umbral que una alerta debe alcanzar o superar para crear dicha alerta. Un intervalo especifica la frecuencia con la que se evalúa una regla de alertas. La duración, cuando se configura, indica durante cuánto tiempo debe cumplirse una condición. Las reglas también pueden definir el comportamiento de las alertas en ausencia de datos.
En las siguientes secciones se describen la creación y administración de diferentes tipos de reglas de alerta de Grafana.
**Topics**
+ [Creación de reglas de alerta administradas por Cortex o Loki](#create-alert-rule)
+ [Creación de reglas de registro administradas por Cortex o Loki](#create-alert-recording-rule)
+ [Creación de reglas de alerta administradas por Grafana](#create-grafana-alert-rule)
+ [Anotaciones y etiquetas para las reglas de alerta](#alert-rule-labels)
+ [Administración de reglas de alerta](#manage-alert-rules)
+ [Espacios de nombres y grupos de reglas de Cortex o Loki](#alert-rule-groups)
## Creación de reglas de alerta administradas por Cortex o Loki
Con Grafana, puede crear reglas de alerta para una instancia externa de Cortex o Loki.
**nota**
Cortex es la base de datos de serie temporal que utilizan Amazon Managed Service para Prometheus y los orígenes de datos de Prometheus.
**Requisitos previos**
+ Compruebe que tenga permisos de escritura en el origen de datos de Prometheus. De lo contrario, no podrá crear ni actualizar las reglas de alerta administradas por Cortex.
+ En el caso de los orígenes de datos de Cortex y Loki, habilite la API de regla configurando sus respectivos servicios.
+ **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.
+ **Cortex**: utilice el prefijo heredado `/api/prom`, no `/prometheus`. El origen de datos de Prometheus es compatible con Cortex y Prometheus, y Grafana espera que tanto la API de consulta como la API de regla 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**.
**Cómo agregar una regla de alerta administrada por Cortex o Loki**
1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**, en la que se muestran las alertas existentes.
1. Elija **Nueva regla de alerta**.
1. En el **Paso 1**, agregue el nombre, el tipo y la ubicación de almacenamiento de la regla, de la siguiente manera:
+ En **Nombre de la regla**, escriba un nombre descriptivo. 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.
+ En el menú desplegable **Tipo de regla**, seleccione **Alerta administrada por Cortex o Loki**.
+ En el menú desplegable **Seleccionar origen de datos**, seleccione un origen de datos de Prometheus o Loki.
+ En el menú desplegable **Espacio de nombres**, seleccione un espacio de nombres de reglas existente. En caso contrario, elija **Agregar nuevo** y escriba un nombre para crear uno. Los espacios de nombres pueden contener uno o más grupos de reglas y solo tienen un propósito organizativo. Para obtener más información, consulte [Espacios de nombres y grupos de reglas de Cortex o Loki](#alert-rule-groups).
+ En el menú desplegable **Grupo**, seleccione un grupo existente dentro del espacio de nombres seleccionado. En caso contrario, elija **Agregar nuevo** y escriba un nombre para crear uno. 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. En el **Paso 2**, agregue la consulta que desee evaluar.
El valor puede ser una expresión de PromQL o LogQL. La regla inicia una alerta si el resultado de la evaluación tiene al menos una serie con un valor superior a 0. Se crea una alerta para cada serie.
1. En el **Paso 3**, agregue condiciones.
En el cuadro de texto Durante de la condición, especifique el tiempo durante el cual la condición debe cumplirse antes de que se inicie la alerta. Si especifica `5m`, las condiciones deben cumplirse durante cinco minutos antes de que se inicie la alerta.
**nota**
Cuando se cumple 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`. Si ya no se cumple, vuelve al estado `Normal`.
1. En el **Paso 4**, agregue metadatos adicionales asociados a la regla.
+ Agregue una descripción y un resumen para personalizar los mensajes de alerta. Utilice las directrices de [Anotaciones y etiquetas para las reglas de alerta](#alert-rule-labels).
+ Agrega la URL, el panel, el panel y la alerta IDs de Runbook.
+ Agregue etiquetas personalizadas.
1. Elija **Vista previa de alertas** para evaluar la regla y ver qué alertas generaría. Muestra una lista de alertas con el estado y el valor de cada una.
1. Seleccione **Guardar** para guardar la regla o **Guardar y salir** para guardar la regla y volver a la página **Alertas**.
## Creación de reglas de registro administradas por Cortex o Loki
Puede crear y administrar reglas de registro para una instancia externa de Cortex 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.
**Requisitos previos**
En el caso de los orígenes de datos de Cortex y Loki, habilite la API de regla configurando sus respectivos servicios.
+ **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.
+ **Cortex**: al configurar un origen de datos de Prometheus de Grafana para que se dirija a Cortex, utilice el prefijo heredado `/api/prom`, no `/prometheus`. El origen de datos de Prometheus es compatible con Cortex y Prometheus, y Grafana espera que tanto la API de consulta como la API de regla 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**.
**Cómo agregar una regla de registro administrada por Cortex o Loki**
1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**, en la que se muestran las alertas existentes.
1. Elija **Nueva regla de alerta**.
1. En el **Paso 1**, agregue el nombre, el tipo y la ubicación de almacenamiento de la regla de la siguiente manera.
+ En **Nombre de la regla**, escriba un nombre descriptivo. 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.
+ En el menú desplegable **Tipo de regla**, seleccione **Alerta administrada por Cortex o Loki**.
+ En el menú desplegable **Seleccionar origen de datos**, seleccione un origen de datos de Prometheus o Loki.
+ En el menú desplegable **Espacio de nombres**, seleccione un espacio de nombres de reglas existente. En caso contrario, elija **Agregar nuevo** y escriba un nombre para crear uno. Los espacios de nombres pueden contener uno o más grupos de reglas y solo tienen un propósito organizativo. Para obtener más información, consulte [Espacios de nombres y grupos de reglas de Cortex o Loki](#alert-rule-groups).
+ En el menú desplegable **Grupo**, seleccione un grupo existente dentro del espacio de nombres seleccionado. En caso contrario, elija **Agregar nuevo** y escriba un nombre para crear uno. 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. En el **Paso 2**, agregue la consulta que desee evaluar.
El valor puede ser una expresión de PromQL o LogQL. La regla inicia una alerta si el resultado de la evaluación tiene al menos una serie con un valor superior a 0. Se crea una alerta para cada serie.
1. En el **Paso 3**, agregue metadatos adicionales asociados a la regla.
+ Agregue una descripción y un resumen para personalizar los mensajes de alerta. Utilice las directrices de [Anotaciones y etiquetas para las reglas de alerta](#alert-rule-labels).
+ Agrega la URL, el panel, el panel y la alerta de Runbook. IDs
+ Agregue etiquetas personalizadas.
1. Seleccione **Guardar** para guardar la regla o **Guardar y salir** para guardar la regla y volver a la página **Alertas**.
## Creación de reglas de alerta administradas por Grafana
Grafana le permite crear reglas de alerta que consultan uno o más orígenes de datos, reducen o transforman los resultados y los comparan entre sí o para fijar umbrales. Cuando se procesan, Grafana envía notificaciones al punto de contacto.
**nota**
La creación de reglas de alerta administradas por Grafana mientras se utilizan las alertas de Grafana hace que se envíen varias notificaciones cuando la regla coincide. Es posible que algunos proveedores de puntos de contacto tengan opciones configurables para eliminar las notificaciones duplicadas.
**Adición de una regla administrada por Grafana**
1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**, en la que se muestran las alertas existentes.
1. Elija **Nueva regla de alerta**.
1. En el **Paso 1**, agregue el nombre, el tipo y la ubicación de almacenamiento de la regla, de la siguiente manera:
+ En **Nombre de la regla**, escriba un nombre descriptivo. 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.
+ En el menú desplegable **Tipo de regla**, seleccione **Alerta administrada por Grafana**.
+ En el menú desplegable **Carpeta**, seleccione la carpeta en la que quiere almacenar la regla. Si no selecciona ninguna carpeta, la regla se almacena en la carpeta `General`. Para crear una carpeta, seleccione el menú desplegable y escriba un nuevo nombre de carpeta.
1. En el **Paso 2**, agregue las consultas y expresiones que desee evaluar.
+ Mantenga el nombre predeterminado o coloque el cursor del ratón sobre el icono de edición y selecciónelo para cambiar el nombre.
+ En el caso de las consultas, seleccione un origen de datos del menú desplegable.
+ Agregue una o más [consultas](panel-queries.md) o expresiones (para obtener más información sobre las expresiones, consulte [Expressions](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) en la *documentación de Grafana*).
+ 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 alertas independientes para cada serie. Para obtener más información sobre estas opciones, consulte [Reglas unidimensionales y multidimensionales](#single-multi-rule).
+ Elija **Ejecutar consultas** para comprobar que la consulta se completa correctamente.
1. En el **Paso 3**, agregue condiciones.
+ En el menú desplegable **Condición**, seleccione la consulta o expresión para iniciar la regla de alerta.
+ En **Evaluar cada**, especifique la frecuencia de la evaluación. Debe ser un múltiplo de 10 segundos. Por ejemplo, `1m`, `30s`.
+ En **Evaluar durante**, especifique el tiempo durante el cual la condición debe cumplirse antes de que se inicie una alerta.
**nota**
Cuando se infringe una condición, la alerta pasa al estado `Pending`. Si la condición permanece infringida durante el tiempo especificado, la alerta pasa al estado `Firing`. Si ya no se cumple, vuelve al estado `Normal`.
+ En **Configurar la gestión de errores y ausencia de datos**, configure el comportamiento de las alertas en ausencia de datos. Siga las directrices de [Gestión de casos de error o ausencia de datos](#rule-no-data-error).
+ Elija **Vista previa de alertas** para comprobar el resultado de la ejecución de la consulta en este momento. La vista previa excluye las condiciones de gestión de errores y ausencia de datos.
1. En el **Paso 4**, agregue metadatos adicionales asociados a la regla.
+ Agregue una descripción y un resumen para personalizar los mensajes de alerta. Utilice las directrices de [Anotaciones y etiquetas para las reglas de alerta](#alert-rule-labels).
+ Agrega la URL, el panel, el panel y la alerta de Runbook. IDs
+ Agregue etiquetas personalizadas.
1. Seleccione **Guardar** para guardar la regla o **Guardar y salir** para guardar la regla y volver a la página **Alertas**.
### Reglas unidimensionales y multidimensionales
En el caso de las reglas de alerta administradas por Grafana, puede crear una regla con una condición clásica o puede crear una regla multidimensional.
**Regla unidimensional única (condición clásica)**
Utilice una expresión de condición clásica para crear una regla que inicie 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.
Para obtener más información sobre cómo dar formato a las expresiones, consulte [Expressions](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) en la *documentación de Grafana*.
**Regla multidimensional**
Para generar una instancia de alerta independiente para cada serie devuelta en la consulta, cree una regla multidimensional.
**nota**
Cada instancia de alerta generada por una regla multidimensional se tiene en cuenta para la cuota total de alertas. Las reglas no se evalúan cuando alcanza su cuota de alertas. Para obtener más información sobre las cuotas de reglas multidimensionales, consulte [Errores de cuota alcanzada](#rule-quota-reached).
Para crear varias instancias a partir de una sola regla, utilice las expresiones `Math`, `Reduce` o `Resample` para crear una regla multidimensional. Por ejemplo, puede hacer lo siguiente:
+ Agregue una expresión `Reduce` para cada consulta a fin de agregar los valores del intervalo de tiempo seleccionado en un solo valor. (No es necesario para las [reglas que utilizan datos numéricos](alert-fundamentals.md#alert-numeric)).
+ Agregue una expresión `Math` con la condición de la regla. Esto no es necesario si una consulta o una expresión de reducción ya devuelven 0 si la regla no debe iniciar una alerta o un número positivo si debe iniciar una alerta.
Presentamos algunos ejemplos:
+ `$B > 70`si debe iniciar una alerta en caso de que el valor de B query/expression sea superior a 70.
+ `$B < $C * 100` en caso de que deba iniciar una alerta 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 la página de la comunidad [Template variables are not supported in alert queries while setting up Alert](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514).
**Consideraciones sobre el rendimiento de las reglas multidimensionales**
Cada instancia de alerta se tiene en cuenta para la cuota de alertas. Las reglas multidimensionales que crean más instancias de las que se pueden incluir en la cuota de alertas no se evalúan y devuelven un error de cuota. Para obtener más información, consulte [Errores de cuota alcanzada](#rule-quota-reached).
Las alertas multidimensionales pueden tener un gran impacto en el rendimiento de su espacio de trabajo de Grafana, así como en el rendimiento de sus orígenes de datos, ya que Grafana las consulta para evaluar sus reglas de alerta. Las siguientes consideraciones pueden resultarle útiles a la hora de optimizar el rendimiento de su sistema de supervisión.
+ **Frecuencia de evaluación de las reglas**: la propiedad **Evaluar cada** de una regla de alerta controla la frecuencia de la evaluación de las reglas. Le recomendamos que utilice la frecuencia de evaluación más baja aceptable.
+ **Cardinalidad del conjunto de resultados**: el número de instancias de alerta que se crean con una regla afecta a su rendimiento. Supongamos que está supervisando los errores de respuesta de la API en todas las rutas de la API y en todas las máquinas virtuales de su flota. Este conjunto tiene una cardinalidad del número de rutas multiplicado por el número de VMs. Para reducir la cardinalidad del conjunto de resultados, por ejemplo, puede supervisar el total de errores por máquina virtual en lugar de por ruta por máquina virtual.
+ **Complejidad de la consulta**: las consultas que los orígenes de datos pueden procesar y responder rápidamente consumen menos recursos. Si bien esta consideración es menos importante que las demás consideraciones enumeradas anteriormente, si las ha reducido en la medida de lo posible, analizar el rendimiento de las consultas individuales podría marcar la diferencia. Debe ser consciente del impacto sobre el rendimiento que la evaluación de estas reglas tiene en sus orígenes de datos. La gran mayoría de las consultas gestionadas por las bases de datos de supervisión suelen ser consultas de alertas, por lo que se ven afectadas por los mismos factores de carga que afectan a la instancia de Grafana.
### Errores de cuota alcanzada
Hay una cuota del número de instancias de alerta que puede tener en un único espacio de trabajo. Cuando alcance ese número, ya no podrá crear nuevas reglas de alerta en ese espacio de trabajo. Con las alertas multidimensionales, el número de instancias de alerta puede variar con el tiempo.
Es importante recordar lo siguiente al trabajar con instancias de alerta.
+ Si solo crea reglas unidimensionales, cada regla es una instancia de alerta única. Puede crear el mismo número de reglas en un único espacio de trabajo que su cuota de instancias de alerta, no más.
+ Las reglas multidimensionales crean varias instancias de alerta; sin embargo, el número no se conoce hasta que se evalúan. Por ejemplo, si crea una regla de alerta que hace un seguimiento del uso de la CPU de sus instancias de Amazon EC2, puede que haya 50 instancias de EC2 cuando la cree (y, por lo tanto, 50 instancias de alerta), pero si agrega 10 instancias de EC2 más una semana después, la siguiente evaluación tendrá 60 instancias de alerta.
El número de instancias de alerta se evalúa al crear una alerta multidimensional y no se puede crear una que le haga superar inmediatamente la cuota de instancias de alerta. Como el número de instancias de alerta puede cambiar, la cuota se comprueba cada vez que se evalúan las reglas.
+ En el momento de la evaluación de las reglas, si una regla hace que supere su cuota de instancias de alerta, esa regla no se evaluará hasta que se actualice la regla de alerta para situar el recuento total de instancias de alerta por debajo de la cuota de servicio. Cuando esto ocurre, recibe una notificación de alerta en la que se le informa de que se ha alcanzado su cuota (la notificación utiliza la política de notificaciones de la regla que se está evaluando). La notificación incluye una anotación `Error` con el valor `QuotaReachedError`.
+ Una regla que provoca un error `QuotaReachedError` deja de evaluarse. La evaluación solo se reanuda cuando se efectúa una actualización y la evaluación posterior a la actualización no provoca por sí sola un error `QuotaReachedError`. Una regla que no se está evaluando muestra el error **Cuota alcanzada** en la consola de Grafana.
+ Para reducir el número de instancias de alerta, puede eliminar las reglas de alerta o editar las alertas multidimensionales para tener menos instancias de alerta (por ejemplo, tener una alerta de errores por máquina virtual, en lugar de una alerta de error por API en una máquina virtual).
+ Para reanudar las evaluaciones, actualice la alerta y guárdela. Puede actualizarla para reducir el número de instancias de alerta o, si ha aplicado otros cambios para reducir el número de instancias de alerta, puede guardarla sin cambios. Si es posible, se reanudará. Si provoca otro error `QuotaReachedError`, no podrá guardarla.
+ Cuando se guarda una alerta y se reanuda la evaluación sin superar la cuota de alertas, el error **Cuota alcanzada** puede seguir apareciendo en la consola de Grafana durante algún tiempo (hasta su intervalo de evaluación). Sin embargo, la evaluación de la regla de alerta comienza y las alertas se envían si se alcanza el umbral de la regla.
+ Para obtener más información sobre la cuota de alertas, así como sobre otras cuotas, consulte [Cuotas de servicio de Amazon Managed Grafana](AMG_quotas.md).
### Gestión de casos de error o ausencia de datos
Elija opciones para gestionar el comportamiento de las alertas en ausencia de datos o cuando haya errores.
En la siguiente tabla, se muestran las opciones para gestionar la ausencia de datos.
| Opción Sin datos | Comportamiento |
| --- | --- |
| Sin datos | Cree una alerta `DatasourceNoData` con el nombre y el UID de la regla de alerta y el UID del origen de datos que no devolvió ningún dato como etiquetas. |
| Alertas | Defina el estado de la regla de alerta en `Alerting`. |
| OK | Defina el estado de la regla de alerta en `Normal`. |
En la siguiente tabla, se muestran las opciones para gestionar los casos de error.
| Opción de error o tiempo de espera | Comportamiento |
| --- | --- |
| Alertas | Defina el estado de la regla de alerta en `Alerting`. |
| OK | Defina el estado de la regla de alerta en `Normal`. |
| Error | Cree una alerta `DatasourceError` con el nombre y el UID de la regla de alerta y el UID del origen de datos que no devolvió ningún dato como etiquetas. |
## Anotaciones y etiquetas para las reglas de alerta
Las anotaciones y las etiquetas son pares de clave-valor asociados a las alertas que se originan a partir de la regla de alerta, la respuesta del origen de datos y como resultado de la evaluación de la regla de alerta. Se pueden usar directamente en las notificaciones de alertas o en [plantillas](alert-message-templates.md) y [funciones de plantillas](alert-message-templates.md#alert-template-functions) para crear contactos de notificación de forma dinámica.
**Annotations**
Las anotaciones son pares de clave-valor que proporcionan información adicional sobre una alerta. Puede utilizar las siguientes anotaciones: `description`, `summary`, `runbook_url`, `alertId`, `dashboardUid` y `panelId`. Se muestran en los detalles de las reglas y alertas en la interfaz de usuario y se pueden usar en las plantillas de mensajes de puntos de contacto.
**Etiquetas**
Las etiquetas son pares de clave-valor que contienen información sobre una alerta. El conjunto de etiquetas para una alerta se genera y se agrega a lo largo del proceso de evaluación y notificación de la alerta. Se usan de las siguientes maneras.
+ El conjunto completo de etiquetas para una alerta identifica de forma única a esa alerta dentro de las alertas de Grafana.
+ El Alertmanager utiliza etiquetas para hacer coincidir las alertas con los [silencios](alert-silences.md) y los [grupos de alertas](alert-groups.md) en las [políticas de notificaciones](alert-notifications.md).
+ En la interfaz de usuario de alertas se muestran etiquetas para cada instancia de alerta generada por la evaluación de esa regla.
+ Los puntos de contacto pueden acceder a las etiquetas para generar dinámicamente notificaciones que contienen información específica de la alerta que está dando lugar a una notificación.
+ Se pueden agregar etiquetas a una [regla de alerta](#alert-rules). Estas etiquetas configuradas manualmente pueden utilizar funciones de plantilla y hacer referencia a otras etiquetas. Las etiquetas agregadas a una regla de alerta aquí tienen prioridad en caso de colisión entre etiquetas.
Las siguientes variables de plantilla están disponibles al expandir anotaciones y etiquetas.
| Name | Description (Descripción) |
| --- | --- |
| `$labels` | Etiquetas de la consulta o condición. Por ejemplo, `{{ $labels.instance }}` y `{{ $labels.job }}`. No está disponible cuando la regla usa una condición clásica. |
| `$values` | Valores de todas las expresiones de reducción y matemáticas que se evaluaron para esta regla de alerta. Por ejemplo `{{ $values.A }}`, `{{ $values.A.Labels }}` y `{{ $values.A.Value }}` donde `A` es el valor de `refID` de la expresión. No está disponible cuando la regla usa una condición clásica. |
| `$value` | Cadena de valores de la instancia de alerta. Por ejemplo, `[ var='A' labels={instance=foo} value=10 ]`. |
## Administración de reglas de alerta
En la página **Alertas** se muestran las reglas de alerta. De forma predeterminada, las reglas se agrupan por tipos de orígenes de datos. En la sección **Grafana** se indican las reglas administradas por Grafana y en la sección **Cortex o Loki**, las reglas para los orígenes de datos compatibles con Prometheus. Puede ver las reglas de alertas de los orígenes de datos compatibles con Prometheus, pero no puede editarlas.
### Visualización de reglas de alertas
Con las alertas de Grafana, puede ver todas sus alertas en una página.
**Visualización de detalles de las alertas**
1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**. De forma predeterminada, las reglas se muestran en grupos por tipo de origen de datos. También puede consultarlas según el estado actual de cada alerta (se describen con más detalle en el texto siguiente).
1. En **Ver como**, puede alternar entre las vistas de grupo y de estado mediante la elección de la opción que prefiera.
1. Seleccione la flecha situada junto a una fila para ver más detalles de esa fila. Los detalles de una regla incluyen las etiquetas de la regla, las anotaciones, los orígenes de datos y las consultas, así como una lista de las instancias de alerta resultantes de la regla.
**Vista de grupo**
En la vista de grupo se muestran las reglas de alerta de Grafana agrupadas por carpeta y las reglas de alerta de Loki o Prometheus agrupadas por `namespace` y `group`. Esta es la vista de lista de reglas predeterminada, destinada a administrar las reglas. Puede expandir cada grupo para ver una lista de las reglas de este grupo. Expanda una regla para ver sus detalles. También puede expandir los botones de acción y las alertas resultantes de la regla para ver sus detalles.
**Vista de estado**
En la vista de estado se muestran las reglas de alerta agrupadas por estado. Utilice esta vista para obtener información general de qué reglas se encuentran en qué estado. Se puede expandir cada regla para ver sus detalles. Los botones de acción, las alertas generadas por esta regla y las alertas se pueden expandir aún más para ver sus detalles.
**Filtrado de las reglas de alerta**
Puede filtrar las reglas de alerta que aparecen en la página **Alertas** de varias maneras.
+ Puede filtrarlas para mostrar las reglas que consultan un origen de datos específica; para ello, elija **Seleccionar orígenes de datos** y, a continuación, seleccione un origen de datos por el que filtrar.
+ Puede filtrarlas por etiquetas; para ello, seleccione los criterios de búsqueda en **Buscar por etiqueta**. Algunos criterios de ejemplo incluyen `environment=production`, `region=~US|EU` o `severity!=warning`.
+ Puede filtrarlas para mostrar las reglas en un estado específico; para ello, seleccione **Filtrar alertas por estado** y, a continuación, seleccione el estado que desee ver.
### Edición o eliminación de reglas de alerta
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. Los usuarios con roles de editor o administrador pueden editar o eliminar las reglas de alerta de una instancia externa de Cortex o Loki.
**Edición o eliminación de una regla**
1. Expanda una regla hasta que pueda ver los controles de reglas **Ver**, **Editar** y **Eliminar**.
1. Elija **Editar** para abrir la página de creación de reglas. Efectúe las actualizaciones de la misma manera que crea una regla. Para obtener información más detallada, consulte las instrucciones que se describen en [Creación de reglas de alerta administradas por Grafana](#create-grafana-alert-rule) o [Creación de reglas de alerta administradas por Cortex o Loki](#create-alert-rule).
1. Si lo desea, elija **Eliminar** para eliminar una regla.
## Espacios de nombres y grupos de reglas de Cortex o Loki
Puede organizar sus reglas. Las reglas se crean dentro de grupos de reglas y los grupos de reglas se organizan en espacios de nombres. Las reglas de un grupo de reglas se ejecutan secuencialmente a intervalos regulares. El intervalo predeterminado es de un minuto. Puede cambiar los espacios de nombres y grupos de reglas de Cortex o Loki y editar los intervalos de evaluación de los grupos de reglas.
**Edición de un espacio de nombres o grupo de reglas**
1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**.
1. Vaya a una regla del grupo de reglas o del espacio de nombres que desea editar.
1. Elija el icono **Editar** (lápiz).
1. Haga cambios en el grupo de reglas o en el espacio de nombres.
**nota**
En el caso de los espacios de nombres, solo se puede editar el nombre. En el caso de los grupos de reglas, cambia el nombre o el intervalo de evaluación de las reglas del grupo. Por ejemplo, puede elegir `1m` para que las reglas se evalúen una vez por minuto o `30s` para que se evalúen una vez cada 30 segundos.
1. Seleccione **Save changes (Guardar cambios)**.
# Grupos de alertas
****
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 los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).
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).
Los grupos de alertas muestran alertas agrupadas de una instancia de Alertmanager. De forma predeterminada, las alertas se agrupan según las claves de etiqueta de la política raíz en [Uso de políticas de notificaciones](alert-notifications.md). Al agrupar las alertas comunes en un solo grupo de alertas, se evita que se inicien alertas duplicadas.
**Visualización de las agrupaciones de alertas**
1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) y, a continuación, haga clic en el elemento **Agrupación de alertas** para abrir la página en la que se muestran las alertas existentes.
1. En el menú desplegable **Alertmanager**, seleccione una instancia externa de Alertmanager como origen de datos. De forma predeterminada, está seleccionado la instancia de Alertmanager de `Grafana`.
1. En el menú desplegable **Grupo personalizado por**, seleccione una combinación de etiquetas para ver una agrupación distinta de la predeterminada. Puede utilizar esta vista para depurar o verificar la agrupación de políticas de notificaciones.
Las alertas sin etiquetas especificadas en la agrupación de la política raíz o en la agrupación personalizada se agregan a un grupo con un encabezado de `No grouping`.
**Filtración de alertas**
Puede usar los siguientes filtros para ver las alertas que coincidan con criterios específicos:
+ **Buscar por etiqueta**: en **Búsqueda**, ingrese una etiqueta existente para ver las alertas que coincidan con la etiqueta. Por ejemplo, `environment=production`, `region=~US|EU`, `severity!=warning`.
+ **Filtrar las alertas por estado**: en **Estados**, seleccione uno de los estados (`Active`, `Suppressed` o `Unprocessed`) para ver las alertas que correspondan a ese estado.
# Silenciamiento de las notificaciones de alertas para los orígenes de datos de Prometheus
****
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 los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).
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).
En el caso de los orígenes de datos externos de Alertmanager (incluido Amazon Managed Service para Prometheus), puede suprimir las notificaciones de alertas con un *silencio*. Un silencio solo impide que se creen notificaciones; los silencios no impiden que se evalúen las reglas de alerta ni impiden que las instancias de alerta se muestren en la interfaz de usuario. Al silenciar una alerta, se especifica un periodo de tiempo para que se suprima.
Puede configurar los silencios del origen de datos de un Alertmanager externo.
**nota**
Para suprimir las notificaciones de alertas a intervalos de tiempo regulares (por ejemplo, durante los periodos de mantenimiento habituales), utilice [Temporizadores de silencio](alert-notifications.md#alert-notification-muting) en lugar de silencios.
**Adición de un silencio**
1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**.
1. Seleccione **Silencios** para abrir una página con una lista de los [puntos de contacto](alert-contact-points.md) existentes.
1. Elija el Alertmanager externo en el menú desplegable **Alertmanager**.
1. Seleccione **Nuevo silencio**.
1. Seleccione la fecha de inicio y finalización en **Inicio y finalización del silencio** para indicar cuándo debe entrar en vigor el silencio y cuándo debe terminar.
Como alternativa a establecer una hora de finalización, en **Duración**, especifique durante cuánto tiempo se aplicará el silencio. Esto actualiza automáticamente la hora de finalización en el campo **Inicio y finalización del silencio**.
1. En los campos **Nombre** y **Valor**, ingrese una o más *etiquetas coincidentes*. Los comparadores determinan a qué reglas se aplica el silencio. A continuación, se analiza con más detalle la coincidencia de etiquetas siguiendo este procedimiento.
1. Si lo desea, agregue un **comentario** o modifique el **creador** para establecer el propietario del silencio.
**Coincidencia de etiquetas para suprimir alertas**
Al crear un silencio, crea un conjunto de *etiquetas coincidentes* como parte del silencio. Se trata de un conjunto de reglas sobre las etiquetas que deben coincidir para que se suprima la alerta. Las etiquetas coincidentes constan de tres partes:
+ **Etiqueta**: nombre de la etiqueta que debe coincidir. Debe coincidir exactamente con el nombre de la etiqueta de la alerta.
+ **Operador**: operador utilizado para comparar el valor de la etiqueta con el valor de la etiqueta coincidente. 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 una cadena o como una expresión regular, según el operador elegido.
Un silencio finaliza en la fecha de finalización indicada, pero puede finalizar la supresión manualmente en cualquier momento.
**Finalización manual de un silencio**
1. En la página **Alertas**, seleccione **Silencios** para ver la lista de los silencios existentes.
1. Seleccione el silencio que quiere finalizar y elija **Desactivar silencio**. Esto pone fin a la supresión de alertas.
**nota**
La desactivación del silencio finaliza la supresión de alertas, como si la hora de finalización estuviera configurada para la hora actual. Los silencios que han finalizado (automática o manualmente) se conservan y se enumeran durante cinco días. No puede eliminar un silencio de la lista manualmente.
**Creación de un enlace al formulario de creación de silencios**
Puede crear una URL para el formulario de creación de silencios con los detalles ya rellenados. Los operadores pueden usarlo para suprimir rápidamente una alarma durante un evento operativo.
Al crear un enlace a un formulario de silencio, utilice un parámetro de consulta `matchers` para especificar las etiquetas coincidentes y un parámetro de consulta `comment` para especificar un comentario. El parámetro `matchers` requiere uno o más valores en formato `[label][operator][value]`, separados por comas.
**URL de ejemplo**
Para enlazar a un formulario de silencios, con etiquetas coincidentes `severity=critical` y `cluster!~europe-.*` con un comentario que ponga `Silencing critical EU alerts`, utilice una URL como la siguiente. *mygrafana*Sustitúyalo por el nombre de host de tu instancia de Grafana.
```
https://mygrafana/alerting/silence/new?matchers=severity%3Dcritical%2Ccluster!~europe-*&comment=Silence%20critical%20EU%20alert
```
Para enlazar a una nueva página de silencios de un Alertmanager externo, agregue un parámetro de consulta `alertmanager` con el nombre del origen de datos del Alertmanager, como `alertmanager=myAlertmanagerdatasource`.
# Uso de puntos de contacto
****
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 los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).
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).
Utilice los puntos de contacto para definir cómo se notifica a sus contactos cuando se inicia una alerta. Un punto de contacto puede tener uno o más tipos de puntos de contacto, por ejemplo, Amazon Simple Notification Service o Slack. Cuando se inicia una alerta, se envía una notificación a todos los tipos de puntos de contacto listados para un punto de contacto. Si lo desea, puede usar [Uso de plantillas de mensajes](alert-message-templates.md) para personalizar los mensajes de notificación para los tipos de puntos de contacto.
**nota**
Puede crear y editar puntos de contacto para las alertas administradas por Grafana. Los puntos de contacto para las alertas de Alertmanager son de solo lectura.
## Uso de puntos de contacto
Los procedimientos que aparecen a continuación le muestran cómo agregar, editar, probar y eliminar puntos de contacto.
**Cómo agregar un punto de contacto**
1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**.
1. Seleccione **Puntos de contacto** y, a continuación, **Nuevo punto de contacto**.
1. En el menú desplegable **Alertmanager**, seleccione un Alertmanager. De forma predeterminada, está seleccionado Grafana Alertmanager.
1. Ingrese un **nombre** para el punto de contacto.
1. En **Tipo de punto de contacto**, elija un tipo y 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ó, si lo desea, 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. Si su punto de contacto necesita más tipos de puntos de contacto, puede elegir **Nuevo tipo de punto de contacto** y repetir los pasos para cada tipo de punto de contacto que necesite.
1. Elija **Guardar punto de contacto** para guardar los cambios.
**Edición de un punto de contacto**
1. Elija **Puntos de contacto** para ver una lista de los puntos de contacto existentes.
1. Seleccione el punto de contacto que desee editar y, a continuación, seleccione el icono **Editar** (lápiz).
1. Haga los cambios necesarios y, a continuación, seleccione **Guardar punto de contacto** para guardar los cambios.
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. Elija **Puntos de contacto** para abrir la lista de los puntos de contacto existentes.
1. Seleccione el punto de contacto que desee probar y, a continuación, seleccione el icono **Editar** (lápiz).
1. Seleccione el icono **Probar** (avión de papel).
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.
Puede eliminar los puntos de contacto que la política de notificaciones no esté utilizando.
**Eliminación de un punto de contacto**
1. Elija **Puntos de contacto** para abrir la lista de los puntos de contacto existentes.
1. Seleccione el punto de contacto que desee eliminar y, a continuación, seleccione el icono **Eliminar** (papelera).
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.
## Lista de los notificadores admitidos
| Name | Tipo |
| --- | --- |
| Amazon SNS | sns |
| OpsGenie | opsgenie |
| PagerDuty | pagerduty |
| Slack | slack |
| VictorOps | victorops |
# Uso de plantillas de mensajes
****
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 los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).
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).
Las notificaciones que se envían a través de [Uso de puntos de contacto](alert-contact-points.md) se crean mediante *plantillas de mensajes*. Las plantillas predeterminadas de Grafana se basan en el [sistema de plantillas de Go](https://golang.org/pkg/text/template), en el que algunos campos se evalúan como texto, mientras que otros se evalúan como HTML (lo que puede afectar al escape).
Como la mayoría de los campos de puntos de contacto pueden tener plantillas, puede crear plantillas personalizadas reutilizables y utilizarlas en varios puntos de contacto. En el tema [Datos de plantilla](#alert-template-data) se enumeran las variables que están disponibles para la creación de plantillas.
**Uso de plantillas**
Las plantillas se utilizan para crear un mensaje. Por ejemplo, con un mensaje de alerta de Slack, puede establecer el título y el cuerpo del punto de contacto. En el siguiente ejemplo se muestra cómo usar las plantillas predeterminadas para crear un título que contenga un recuento de las alertas que se están activando y que están resueltas, y un cuerpo que muestre las alertas y sus estados.
+ **Título**:
```
{{ len .Alerts.Firing }} firing, {{ len .Alerts.Resolved }} resolved
```
+ **Cuerpo del texto**:
```
{{ range .Alerts }}{{ .Status }}: {{ .Labels.alertname }}
{{end }}
```
Puede crear sus propias plantillas personalizadas, como en el ejemplo siguiente.
+ **Título**:
```
{{ template "slack.default.title" .}}
```
+ **Cuerpo del texto**:
```
{{ template "mymessage" .}}
```
A continuación se muestra una plantilla de ejemplo.
```
{{ define "myalert" }}
[{{.Status}}] {{ .Labels.alertname }}
Labels:
{{ range .Labels.SortedPairs }}
{{ .Name }}: {{ .Value }}
{{ end }}
{{ if gt (len .Annotations) 0 }}
Annotations:
{{ range .Annotations.SortedPairs }}
{{ .Name }}: {{ .Value }}
{{ end }}
{{ end }}
{{ if gt (len .SilenceURL ) 0 }}
Silence alert: {{ .SilenceURL }}
{{ end }}
{{ if gt (len .DashboardURL ) 0 }}
Go to dashboard: {{ .DashboardURL }}
{{ end }}
{{ end }}
```
Los procedimientos que aparecen a continuación le muestran cómo crear, editar y eliminar plantillas de mensajes personalizadas.
**Creación de una plantilla de mensaje**
1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**.
1. Seleccione **Puntos de contacto**.
1. En el menú desplegable **Alertmanager**, seleccione la instancia de Alertmanager para la que quiere crear una plantilla de mensaje. La predeterminada es la instancia de Alertmanager de Grafana.
1. Elija **Agregar plantilla**.
1. Indique un **nombre** descriptivo.
1. Agregue el **contenido** de la plantilla, por ejemplo:
```
{{ define "mymessage" }}
{{ range .Alerts }}
[{{ .Status }}] {{ range .Labels }} {{ .Name }}={{.Value }}{{end}}
{{ end }}
{{ end }}
```
La etiqueta `define` de la sección de contenido asigna el nombre de la plantilla. Esta etiqueta es opcional y, si se omite, el nombre de la plantilla se deriva del campo **Nombre**. Cuando se especifican ambas, se recomienda mantenerlas iguales.
1. Elija **Guardar plantilla**.
**nota**
El HTML de las plantillas de mensajes de alerta se representa como texto, con los caracteres de control escapados. Grafana no admite la representación de HTML en la notificación resultante.
**Edición de una plantilla de mensaje**
1. En la página **Alertas**, elija **Puntos de contacto** para abrir la lista de puntos de contacto.
1. En la **tabla de plantillas**, busque la plantilla que desee editar y, a continuación, seleccione el icono **Editar** (lápiz).
1. Haga sus cambios y, a continuación, elija **Guardar**.
**Eliminación de una plantilla de mensaje**
1. En la página **Alertas**, elija **Puntos de contacto** para abrir la lista de puntos de contacto.
1. En la **tabla de plantillas**, busque la plantilla que desea eliminar y, a continuación, seleccione el icono **Eliminar** (papelera).
1. Elija **Sí, eliminar** para eliminar la plantilla.
**Plantillas anidadas**
Puede incrustar plantillas dentro de otras plantillas.
Por ejemplo, puede definir un fragmento de plantilla mediante la palabra clave `define`:
```
{{ define "mytemplate" }}
{{ len .Alerts.Firing }} firing. {{ len .Alerts.Resolved }} resolved.
{{ end }}
```
A continuación, puede incrustar plantillas personalizadas en este fragmento mediante la palabra clave `template`. Por ejemplo:
```
Alert summary:
{{ template "mytemplate" . }}
```
Puede utilizar las siguientes opciones de plantilla integradas para incrustar plantillas personalizadas.
| Name | Notas |
| --- | --- |
| `default.title` | Muestra información general de estado. |
| `default.message` | Proporciona un resumen con formato de las alertas que se están activando y que están resueltas. |
**Ejemplos de plantillas personalizadas**
Estos son algunos ejemplos de cómo usar plantillas personalizadas.
Plantilla para representar una sola alerta:
```
{{ define "myalert" }}
[{{.Status}}] {{ .Labels.alertname }}
Labels:
{{ range .Labels.SortedPairs }}
{{ .Name }}: {{ .Value }}
{{ end }}
{{ if gt (len .Annotations) 0 }}
Annotations:
{{ range .Annotations.SortedPairs }}
{{ .Name }}: {{ .Value }}
{{ end }}
{{ end }}
{{ if gt (len .SilenceURL ) 0 }}
Silence alert: {{ .SilenceURL }}
{{ end }}
{{ if gt (len .DashboardURL ) 0 }}
Go to dashboard: {{ .DashboardURL }}
{{ end }}
{{ end }}
```
Plantilla para representar el mensaje de notificación completo:
```
{{ define "mymessage" }}
{{ if gt (len .Alerts.Firing) 0 }}
{{ len .Alerts.Firing }} firing:
{{ range .Alerts.Firing }} {{ template "myalert" .}} {{ end }}
{{ end }}
{{ if gt (len .Alerts.Resolved) 0 }}
{{ len .Alerts.Resolved }} resolved:
{{ range .Alerts.Resolved }} {{ template "myalert" .}} {{ end }}
{{ end }}
{{ end }}
```
## Datos de plantilla
Los siguientes datos se transfieren a las plantillas de mensajes.
| Name | Tipo | Notas |
| --- | --- | --- |
| `Receiver` | cadena | Nombre del punto de contacto al que se envía la notificación. |
| `Status` | cadena | firing si se está activando al menos una alerta; de lo contrario, resolved. |
| `Alerts` | Alerta | Lista de los objetos de alerta que se incluyen en esta notificación (véase más abajo). |
| `GroupLabels` | KeyValue | Etiquetas por las que se agruparon estas alertas. |
| `CommonLabels` | KeyValue | Etiquetas comunes a todas las alertas incluidas en esta notificación. |
| `CommonAnnotations` | KeyValue | Anotaciones comunes a todas las alertas incluidas en esta notificación. |
| `ExternalURL` | cadena | Enlace para volver a la instancia de Grafana que envió la notificación. Si utiliza un Alertmanager externo, enlace para volver a este Alertmanager. |
El tipo `Alerts` presenta dos funciones para filtrar las alertas devueltas.
+ `Alerts.Firing`: devuelve una lista de alertas en activación.
+ `Alerts.Resolved`: devuelve una lista de alertas resueltas.
**Alerta (tipo)**
El tipo de alerta contiene los datos siguientes.
| Name | Tipo | Notas |
| --- | --- | --- |
| Status | cadena | `firing` o bien `resolved`. |
| Etiquetas | KeyValue | Un conjunto de etiquetas adjunto a la alerta. |
| Anotaciones | KeyValue | Un conjunto de anotaciones adjunto a la alerta. |
| StartsAt | time.Time | Hora en que la alerta empezó a activarse. |
| EndsAt | time.Time | Se establece solo si se conoce la hora de finalización de una alerta. De lo contrario, se establece en un periodo de tiempo de espera configurable a partir del momento en que se recibió la última alerta. |
| GeneratorURL | cadena | Enlace para volver a Grafana o a una instancia externa de Alertmanager. |
| SilenceURL | cadena | Enlace a un silencio de Grafana con las etiquetas para esta alerta rellenadas previamente. Solo para alertas administradas por Grafana. |
| DashboardURL | cadena | Enlace al panel de control de Grafana, si la regla de alerta pertenece a uno. Solo para alertas administradas por Grafana. |
| PanelURL | cadena | Enlace al panel de paneles de control de Grafana, si la regla de alerta pertenece a uno. Solo para alertas administradas por Grafana. |
| Huella digital | cadena | Huella digital que se puede utilizar para identificar la alerta. |
| ValueString | cadena | Una cadena que contiene las etiquetas y el valor de cada expresión reducida de la alerta. |
**KeyValue type**
El `KeyValue` tipo es un conjunto de pares de key/value cadenas que representan etiquetas y anotaciones.
Además del acceso directo a los datos almacenados como `KeyValue`, también hay métodos para ordenar, eliminar y transformar los datos.
| Name | Argumentos | Devuelve | Notas |
| --- | --- | --- | --- |
| SortedPairs | | Lista ordenada de pares de cadenas de claves y valores | |
| Quitar | []string | KeyValue | Devuelve una copia del Key/Value mapa sin las claves indicadas. |
| Nombres | | []string | Lista de nombres de etiquetas |
| Valores | | []string | Lista de valores de etiquetas |
## Funciones de plantilla
Con las funciones de plantilla, puede procesar etiquetas y anotaciones para generar notificaciones dinámicas. Están disponibles las siguientes funciones.
| Name | Tipo de argumento | Tipo de devolución | Description (Descripción) |
| --- | --- | --- | --- |
| `humanize` | número o cadena | cadena | Convierte un número a un formato más legible mediante prefijos métricos. |
| `humanize1024` | número o cadena | cadena | Como humanize, pero usa 1024 como base en lugar de 1000. |
| `humanizeDuration` | número o cadena | cadena | Convierte una duración en segundos a un formato más legible. |
| `humanizePercentage` | número o cadena | cadena | Convierte un valor de relación en una fracción de 100. |
| `humanizeTimestamp` | número o cadena | cadena | Convierte una marca de tiempo de Unix en segundos a un formato más legible. |
| `title` | cadena | cadena | strings.Title, pone en mayúscula el primer carácter de cada palabra. |
| `toUpper` | cadena | cadena | cadenas. ToUpper, convierte todos los caracteres a mayúsculas. |
| `toLower` | cadena | cadena | cadenas. ToLower, convierte todos los caracteres a minúsculas. |
| `match` | patrón, texto | booleano | expresiones regulares. MatchString Pruebas para detectar una coincidencia de expresiones regulares no anclada. |
| `reReplaceAll` | patrón, reemplazo, texto | cadena | Expresión regular. ReplaceAllString Sustitución de expresiones regulares, sin anclaje. |
| `graphLink` | cadena: objeto JSON con campos `expr` y `datasource` | cadena | Devuelve la ruta a la vista gráfica en Explore para la expresión y el origen de datos determinados. |
| `tableLink` | cadena: objeto JSON con campos `expr` y `datasource` | cadena | Devuelve la ruta a la vista tabular en Explore para la expresión y el origen de datos determinados. |
| `args` | []interface\$1\$1 | map[string]interface\$1\$1 | Convierte una lista de objetos en una asignación con claves, por ejemplo, arg0, arg1. Utilice esta función para pasar varios argumentos a las plantillas. |
| `externalURL` | ninguno | cadena | Devuelve una cadena que representa la URL externa. |
| `pathPrefix` | ninguno | cadena | Devuelve la ruta de la URL externa. |
En la siguiente tabla se muestran ejemplos de uso de cada función.
| Función | TemplateString | Input | Expected |
| --- | --- | --- | --- |
| humanize | \$1 humanize \$1value \$1 | 1234567.0 | 1,235 M |
| humanize1024 | \$1 humanize1024 \$1value \$1 | 1048576.0 | 1 Mi |
| humanizeDuration | \$1 humanizeDuration \$1value \$1 | 899,99 | 14 min 59 s |
| humanizePercentage | \$1 humanizePercentage \$1value \$1 | 0,134567 | 12,35% |
| humanizeTimestamp | \$1 humanizeTimestamp \$1value \$1 | 1435065584,128 | 2015-06-23 13:19:44.128 \$10000 UTC |
| título | \$1 \$1value \$1 title \$1 | aa bB CC | Aa Bb Cc |
| toUpper | \$1 \$1value \$1 toUpper \$1 | aa bB CC | AA BB CC |
| toLower | \$1 \$1value \$1 toLower \$1 | aa bB CC | aa bb cc |
| emparejar | \$1 match "a\$1" \$1labels.instance \$1 | aa | true |
| reReplaceAll | \$1\$1 reReplaceAll «localhost :( .\$1)» «mi.dominio: \$11» \$1labels.instance\$1\$1 | localhost:3000 | my.domain:3000 |
| graphLink | \$1\$1 graphLink "\$1\$1"expr\$1": \$1"up\$1", \$1"datasource\$1": \$1"gdev-prometheus\$1"\$1" \$1\$1 | | /explore?left=["now-1h","now","gdev-prometheus",\$1"datasource":"gdev-prometheus","expr":"up","instant":false,"range":true\$1] |
| tableLink | \$1\$1 tableLink "\$1\$1"expr\$1":\$1"up\$1", \$1"datasource\$1":\$1"gdev-prometheus\$1"\$1" \$1\$1 | | /explore?left=["now-1h","now","gdev-prometheus",\$1"datasource":"gdev-prometheus","expr":"up","instant":true,"range":false\$1] |
| args | \$1\$1define "x"\$1\$1\$1\$1.arg0\$1\$1 \$1\$1.arg1\$1\$1\$1\$1end\$1\$1\$1\$1template "x" (args 1 "2")\$1\$1 | | 1 2 |
| externalURL | \$1 externalURL \$1 | | http://localhost/path/prefix |
| pathPrefix | \$1 pathPrefix \$1 | | /path/prefix |
# Uso de políticas de notificaciones
****
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 los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).
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).
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 secundarias. Cada política, excepto la política raíz, también puede coincidir con etiquetas de alerta específicas. La política raíz evalúa cada alerta y, posteriormente, las evalúa cada política secundaria. Si habilita la opción `Continue matching subsequent sibling nodes` 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 notificaciones para las alertas administradas por Grafana. Las políticas de notificaciones de las alertas de Alertmanager son de solo lectura.
**Agrupación de 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 agrupación**
Supongamos que tiene 100 servicios conectados a una base de datos en diferentes entornos. Estos servicios se diferencian por la etiqueta `env=environmentname`. Hay una regla de alerta para controlar si sus servicios pueden llegar a la base de datos. La regla de alerta crea alertas llamadas `alertname=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 etiqueta `env`, 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 deshabilita la agrupación y envía cada alerta a su propio grupo.
## Uso de notificaciones
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 notificaciones raíz**
1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**.
1. Elija **Políticas de notificación**.
1. En el menú desplegable **Alertmanager**, seleccione el Alertmanager que desea editar.
1. En la sección **Política raíz**, seleccione el icono **Editar** (lápiz).
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 (o grupos especiales) por las que agrupar las alertas.
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.
**Adición de una nueva política específica de nivel superior**
1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**.
1. Elija **Políticas de notificación**.
1. En el menú desplegable **Alertmanager**, seleccione el Alertmanager que desea editar.
1. En la sección **Enrutamiento específico**, seleccione **Nueva política específica**.
1. En la sección **Etiquetas coincidentes**, agregue una o más etiquetas de alerta coincidentes. Más adelante en este tema se ofrece más información sobre la coincidencia de etiquetas.
1. En **Punto de contacto**, agregue 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.
1. Si lo desea, seleccione **Anular agrupación** para especificar una agrupación diferente de la política raíz.
1. Si lo desea, seleccione **Anular temporizadores generales** para anular las opciones de temporización de la política de notificaciones de grupo.
1. Elija **Guardar política** para guardar los cambios.
**Adición de una política anidada**
1. Amplíe la política específica en la que desee crear una política anidada.
1. Elija **Agregar política anidada** y, a continuación, agregue los detalles (como cuando se agrega una política específica de nivel superior).
1. Elija **Guardar política** para guardar los cambios.
**Edición de una política específica**
1. En la página **Alertas**, seleccione **Políticas de notificación** para abrir la página en la que se muestran las políticas existentes.
1. Seleccione la política que desea editar y, a continuación, elija el icono **Editar** (lápiz).
1. Efectúe los cambios oportunos (como cuando agrega una política específica de nivel superior).
1. Elija **Guardar política**.
**Cómo funciona la búsqueda de coincidencias de etiquetas**
Una política coincide con una alerta si las etiquetas de la alerta coinciden con todas las *etiquetas coincidentes* especificadas en la política.
+ **Etiqueta**: nombre de la etiqueta que debe coincidir. Debe coincidir exactamente con el nombre de la etiqueta de la alerta.
+ **Operador**: operador utilizado para comparar el valor de la etiqueta con el valor de la etiqueta coincidente. 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 una cadena o como una expresión regular, según el operador elegido.
## Temporizadores de silencio
Un temporizador 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 periodo específico y recurrente, por ejemplo, un periodo de mantenimiento habitual.
Al igual que los silencios, los temporizadores de silencio 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 temporizadores de silencio administrados por Grafana, así como los temporizadores de silencio para un origen de datos de Alertmanager externo.
**Comparación de los temporizadores de silencio y los silencios**
En la siguiente tabla se muestran las diferencias entre los temporizadores de silencio y los silencios.
| Temporizador de silencio | Silencio |
| --- | --- |
| Utiliza definiciones de intervalos de tiempo que pueden repetirse. | Tiene unas horas de inicio y finalización fijas. |
| Se crea y luego se agrega a las políticas de notificaciones. | Utiliza etiquetas para compararlas con una alerta y determinar si se debe silenciar o no. |
**Creación de un temporizador de silencio**
1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**.
1. Elija **Políticas de notificación**.
1. En el menú desplegable **Alertmanager**, seleccione el Alertmanager que desea editar.
1. En la sección **Temporizadores de silencio**, seleccione el botón **Agregar temporizador de silencio**.
1. Elija el intervalo de tiempo al que quiere que se aplique el temporizador de silencio.
1. Elija **Enviar** para crear el temporizador de silencio.
**Adición de un temporizador de silencio a una política de notificaciones**
1. Seleccione la política de notificaciones a la que desee agregar el temporizador de silencio y seleccione el botón **Editar**.
1. En el menú desplegable **Temporizadores de silencio**, seleccione los temporizadores de silencio que quiere agregar a la política.
Elija 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 intervalos con `:` (por ejemplo, `monday:thursday`). Un temporizador de silencio puede contener varios intervalos de tiempo. Un intervalo de tiempo consta de varios campos (los detalles se muestran en la siguiente lista) y todos 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 suprimirán 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**: hora del día a 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**: días de la semana. Puede ser un solo día (por ejemplo, `monday`), un intervalo (como `monday:friday`) o una lista de días separados por comas (por ejemplo, `monday, tuesday, wednesday`).
+ **Meses**: meses que se deben seleccionar. Puede especificar los meses con designaciones numéricas o con el nombre completo del mes, por ejemplo, `1` o `january` (ambos especifican enero). Puede especificar un solo mes, un intervalo de meses o una lista de meses separados por comas.
+ **Días del mes**: fechas de un mes. Los valores pueden oscilar entre `1` y `31`. Los valores negativos especifican los días del mes en orden inverso, por lo que `-1` representa 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 separados por comas.