Las notificaciones son un componente clave de los seguimientos que mantienen a su equipo informado sobre problemas y ayudan en la resolución de errores. Al crear su seguimiento, configure su respuesta para:
Elabore un mensaje procesable.
Active un flujo de trabajo o cree un flujo de trabajo desde un seguimiento.
Este enfoque ayuda a asegurar que los títulos y mensajes de sus seguimientos sean claros, procesables y adaptados a las necesidades de su audiencia.
Títulos únicos: Agregue un título único a su seguimiento (esto es obligatorio). Para seguimientos de alertas múltiples, algunas etiquetas que identifican su contexto de activación se insertan automáticamente. Puede usar variables de etiqueta para mejorar la especificidad.
El soporte de formato Markdown difiere según el método de notificación. Algunos canales solo admiten un subconjunto de la sintaxis de Markdown.
Notificaciones de Slack: Admiten formato básico (negrita, cursiva, código en línea, enlaces). Encabezados de Markdown (por ejemplo, #, ##) y las tablas no se renderizan; aparecen como texto sin formato.
Notificaciones por correo electrónico: Admiten formato básico (negrita, cursiva, código en línea, enlaces). Las tablas no se renderizan como tablas de Markdown y aparecen como texto sin formato en el cuerpo del mensaje.
Ejemplo de mensaje de seguimiento
Un caso de uso común para el mensaje de seguimiento es incluir una forma paso a paso de resolver el problema, por ejemplo:
{{#is_alert}} <-- conditional variable
Steps to free up disk space on {{host.name}}: <-- tag variable
1. Remove unused packages
2. Clear APT cache
3. Uninstall unnecessary applications
4. Remove duplicate files
@slack-incident-response <-- channel to send notification
{{/is_alert}}
Destinatarios de la notificación
Datadog recomienda utilizar reglas de notificación de seguimiento para administrar las notificaciones de seguimiento. Con las reglas de notificación, puede automatizar qué destinatarios de notificación se agregan a un seguimiento según conjuntos de condiciones predefinidos. Cree diferentes reglas para enrutar las alertas de seguimiento según las etiquetas de la notificación de seguimiento para que no tenga que configurar manualmente los destinatarios ni la lógica de enrutamiento de notificaciones para cada seguimiento individual.
Tanto en las reglas de notificación como en los monitores individuales, puede usar un @notification para agregar un miembro del equipo, una integración, un flujo de trabajo o un elemento de trabajo a su notificación. A medida que escribe, Datadog recomienda automáticamente las opciones existentes en un menú desplegable. Haga clic en una opción para agregarla a su notificación. Alternativamente, haga clic en @ Add Mention, Add Workflow o Add Case.
Una @notificación debe tener un espacio entre ella y el último carácter de la línea:
Formato correcto
Formato incorrecto
Disk space is low @ops-team@company.com
Disk space is low@ops-team@company.com
Integraciones
Notify your team through connected integrations by using the format @<INTEGRATION_NAME>-<VALUES>.
Handles that include parentheses () are not supported. When a handle with parentheses is used, the handle is not parsed and no alert is created.
Teams
If a notification channel is set, you can route notifications to a specific Team. Monitor alerts targeting @team-handle are redirected to the selected communication channel. For more information on setting a notification channel to your Team, see the Teams documentation.
Incidencias
Automatically create a case for new security signals that meet your criteria. By default, the Cases section lists all projects that have project handles. You can click View All, then click + to add a handle to an existing project and enable automatic case creation directly from the recipient list, or go into your project settings to manage your project handles.
Correo electrónico
Notify an active Datadog user by email with @<DD_USER_EMAIL_ADDRESS>.
An email address associated with a pending Datadog user invitation or a disabled user is considered inactive and does not receive notifications. Blocklists, IP or domain filtering, spam filtering, or email security tools may also cause missing notifications.
Notify any non-Datadog user by email with @<EMAIL>.
Email notifications don't support addresses that contain slashes /, for example, @DevOpS/West@example.com.
Edición masiva de @-handles de seguimientos
Datadog permite editar los destinatarios de los mensajes de alerta en varios seguimientos a la vez. Utilice esta función para agregar, eliminar o reemplazar @-handles de manera eficiente en el cuerpo del mensaje del seguimiento. Los casos de uso incluyen:
Intercambiar un handle: Reemplace un handle por otro en varios seguimientos. Por ejemplo, cambie @pagerduty-sre por @oncall-sre. También puede intercambiar un solo handle por varios handles, como reemplazar @pagerduty-sre por @pagerduty-sre y @oncall-sre, para admitir la paginación dual o una cobertura de alertas ampliada.
Agregar un handle: Agregue un nuevo destinatario sin eliminar los existentes. Por ejemplo, agregue @slack-infra-leads a todos los seguimientos seleccionados.
Eliminar un handle: Elimine un handle específico de los mensajes del seguimiento. Por ejemplo, elimine @webhook-my-legacy-event-intake.
y seleccione un Blueprint, o seleccione Start From Scratch.
Para obtener más información sobre cómo crear un flujo de trabajo, consulte Build workflows.
Incidentes
Los incidentes pueden crearse automáticamente desde un seguimiento cuando este cambia a un estado alert, warn o no data. Haga clic en Add Incident y seleccione una opción de @incident-. Los administradores pueden crear opciones de @incident- en Incident Settings.
Cuando se crea un incidente desde un seguimiento, los valores de campo del incidente se completan automáticamente según las etiquetas del seguimiento. Por ejemplo, si su seguimiento tiene una etiqueta service:payments, el campo de servicio del incidente se establecerá en “payments”. Para recibir notificaciones de estos incidentes, asegúrese de que las etiquetas del seguimiento coincidan con sus reglas de notificación de incidentes. Nota: Las reglas de notificación de incidentes se configuran por separado de las reglas de notificación del seguimiento y deben configurarse de forma independiente. Para obtener más información, consulte Incident Notification.
Alternar contenido adicional
Las notificaciones de seguimiento incluyen contenido como la consulta del seguimiento, las @-menciones utilizadas, instantáneas de métricas (para seguimientos de métricas) y enlaces a páginas relevantes en Datadog. Usted tiene la opción de elegir qué contenido desea incluir o excluir de las notificaciones para seguimientos individuales.
Las métricas de distribución con agregadores de percentiles (como `p50`, `p75`, `p95` o `p99`) no generan un gráfico de instantánea en las notificaciones.
Las opciones son:
Default: No se oculta ningún contenido.
Hide Query: Elimine la consulta del seguimiento del mensaje de notificación.
Hide Handles: Elimine las @-menciones que se utilizan en el mensaje de notificación.
Hide All: El mensaje de notificación no incluye la consulta, los handles, ninguna instantánea (para seguimientos de métricas) ni enlaces adicionales en los pies de página.
Nota: Dependiendo de la integración, es posible que cierto contenido no se muestre de forma predeterminada.
Renotificar
Habilite la renotificación del seguimiento (opcional) para recordarle a su equipo que un problema no se ha resuelto.
Configure el intervalo de renotificación, los estados del seguimiento desde los cuales el seguimiento vuelve a notificar (dentro de alert, no data y warn) y, opcionalmente, establezca un límite en la cantidad de mensajes de renotificación enviados.
Por ejemplo, configure el seguimiento en stop renotifying after 1 occurrence para recibir un único mensaje de escalada después de la alerta principal.
Nota: Las variables de atributos y etiquetas en la renotificación se completan con los datos disponibles para el seguimiento durante el período de tiempo de la renotificación.
Si la renotificación está habilitada, se le da la opción de incluir un mensaje de escalada que se envía si el seguimiento permanece en uno de los estados elegidos durante el período de tiempo especificado.
El mensaje de escalada se puede agregar de las siguientes maneras:
En el {{#is_renotify}} bloque en el mensaje de notificación original (recomendado).
En el campo Renotification message en la sección Configure notifications and automations.
Con el atributo escalation_message en la API.
Si utiliza el bloque {{#is_renotify}}, el mensaje de notificación original también se incluye en la renotificación, por lo que:
Incluya solo detalles adicionales en el bloque {{#is_renotify}} block y no repita los detalles del mensaje original.
Envíe el mensaje de escalada a un subconjunto de grupos.
Aprenda a configurar sus monitores para esos casos de uso en la sección de ejemplos.
Metadatos
Agregue metadatos (Prioridad, Etiquetas, Datadog Team) a su monitor. La Prioridad del monitor le permite establecer la importancia de su monitor mediante un nivel P (de P1 a P5). Las etiquetas de monitor (que son diferentes de las etiquetas de métricas) se utilizan en la interfaz de usuario para agrupar y buscar monitores. Si las políticas de etiquetas están configuradas, es necesario agregar las etiquetas y los valores de etiqueta requeridos. Para obtener más información, consulte Políticas de etiquetas. Datadog Teams le permite establecer una capa de propiedad para este monitor y ver todos los monitores vinculados a su equipo. Para obtener más información, consulte Datadog Teams.
Prioridad
Agregue una prioridad (opcional) asociada a sus monitores. Los valores van de P1 a P5, siendo P1 la prioridad más alta y P5 la más baja.
Para anular la prioridad del monitor en el mensaje de notificación, use {{override_priority 'Pi'}} where Pi está entre P1 y P5.
Por ejemplo, puede establecer diferentes prioridades para las notificaciones de alert y warning:
Si la consulta del monitor está agrupada, puede eliminar una o más dimensiones de la agrupación de notificaciones, o eliminarlas todas y notificar como una Alerta simple.
Después de definir su monitor, pruebe las notificaciones con el botón Test Notifications en la parte inferior derecha de la página del monitor.
Las notificaciones de prueba son compatibles con los tipos de monitor: servidor, métrica, anomalía, valor anómalo, pronóstico, logs, RUM, APM, integración (solo verificación), proceso (solo verificación), red (solo verificación), verificación personalizada, evento y composite.
Desde la ventana emergente de notificaciones de prueba, elija la transición del monitor que desea probar y el grupo (disponible solo si la consulta tiene grouping). Solo puede probar los estados que están disponibles en la configuración del monitor para los umbrales especificados en las condiciones de alerta. Los umbrales de recuperación son una excepción, ya que Datadog envía una notificación de recuperación una vez que el monitor ya no está en alerta o no tiene condiciones de alerta.
Haga clic en Run Test para enviar notificaciones a las personas y servicios listados en el monitor.
Events
Las notificaciones de prueba generan eventos que se pueden buscar dentro del Event Explorer. Estas notificaciones indican quién inició la prueba en el cuerpo del mensaje con [TEST] en el título de la notificación.
Las variables de etiqueta solo se completan en el texto de los eventos secundarios de Datadog. El evento principal solo muestra un resumen de agregación.
Variables
Las variables de mensaje se completan automáticamente con un grupo seleccionado al azar según el contexto de la definición de su monitor, por ejemplo:
{{#is_alert}}
{{host.name}} <-- will populate
{{/is_alert}}
Lecturas adicionales
Documentación, enlaces y artículos útiles adicionales: