> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/es/sonar/administration/automation/alerts.md). # Alertas y plantillas de alerta Gestione las alertas de dispositivos con retraso, checks y tareas fallidos, y configure plantillas de alerta: canales, severidades, reenvíos, acciones, exclusiones y dónde se aplican. ## Qué es y cuándo usarlo SONAR genera una alerta en tres situaciones: | Tipo | Se genera cuando | Severidad | | ---------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | | **Availability** | Un dispositivo lleva sin comunicarse con SONAR más tiempo que su **Overdue after (minutes)** | **Error** | | **Check** | Un check falla durante su **Number of consecutive failures before alert** | La del check (vea [Checks](/es/sonar/administration/automation/checks.md)) | | **Task** | Una tarea automatizada termina con un código de retorno distinto de cero | La **Alert Severity** de la tarea | Cada alerta puede mostrarse en el panel, enviarse por correo y por SMS, e iniciar una acción (un script en el dispositivo o un webhook). Una **plantilla de alerta** decide a quién se notifica, para qué severidades, con qué frecuencia y qué acción se ejecuta; se asigna de forma global, a un cliente, a un sitio o a una política de automatización. Use esta página para dar seguimiento a las alertas en el día a día y para diseñar las plantillas que las encaminan. ## Antes de empezar * Un rol con **List Alerts** para ver las alertas y **Manage Alerts** para resolverlas y posponerlas; **List Alert Templates** y **Manage Alert Templates** para las plantillas. Están en el grupo **Alerts** de **Admin Center › Roles**. * Para el correo, el servidor de correo configurado en **Admin Center › Settings › Mail Server**; para los SMS, la pestaña **SMS**. Vea [Notificaciones por correo y SMS](/es/sonar/administration/settings/email-and-sms.md). * Para las acciones de webhook, el webhook creado en **Admin Center › Settings › Web Hooks**. Vea [Webhooks](/es/sonar/administration/settings/webhooks.md). * Para las acciones de script, el script en **Management › Scripts**. ## Cómo se deciden los canales Para cada alerta, SONAR combina tres capas: 1. **La configuración propia del elemento.** Un dispositivo tiene **Get overdue email alerts**, **Get overdue sms alerts** y **Get overdue dashboard alerts** en **Edit › General**. Los checks y las tareas tienen las columnas **SMS Alert**, **Email Alert** y **Dashboard Alert** en las pestañas **CHECKS** y **TASKS** del dispositivo. 2. **La plantilla de alerta que se aplica al dispositivo.** Sus interruptores **Email**, **Text** y **Dashboard** tienen tres posiciones: activado (notificar siempre, por encima del elemento), en medio (**Not configured**: usar la configuración del elemento) y desactivado (no notificar nunca, por encima del elemento). Cuando una plantilla prevalece sobre un check o una tarea, la columna muestra `Setting is overridden by alert template: `. Para los checks y las tareas, la plantilla también filtra por severidad (**Only email on alert severity**, **Only text on alert severity**, **Only show dashboard alert on severity**). 3. **El interruptor global de severidad.** En **Admin Center › Settings › General**, **Receive notifications on:** **Informational Alerts** y **Warning Alerts** deciden si las alertas de esas severidades llegan a enviarse por correo, por SMS o a un webhook. Las alertas de error siempre pueden enviarse. El correo y los SMS van a los **Email recipients** y **SMS recipients** de la plantilla cuando están definidos; si no, a los destinatarios globales de las pestañas **Mail Server** y **SMS**. Un dispositivo en modo de mantenimiento (**Enable Maintenance Mode** en su menú de acciones) no genera alertas nuevas. Úselo para los trabajos planificados. ## Pasos ### Dar seguimiento a las alertas 1. Haga clic en la campana del encabezado. **NOTIFICATIONS** muestra cuántas alertas están abiertas y algunas de ellas, cada una con **Snooze alert** y **Resolve alert**. La campana se actualiza aproximadamente cada minuto. 2. Haga clic en **VIEW ALL** para abrir la vista general **Alerts**. 3. Filtre por **Clients**, **Severity** y **Time** (de **1 Day Ago** a **1 Year Ago**, o **Everything**), marque **Include snoozed** o **Include resolved** si hace falta y haga clic en **Search**. La vista general se abre con las alertas abiertas de los últimos 30 días. 4. Actúe sobre una alerta con los botones de su columna **Actions**, o marque varias y use **Snooze selected** o **Resolve selected**. **Resolve all** resuelve todas las alertas no resueltas que cargó la búsqueda actual. | Acción | Qué hace | | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Resolve alert** | Cierra la alerta. Si el problema persiste, el siguiente fallo genera una alerta nueva. Una resolución manual no envía notificaciones de resolución ni ejecuta la acción de resolución | | **Snooze alert** | Pregunta `How many days to snooze alert?` y oculta la alerta de la campana y de la vista general (salvo que **Include snoozed** esté marcado) durante ese número de días | | **Unsnooze alert** | Vuelve a listar de inmediato una alerta pospuesta | | **Show failure action run results** / **Show resolved action run results** | Muestra el resultado de la acción ejecutada por la plantilla: última ejecución, tiempo de ejecución, código de retorno y salida | Las alertas también se cierran solas: cuando el check vuelve a ser correcto, cuando la tarea tiene éxito en su siguiente ejecución o cuando un dispositivo con retraso vuelve a comunicarse. Restablecer un check (**Reset Check Status**) también resuelve su alerta. ### Crear una plantilla de alerta 1. Haga clic en **Alerts** en el encabezado. Se abre el panel **Alert Templates**. 2. Haga clic en **New**. **Add Alert Template** se abre en **General Settings**. 3. Rellene **Name** y deje **Enabled** activado. Si lo desea, fije **Email From address** y añada destinatarios con **Add email** y **Add sms number** (números de SMS en formato E.164, por ejemplo `+15555550100`). 4. Haga clic en **Next**. En **Alert Actions**, elija la acción que se ejecuta cuando se genera una alerta (**Alert Failure Settings**) y cuando se resuelve (**Alert Resolved Settings**), o deje el script vacío para no ejecutar ninguna acción. En **Run actions only on**, deje activados solo los tipos de alerta a los que se destina la acción: **Agents**, **Checks**, **Tasks**. 5. Haga clic en **Next**. En **Agent Overdue Settings**, fije los interruptores **Email**, **Text** y **Dashboard** para los dispositivos con retraso, **Alert again if not resolved after (days)**, y si se envía **Email** o **Text** cuando el dispositivo vuelve a estar en línea. 6. Haga clic en **Next**. En **Check Settings**, fije los mismos interruptores para los checks fallidos, los filtros de severidad, el intervalo de reenvío y las notificaciones de resolución. 7. Haga clic en **Next**. En **Automated Task Settings**, haga lo mismo para las tareas fallidas. 8. Haga clic en **Submit**. La confirmación dice `Alert Template created!` {% hint style="info" %} Una acción de script se ejecuta en el dispositivo a través de su agente, así que sirve para las alertas de check y de tarea. Un dispositivo con retraso no se puede alcanzar, por definición: para las alertas de retraso, use un webhook y deje **Agents** desactivado en **Run actions only on** cuando la acción de fallo sea un script. {% endhint %} ### Asignar la plantilla Una plantilla no hace nada hasta que se asigna: * **De forma global**: **Admin Center › Settings › General**, sección **Defaults**, campo **Alert Template**. * **A un cliente o a un sitio**: en la lista **CLIENTS** de la barra lateral, haga clic con el botón derecho en el cliente o en el sitio y elija **Assign Alert Template**; luego elija la plantilla en **Client Alert Template** o **Site Alert Template** y haga clic en **Submit**. * **A una política de automatización**: en **Management › Automations**, haga clic en **Assign Alert Template** (o **Modify Alert Template**) en la fila de la política. Un dispositivo usa una sola plantilla: la primera que se encuentra en este orden. 1. La plantilla de la política propia del dispositivo 2. La plantilla de la política del sitio 3. La plantilla del sitio 4. La plantilla de la política del cliente 5. La plantilla del cliente 6. La plantilla global 7. La plantilla de la política predeterminada Se omiten las plantillas desactivadas y las plantillas que excluyen el dispositivo. ### Excluir clientes, sitios, dispositivos o tipos de dispositivo 1. En el panel **Alert Templates**, haga clic en **Exclusions (N)** en la plantilla, o haga clic en ella con el botón derecho y elija **Alert Exclusions**. 2. Rellene **Excluded Clients**, **Excluded Sites** y **Excluded Agents**, o marque **Exclude Workstations** o **Exclude Servers**. 3. Haga clic en **Save**. Un dispositivo excluido pasa a la siguiente plantilla del orden anterior. ### Activar, desactivar, editar o eliminar una plantilla Use el interruptor al principio de la fila para activarla o desactivarla. Haga doble clic en la plantilla, o haga clic en ella con el botón derecho, para usar **Edit** o **Delete**. **Applied (N)** lista las políticas, los clientes y los sitios que la usan. ## Qué debe ver El panel **Alert Templates** lista cada plantilla con su interruptor, marcas en **Agent alert settings**, **Check alert settings** y **Task alert settings** cuando esos pasos están configurados, su nombre, una insignia **Default** para la plantilla global, **Applied (N)**, **Exclusions (N)** y los nombres de sus acciones. La vista general **Alerts** muestra **Time**, **Client**, **Site**, **Agent**, **Type**, **Severity**, **Message** y **Actions**, más **Resolved On** cuando se incluyen las alertas resueltas. Los mensajes dicen, por ejemplo, `WS-0001 in CLIENT-A, SITE-01 is overdue.`, `WS-0001 has a diskspace check: that failed.` o `WS-0001 has task: that failed.` ## Cómo verificar que funcionó 1. Abra un dispositivo cubierto por la plantilla y elija **Edit** en su menú de acciones. La pestaña **Automation Policies** muestra el **Alert Template** efectivo. 2. Haga fallar un check a propósito (vea [Checks](/es/sonar/administration/automation/checks.md), "Cómo verificar que funcionó"). Tras el número de fallos configurado, la alerta aparece en la campana y en la vista general si se aplica el canal del panel, y el correo o el SMS llega si se aplican esos canales. 3. Si la plantilla tiene una acción de fallo, abra la alerta en la vista general y use **Show failure action run results**. Para una acción de script, la pestaña **HISTORY** del dispositivo también muestra la ejecución. 4. Corrija la causa y vuelva a ejecutar los checks. La alerta se cierra, las notificaciones de resolución se envían si están activadas y **Show resolved action run results** aparece cuando se ha ejecutado una acción de resolución. 5. En **Reports & Audits › Audits**, la creación y la modificación de una plantilla se registran como **Add Object** y **Modify Object**. ## Errores comunes | Síntoma | Causa | Solución | | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | | `Name needs to be set` | La plantilla no tiene nombre | Rellene **Name** en **General Settings** | | `Failure script timeout is required` / `Resolved script timeout is required` | Una acción de script sin tiempo límite | Introduzca el tiempo límite en segundos | | `Periodic days must be 0 or greater` | Intervalo de reenvío negativo | Introduzca 0 (sin reenvío) o más | | No llega correo para las alertas de advertencia o informativas | **Receive notifications on:** no incluye esa severidad, o el **Only email on alert severity** de la plantilla la deja fuera | Marque la severidad en **Admin Center › Settings › General**, o añádala al filtro de la plantilla | | No llega ningún correo | El dispositivo, el check o la tarea no tiene el canal de correo y el **Email** de la plantilla está en **Not configured**, o el servidor de correo no está configurado | Active el canal en el elemento o active **Email** en la plantilla; pruebe el servidor de correo | | La plantilla no tiene efecto en un dispositivo | Está desactivada, no está asignada donde el dispositivo la hereda, el dispositivo está excluido o se aplica una plantilla anterior en el orden | Compruebe **Edit › Automation Policies › Alert Template** en el dispositivo | | **Snooze selected** y **Resolve selected** están desactivados | No hay ninguna alerta marcada, o **Include resolved** está activado | Marque alertas y desmarque **Include resolved** | | Una alerta vuelve tras **Resolve alert** | El check o la tarea sigue fallando | Corrija la causa, o restablezca el check una vez corregida | | No hay ninguna alerta para un dispositivo | Está en modo de mantenimiento | Use **Disable Maintenance Mode** en su menú de acciones | ## Referencia de campos ### General Settings | Campo | Qué hace | Predeterminado | | ------------------ | ------------------------------------------------------------------------------------ | -------------- | | Name | Identifica la plantilla. Obligatorio | Vacío | | Enabled | La plantilla surte efecto donde se asigne | Activado | | Email From address | Dirección del remitente de los correos de esta plantilla, en lugar de la global | Vacío | | Email recipients | Sustituyen a los destinatarios de correo globales para las alertas de esta plantilla | Ninguno | | SMS recipients | Sustituyen a los destinatarios de SMS globales. Formato E.164 | Ninguno | ### Alert Actions | Campo | Qué hace | Predeterminado | | -------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | | Action type (failure and resolved) | **Run script on Agent** ejecuta un script de la biblioteca en el dispositivo. **Send a Web Hook** llama a un webhook de **Admin Center › Settings › Web Hooks** | **Run script on Agent** | | Failure script / Resolved Script | Script que se ejecuta cuando la alerta se genera / se resuelve. Se ejecuta una vez por alerta | Ninguno | | Failure script arguments / Resolved script arguments | Argumentos del script. Aceptan [variables de script](/es/sonar/reference/script-variables.md), incluidos los valores de la alerta | Los valores predeterminados del script | | Failure script environment vars / Resolved action environment vars | Variables de entorno, como `KEY=VALUE` | Los valores predeterminados del script | | Failure script timeout (seconds) / Resolved script timeout (seconds) | Tiempo máximo de ejecución | El valor predeterminado del script | | Failure Web Hook | Webhook que se llama cuando se genera la alerta | Ninguno | | Resolved Web Hook | Webhook que se llama cuando la alerta se resuelve sola. Úselo junto con un **Failure Web Hook** | Ninguno | | Run actions only on | Tipos de alerta que ejecutan las acciones: **Agents** (dispositivos con retraso), **Checks**, **Tasks** | Todos activados | ### Agent Overdue Settings, Check Settings, Automated Task Settings | Campo | Qué hace | Predeterminado | | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | | Email / Text / Dashboard (Alert Failure Settings) | Activado: notificar siempre por este canal. En medio (**Not configured**): usar la configuración del dispositivo, del check o de la tarea. Desactivado: no notificar nunca | **Not configured** | | Only email on alert severity | Checks y tareas. Severidades que se envían por correo | **Error** y **Warning** si está vacío | | Only text on alert severity | Checks y tareas. Severidades que se envían por SMS | **Error** y **Warning** si está vacío | | Only show dashboard alert on severity | Checks y tareas. Severidades que se muestran en el panel | Las tres si está vacío | | Alert again if not resolved after (days) | Reenvía el correo y el SMS mientras la alerta siga abierta. 0 envía una sola vez | 0 | | Email / Text (Alert Resolved Settings) | Envía una notificación cuando la alerta se resuelve sola | Desactivado | ### Alert Exclusions | Campo | Qué hace | | --------------------------------------------------- | -------------------------------------------------------- | | Excluded Clients / Excluded Sites / Excluded Agents | La plantilla no se aplica a estos dispositivos | | Exclude Workstations / Exclude Servers | La plantilla no se aplica a los dispositivos de ese tipo | ### Configuración de retraso del dispositivo (Edit › General) | Campo | Qué hace | | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | Offline after (minutes) | Tiempo sin contacto tras el cual el dispositivo se muestra fuera de línea. 2 o más | | Overdue after (minutes) | Tiempo sin contacto tras el cual el dispositivo queda con retraso y puede generarse una alerta de disponibilidad. 3 o más | | Get overdue email alerts / Get overdue sms alerts / Get overdue dashboard alerts | Los canales propios del dispositivo para las alertas de disponibilidad | ## Páginas relacionadas * [Checks](/es/sonar/administration/automation/checks.md) * [Tareas automatizadas](/es/sonar/administration/automation/automated-tasks.md) * [Políticas de automatización](/es/sonar/administration/automation/automation-policies.md) * [Notificaciones por correo electrónico y SMS](/es/sonar/administration/settings/email-and-sms.md) * [Webhooks](/es/sonar/administration/settings/webhooks.md)