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-setup"></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.

**Requisitos previos**

Antes de configurar las alertas, debe hacer lo siguiente.
+ Configure los [orígenes de datos](AMG-data-sources.md).
+ Asegúrese de que el origen de datos que elija sea compatible con [Grafana Alerting](v10-alerting-overview-datasources.md).

**Configuración de alertas**

1. Configure las [reglas de alerta](v10-alerting-configure.md).
   + Cree reglas de alerta y registro administradas por Grafana o por el origen de datos.

1. Configure los [puntos de contacto](v10-alerting-configure-contactpoints.md).
   + Compruebe el punto de contacto predeterminado y actualice el contacto para el sistema.
   + Si lo desea, agregue nuevos puntos de contacto e integraciones.

1. Configuración de [políticas de notificación](v10-alerting-explore-notifications-policies-details.md).
   + Compruebe la política de notificaciones predeterminada y actualícela para el sistema.
   + Si lo desea, agregue políticas anidadas adicionales.
   + Si lo desea, agregue etiquetas y comparadores de etiquetas para controlar el enrutamiento de las alertas.

Los siguientes temas le proporcionan más información sobre las opciones de configuración adicionales, incluida la configuración de administradores de alertas externos y el enrutamiento de las alertas administradas por Grafana fuera de Grafana.

**Topics**
+ [Migración de las alertas clásicas del panel de control a Grafana Alerting](v10-alerting-use-grafana-alerts.md)
+ [Adición de un Alertmanager externo](v10-alerting-setup-alertmanager.md)
+ [Aprovisionamiento de recursos de Grafana Alerting](v10-alerting-setup-provision.md)

# Migración de las alertas clásicas del panel de control a Grafana Alerting
<a name="v10-alerting-use-grafana-alerts"></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).

Los espacios de trabajo que optan por no utilizar Grafana Alerting utilizan [Alertas clásicas del panel](old-alerts-overview.md). Para cambiar a la nueva característica de Grafana Alerting, antes debe registrarse en ella. Para ver detalles sobre las diferencias entre las alertas de panel clásicas y las alertas de Grafana, consulte. [Grafana Alerting en comparación con las alertas de panel antiguas](#v10-alerting-diff-old-new) GrafanaLabs ha anunciado que las alertas clásicas del panel de control se eliminarán en la versión 11.

Cuando utiliza las alertas clásicas del panel de control, Amazon Managed Grafana le muestra una vista previa de Grafana Alerting en la que puede revisar y modificar las alertas actualizadas antes de finalizar la actualización.

## Vista previa de las alertas de Grafana
<a name="v10-alerting-preview-grafana-alerts"></a>

Puede obtener una vista previa de las alertas en las alertas de Grafana antes de migrar. En la vista previa, puede hacer cambios en las alertas que cambiarán la migración.

**Vista previa de la migración de Grafana Alerting**

1. Inicie sesión en el espacio de trabajo de Grafana.

1. En el menú de la izquierda, elija **Alertas (antiguas)** para ver las alertas actuales.

1. En el menú de la izquierda, elija **Actualización de alertas** para verla en Grafana Alerting.

   Desde esta vista, puede ver el aspecto que tendrán las alertas tras la migración.

**nota**  
Desde esta vista, también puede hacer cambios que afecten a la migración. Para deshacer cualquier cambio que haga, elija **Restablecer actualización** en la parte superior derecha de la página de actualización.

Cuando tenga todo listo para actualizar las alertas, consulte la siguiente sección.

## Migración al sistema de Grafana Alerting
<a name="v10-alerting-use-grafana-alerts-opt-in"></a>

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

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
<a name="v10-alerting-use-grafana-alerts-limitations"></a>
+ 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.

## Grafana Alerting en comparación con las alertas de panel antiguas
<a name="v10-alerting-diff-old-new"></a>

Grafana Alerting, que se presentó en Grafana 8, tiene varias mejoras con respecto a las alertas antiguas del panel.

### Alertas multidimensionales
<a name="v10-alerts-diff-multi-dimensional"></a>

Ahora puede crear alertas que le ofrecen visibilidad en todo el sistema con una sola regla de alerta. Genere varias instancias de alerta a partir de una única 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.

### Creación de alertas fuera de los paneles de control
<a name="v10-alerts-diff-alerts-outside-of-dashboards"></a>

A diferencia de las alertas de panel antiguas, las alertas de Grafana le permiten crear consultas y expresiones que combinan datos de varios 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 alertas de Loki y Grafana Mimir
<a name="v10-alerts-diff-loki-mimir-alerting-rules"></a>

En Grafana Alerting, puede administrar las reglas de alerta de Loki y Grafana Mimir mediante la misma interfaz de usuario y API que las alertas administradas por Grafana.

### Visualización y búsqueda de alertas de orígenes de datos compatibles con Prometheus
<a name="v10-alerts-diff-view-alerts-from-prometheus"></a>

Las alertas de los orígenes de datos compatibles con Prometheus ahora se muestran en la sección de alertas de Grafana. Puede buscar etiquetas en varios orígenes de datos para encontrar rápidamente las alertas pertinentes.

### Alertas especiales sobre el estado de la alerta y el error NoData
<a name="v10-alerts-diff-special-alerts"></a>

Grafana Alerting introdujo un nuevo concepto de estados de alerta. Cuando la evaluación de una regla de alerta produce un estado NoData o un error, Grafana Alerting generará alertas especiales que tendrán las siguientes etiquetas:
+ `alertname`con valor DatasourceNoData o en DatasourceError función del estado.
+ `rulename` nombre de la regla de alerta a la que pertenece la alerta especial.
+ `datasource_uid` tendrá el UID del origen de datos que provocó el estado.
+ Todas las etiquetas y anotaciones de la regla de alerta original

Para gestionar estas alertas de la misma manera que las alertas normales, agregue un silencio, diríjalas a un punto de contacto, etc.

**nota**  
Si la regla utiliza muchos orígenes de datos y uno o varios no devuelven datos, se creará la alerta especial para cada origen de datos que provocó el estado de alerta.

# Adición de un Alertmanager externo
<a name="v10-alerting-setup-alertmanager"></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 Grafana para usar un Alertmanager externo como el único Alertmanager que recibirá todas sus alertas. Luego, este administrador de alertas externo se podrá configurar y administrar desde Grafana.

**nota**  
No puede utilizar Amazon Managed Service para Prometheus como Alertmanager externo.

Una vez que haya agregado el administrador de alertas, puede usar la interfaz de usuario de Grafana Alerting para administrar los silencios, los puntos de contacto y las políticas de notificaciones. Una opción desplegable en estas páginas le permite cambiar entre los administradores de alertas.

Los Alertmanagers externos se configuran como orígenes de datos mediante la configuración de Grafana desde el menú de navegación principal de Grafana. Esto le permite administrar los puntos de contacto y las políticas de notificaciones de los administradores de alertas externos desde Grafana y también cifra las credenciales de autenticación básica HTTP que antes estaban visibles al configurar los administradores de alertas externos por URL.

**nota**  
A partir de Grafana 9.2, queda obsoleta la configuración de la URL de los Alertmanagers externos desde la pestaña Administración de la página Alertas. Se habilitará en una versión futura.

**Adición de un Alertmanager externo**

1. Elija **Conexiones** en el menú de la izquierda.

1. Busque la opción `Alertmanager`.

1. Elija el botón **Crear un nuevo origen de datos**.

1. Rellene los campos de la página según sea necesario.

   Si va a aprovisionar el origen de datos, establezca la marca `handleGrafanaManagedAlerts` del campo `jsonData` en `true` para enviar alertas administradas por Grafana a este Alertmanager.
**nota**  
Se admiten las implementaciones de Alertmanager de Prometheus, Grafana Mimir y Cortex. En el caso de Prometheus, los puntos de contacto y las políticas de notificaciones son solo de lectura en la interfaz de usuario de Grafana Alerting.

1. Elija **Guardar y probar**.

# Aprovisionamiento de recursos de Grafana Alerting
<a name="v10-alerting-setup-provision"></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).

La infraestructura de alertas suele ser compleja, ya que muchas partes de la canalización suelen estar en diferentes lugares. Escalar esta capacidad entre varios equipos y organizaciones es una tarea especialmente difícil. El aprovisionamiento de Grafana Alerting facilita este proceso al permitirle crear, administrar y mantener los datos de sus alertas de la manera que mejor se adapte a su organización.

Existen dos opciones entre las que elegir:

1. Aprovisionar sus recursos de alertas mediante la API HTTP de aprovisionamiento de alertas.
**nota**  
Por lo general, no puede editar las reglas de alerta aprovisionadas por la API desde la interfaz de usuario de Grafana.  
Para habilitar la edición, agrega el x-disable-provenance encabezado a las siguientes solicitudes al crear o editar tus reglas de alerta en la API:  

   ```
   POST /api/v1/provisioning/alert-rules
   PUT /api/v1/provisioning/alert-rules/{UID}
   ```

1. Aprovisionar los recursos de alertas con Terraform.

**nota**  
Actualmente, el aprovisionamiento de Grafana Alerting admite reglas de alerta, puntos de contacto, temporizadores de silencio y plantillas. Los recursos de alerta aprovisionados mediante el aprovisionamiento de archivos o Terraform solo se pueden editar en el origen que los creó y no desde Grafana ni desde ningún otro origen. Por ejemplo, si aprovisiona sus recursos de alerta mediante archivos del disco, no podrá editar los datos en Terraform ni en Grafana.

**Topics**
+ [Creación y administración de recursos de alertas con Terraform](v10-alerting-setup-provision-terraform.md)
+ [Visualización de los recursos de alerta aprovisionados en Grafana](v10-alerting-setup-provision-view.md)

# Creación y administración de recursos de alertas con Terraform
<a name="v10-alerting-setup-provision-terraform"></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).

Use el proveedor de Grafana de Terraform para administrar sus recursos de alertas y aprovisionarlos en su sistema Grafana. La compatibilidad del proveedor de Terraform con Grafana Alerting facilita la creación, la administración y el mantenimiento de toda su pila de Grafana Alerting como código.

Para obtener más información sobre la administración de sus recursos de alertas mediante Terraform, consulte la documentación del [proveedor de Grafana](https://registry.terraform.io/providers/grafana/grafana/latest/docs) en la documentación de Terraform.

Complete las siguientes tareas para crear y administrar sus recursos de alertas con Terraform.

1. Cree una clave de API para el aprovisionamiento.

1. Configure el proveedor de Terraform.

1. Defina sus recursos de alerta en Terraform.

1. Ejecute `terraform apply` para aprovisionar sus recursos de alerta.

## Requisitos previos
<a name="v10-alerting-setup-provision-tf-prerequisites"></a>
+ Asegúrese de tener el [proveedor grafana/grafana Terraform](https://registry.terraform.io/providers/grafana/grafana/1.28.0) 1.27.0 o superior.
+ Compruebe que use Grafana 9.1 o posterior. Si creó su instancia de Amazon Managed Grafana con la versión 9 de Grafana, será verdadero.

## Creación de una clave de API para el aprovisionamiento
<a name="v10-alerting-setup-provision-tf-apikey"></a>

Puede [crear una clave de API de Grafana normal](Using-Grafana-APIs.md) para autenticar Terraform con Grafana. La mayoría de las herramientas existentes que utilizan claves de API deberían funcionar automáticamente con la nueva compatibilidad de Grafana Alerting. Para obtener información específica sobre la creación de claves para su uso con Terraform, consulte [Using Terraform for Amazon Managed Grafana automation](https://aws-observability.github.io/observability-best-practices/recipes/recipes/amg-automation-tf/).

**Creación de una clave de API para el aprovisionamiento**

1. Cree una nueva cuenta de servicio para su canalización de CI.

1. Asigne el rol “Acceder a la API de aprovisionamiento de las reglas de alerta”.

1. Cree un nuevo token para la cuenta de servicio.

1. Asigne un nombre al token y guárdelo para usarlo en Terraform.

También puede usar la autenticación básica. Para ver todos los formatos de autenticación compatibles, consulte [Grafana authentication](https://registry.terraform.io/providers/grafana/grafana/latest/docs#authentication) en la documentación de Terraform.

## Configuración del proveedor de Terraform
<a name="v10-alerting-setup-provision-tf-configure"></a>

La compatibilidad de Grafana Alerting se incluye como parte del [proveedor de Terraform de Grafana](https://registry.terraform.io/providers/grafana/grafana/latest/docs).

A continuación, se ofrece un ejemplo que puede usar para configurar el proveedor de Terraform.

```
terraform {
    required_providers {
        grafana = {
            source = "grafana/grafana"
            version = ">= 1.28.2"
        }
    }
}

provider "grafana" {
    url = <YOUR_GRAFANA_URL>
    auth = <YOUR_GRAFANA_API_KEY>
}
```

## Aprovisionamiento de puntos de contacto y plantillas
<a name="v10-alerting-setup-provision-tf-contacts"></a>

Los puntos de contacto conectan una pila de alertas con el mundo exterior. Indican a Grafana cómo conectarse a los sistemas externos y dónde enviar las notificaciones. Hay más de 15 [integraciones](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/contact_point#optional) diferentes entre las que elegir. En este ejemplo, se utiliza un punto de contacto de Slack.

**Aprovisionamiento de puntos de contacto y las plantillas**

1. Copie este bloque de código en un archivo .tf en su máquina local. *<slack-webhook-url>*Sustitúyelo por la URL del webhook de Slack (u otros detalles del punto de contacto).

   En este ejemplo, se crea un punto de contacto que envía notificaciones de alerta a Slack.

   ```
   resource "grafana_contact_point" "my_slack_contact_point" {
       name = "Send to My Slack Channel"
   
       slack {
           url = <slack-webhook-url>
           text = <<EOT
   {{ len .Alerts.Firing }} alerts are firing!
   
   Alert summaries:
   {{ range .Alerts.Firing }}
   {{ template "Alert Instance Template" . }}
   {{ end }}
   EOT
       }
   }
   ```

1. Ingrese el texto de la notificación en el campo de texto.

   El campo `text` admite [plantillas al estilo de Go](https://pkg.go.dev/text/template). Esto le permite administrar sus plantillas de notificaciones de Grafana Alerting directamente en Terraform.

1. Ejecute el comando `terraform apply`.

1. Vaya a la interfaz de usuario de Grafana y compruebe los detalles de su punto de contacto.

   No puede editar los recursos aprovisionados mediante Terraform desde la interfaz de usuario. Esto garantiza que su pila de alertas esté siempre sincronizada con su código.

1. Haga clic en **Probar** para verificar que el punto de contacto funciona correctamente.

**nota**  
Puede reutilizar las mismas plantillas en muchos puntos de contacto. En el ejemplo anterior, se incrusta una plantilla compartida mediante la instrucción `{{ template "Alert Instance Template" . }}`  
Luego, este fragmento se puede administrar por separado en Terraform:  

```
resource "grafana_message_template" "my_alert_template" {
    name = "Alert Instance Template"

    template = <<EOT
{{ define "Alert Instance Template" }}
Firing: {{ .Labels.alertname }}
Silence: {{ .SilenceURL }}
{{ end }}
EOT
}
```

## Aprovisionamiento de políticas de notificación y el enrutamiento
<a name="v10-alerting-setup-provision-tf-notifications"></a>

Las políticas de notificación le indican a Grafana cómo enrutar las instancias de alerta, en lugar de hacia dónde. Conectan las alertas de activación con los puntos de contacto previamente definidos mediante un sistema de etiquetas y criterios de coincidencia.

**Aprovisionamiento de políticas de notificación y enrutamiento**

1. Copie este bloque de código en un archivo .tf en su máquina local.

   En este ejemplo, las alertas se agrupan por `alertname`, lo que significa que cualquier notificación procedente de alertas que compartan el mismo nombre se agrupa en el mismo mensaje de Slack.

   Si quiere redirigir notificaciones específicas de forma diferente, puede agregar subpolíticas. Las subpolíticas le permiten aplicar el enrutamiento a diferentes alertas en función de la coincidencia de etiquetas. En este ejemplo, aplicamos un temporizador de silencio a todas las alertas con la etiqueta a=b.

   ```
   resource "grafana_notification_policy" "my_policy" {
       group_by = ["alertname"]
       contact_point = grafana_contact_point.my_slack_contact_point.name
   
       group_wait = "45s"
       group_interval = "6m"
       repeat_interval = "3h"
   
       policy {
           matcher {
               label = "a"
               match = "="
               value = "b"
           }
           group_by = ["..."]
           contact_point = grafana_contact_point.a_different_contact_point.name
           mute_timings = [grafana_mute_timing.my_mute_timing.name]
   
           policy {
               matcher {
                   label = "sublabel"
                   match = "="
                   value = "subvalue"
               }
               contact_point = grafana_contact_point.a_third_contact_point.name
               group_by = ["..."]
           }
       }
   }
   ```

1. En el campo mute\$1timings, vincule un temporizador de silencio con su política de notificaciones.

1. Ejecute el comando `terraform apply`.

1. Vaya a la interfaz de usuario de Grafana y compruebe los detalles de su política de notificaciones.
**nota**  
No puede editar los recursos aprovisionados mediante Terraform desde la interfaz de usuario. Esto garantiza que su pila de alertas esté siempre sincronizada con su código.

1. Haga clic en **Probar** para verificar que el punto de notificación funciona correctamente.

## Aprovisionamiento de temporizadores de silencio
<a name="v10-alerting-setup-provision-tf-mutetiming"></a>

Los temporizadores de silencio permiten silenciar las notificaciones de alerta durante periodos de tiempo definidos.

**Aprovisionamiento de temporizadores de silencio**

1. Copie este bloque de código en un archivo .tf en su máquina local.

   En este ejemplo, las notificaciones de alerta se silencian los fines de semana.

   ```
   resource "grafana_mute_timing" "my_mute_timing" {
       name = "My Mute Timing"
   
       intervals {
           times {
             start = "04:56"
             end = "14:17"
           }
           weekdays = ["saturday", "sunday", "tuesday:thursday"]
           months = ["january:march", "12"]
           years = ["2025:2027"]
       }
   }
   ```

1. Ejecute el comando `terraform apply`.

1. Vaya a la interfaz de usuario de Grafana y compruebe los detalles de su temporizador de silencio.

1. Use el campo `mute_timings` para hacer referencia al temporizador de silencio que acaba de crear en una política de notificaciones. De este modo, se aplicará el temporizador de silencio a algunas o a todas las notificaciones.
**nota**  
No puede editar los recursos aprovisionados mediante Terraform desde la interfaz de usuario. Esto garantiza que su pila de alertas esté siempre sincronizada con su código.

1. Haga clic en **Probar** para verificar que el temporizador de silencio funciona correctamente.

## Aprovisionamiento de reglas de alerta
<a name="v10-alerting-setup-provision-tf-rules"></a>

Las [reglas de alertas](v10-alerting-configure.md) le permiten enviar alertas de cualquier origen de datos de Grafana. Puede ser un origen de datos que ya haya configurado, o puede [definir sus orígenes de datos en Terraform](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/data_source) junto con sus reglas de alerta.

**Aprovisionamiento de reglas de alerta**

1. Cree el origen de datos que se va a consultar y una carpeta en la que almacenar las reglas.

   En este ejemplo, se usa el origen de datos [Configurar una fuente TestData de datos para realizar pruebas](testdata-data-source.md).

   Las alertas se pueden definir en cualquier origen de datos de backend de Grafana.

   ```
   resource "grafana_data_source" "testdata_datasource" {
       name = "TestData"
       type = "testdata"
   }
   
   resource "grafana_folder" "rule_folder" {
       title = "My Rule Folder"
   }
   ```

1. Defina una regla de alerta.

   Para obtener más información sobre las reglas de alerta, consulte [cómo crear alertas administradas por Grafana](https://grafana.com/blog/2022/08/01/grafana-alerting-video-how-to-create-alerts-in-grafana-9/).

1. Cree un grupo de reglas que contenga una o más reglas.

   En este ejemplo, se usa el grupo de recursos `grafana_rule_group`.

   ```
   resource "grafana_rule_group" "my_rule_group" {
       name = "My Alert Rules"
       folder_uid = grafana_folder.rule_folder.uid
       interval_seconds = 60
       org_id = 1
   
       rule {
           name = "My Random Walk Alert"
           condition = "C"
           for = "0s"
   
           // Query the datasource.
           data {
               ref_id = "A"
               relative_time_range {
                   from = 600
                   to = 0
               }
               datasource_uid = grafana_data_source.testdata_datasource.uid
               // `model` is a JSON blob that sends datasource-specific data.
               // It's different for every datasource. The alert's query is defined here.
               model = jsonencode({
                   intervalMs = 1000
                   maxDataPoints = 43200
                   refId = "A"
               })
           }
   
           // The query was configured to obtain data from the last 60 seconds. Let's alert on the average value of that series using a Reduce stage.
           data {
               datasource_uid = "__expr__"
               // You can also create a rule in the UI, then GET that rule to obtain the JSON.
               // This can be helpful when using more complex reduce expressions.
               model = <<EOT
   {"conditions":[{"evaluator":{"params":[0,0],"type":"gt"},"operator":{"type":"and"},"query":{"params":["A"]},"reducer":{"params":[],"type":"last"},"type":"avg"}],"datasource":{"name":"Expression","type":"__expr__","uid":"__expr__"},"expression":"A","hide":false,"intervalMs":1000,"maxDataPoints":43200,"reducer":"last","refId":"B","type":"reduce"}
   EOT
               ref_id = "B"
               relative_time_range {
                   from = 0
                   to = 0
               }
           }
   
           // Now, let's use a math expression as our threshold.
           // We want to alert when the value of stage "B" above exceeds 70.
           data {
               datasource_uid = "__expr__"
               ref_id = "C"
               relative_time_range {
                   from = 0
                   to = 0
               }
               model = jsonencode({
                   expression = "$B > 70"
                   type = "math"
                   refId = "C"
               })
           }
       }
   }
   ```

1. Vaya a la interfaz de usuario de Grafana y compruebe su regla de alerta.

   De esta forma podrá ver si la regla de alerta se activa. También puede ver una visualización de cada una de las fases de consulta de la regla de alerta.

   Cuando se activa la alerta, Grafana envía una notificación a través de la política que haya definido.

   Por ejemplo, si elige Slack como punto de contacto, [Alertmanager](https://github.com/prometheus/alertmanager) integrado de Grafana publica automáticamente un mensaje en Slack.

# Visualización de los recursos de alerta aprovisionados en Grafana
<a name="v10-alerting-setup-provision-view"></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 verificar que sus recursos de alertas se crearon en Grafana.

**Visualización de los recursos aprovisionados en Grafana**

1. Abra su instancia de Grafana.

1. Vaya a Alertas.

1. Haga clic en una carpeta de recursos de alertas, por ejemplo, Reglas de alertas.

   Los recursos aprovisionados se etiquetan como **Aprovisionados**, de modo que queda claro que no se crearon manualmente.

**nota**  
No puede editar los recursos aprovisionados desde Grafana. Solo puede cambiar las propiedades del recurso si cambia el archivo de aprovisionamiento y reinicia Grafana o hace una recarga en caliente. Esto evita que se hagan cambios en el recurso que se sobrescribirían si se volviera a aprovisionar un archivo o si se hiciera una recarga en caliente.