Las notificaciones son un componente clave de los seguimientos que mantienen a tu equipo informado sobre los problemas y facilitan su resolución. Al crear tu seguimiento, configura tu respuesta a:
Elabora un mensaje accionable.
Activa un flujo de trabajo o crea un flujo de trabajo a partir de un seguimiento.
Este enfoque ayuda a garantizar que los títulos y mensajes de tu seguimiento sean claros, accionables y adaptados a las necesidades de tu audiencia.
Títulos únicos: Agrega un título único a tu seguimiento (esto es obligatorio). Para seguimientos de múltiples alertas, algunas etiquetas que identifican tu contexto de activación se insertan automáticamente. Puedes usar variables de etiqueta para mejorar la especificidad.
El soporte para formato Markdown varía 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). Los encabezados de Markdown (por ejemplo, #, ##) y las tablas no se renderizan; aparecen como texto plano.
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 plano en el cuerpo del mensaje.
Ejemplo de mensaje de seguimiento
Un caso de uso común para el mensaje de seguimiento es incluir un paso a paso para 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 notificación
Datadog recomienda usar reglas de notificación de seguimiento para gestionar las notificaciones de seguimiento. Con las reglas de notificación puedes automatizar qué destinatarios de notificación se añaden a un seguimiento según conjuntos de condiciones predefinidos. Crea diferentes reglas para dirigir las alertas de seguimiento según las etiquetas de la notificación de seguimiento para que no tengas que configurar manualmente los destinatarios ni la lógica de enrutamiento de notificaciones para cada seguimiento individual.
En las reglas de notificación y en los monitores individuales, puedes usar un @notification para agregar a un miembro del equipo, una integración, un flujo de trabajo o una incidencia a tu notificación. A medida que escribes, Datadog recomienda automáticamente opciones existentes en un menú desplegable. Haz clic en una opción para agregarla a tu notificación. Alternativamente, haz clic en @ Agregar Mención, Agregar Flujo de Trabajo, o Agregar Incidencia.
Una @notification debe tener un espacio entre ella y el último carácter de línea:
Formato Correcto
Formato Incorrecto
Disk space is low @ops-team@company.com
Disk space is low@ops-team@company.com
Integrations
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 seguimiento
Datadog admite la edición de los destinatarios de mensajes de alerta en múltiples seguimientos a la vez. Utiliza esta función para agregar, eliminar o reemplazar eficientemente @-handles en el cuerpo del mensaje del seguimiento. Los casos de uso incluyen:
Intercambiar un handle: Reemplaza un handle por otro en múltiples seguimientos. Por ejemplo, cambia @pagerduty-sre por @oncall-sre. También puedes intercambiar un solo handle por múltiples handles, como reemplazar @pagerduty-sre con @pagerduty-sre y @oncall-sre, para soportar paginación dual o cobertura de alertas ampliada.
Agregar un handle: Agregar un nuevo destinatario sin eliminar los existentes. Por ejemplo, agrega @slack-infra-leads a todos los seguimientos seleccionados.
Remove a handle: Eliminar un handle específico de los mensajes del seguimiento. Por ejemplo, elimina @webhook-my-legacy-event-intake.
Los incidentes pueden crearse automáticamente a partir de un seguimiento cuando este cambia a un estado alert, warn o no data. Haz clic en Agregar incidente y selecciona una opción de @incident-. Los administradores pueden crear @incident- opciones en Configuraciones de incidentes.
Cuando se crea un incidente a partir de un seguimiento, los valores de campo del incidente se rellenan automáticamente según las etiquetas del seguimiento. Por ejemplo, si tu seguimiento tiene una etiqueta service:payments, el campo de servicio del incidente se establecerá en “pagos”. Para recibir notificaciones sobre estos incidentes, asegúrate de que las etiquetas del seguimiento se alineen con tus reglas de notificación de incidentes. Nota: Las reglas de notificación de incidentes se configuran por separado de las reglas de notificación de seguimientos y deben configurarse de manera independiente. Para más información, consulte Notificación de Incidente.
Alternar contenido adicional
Las notificaciones de monitor incluyen contenido como la consulta del monitor, las menciones @ utilizadas, instantáneas de métricas (para monitores métricos), y enlaces de regreso a páginas relevantes en Datadog. Tiene la opción de elegir qué contenido le gustaría incluir o excluir de las notificaciones para monitor 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:
Predeterminado: No se oculta contenido.
Hide Query: Eliminar la consulta del seguimiento del mensaje de notificación.
Ocultar Menciones: Eliminar las menciones @ que se utilizan en el mensaje de notificación.
Hide All: El mensaje de notificación no incluye consulta, menciones, ninguna instantánea (para seguimientos métricos) o enlaces adicionales en los pies de página.
Nota: Dependiendo de la integración, es posible que algunos contenidos no se muestren de forma predeterminada.
Re-notificar
Habilitar la re-notificación del seguimiento (opcional) para recordar a tu equipo que un problema no está resuelto.
Configura el intervalo de re-notificación, los estados del seguimiento desde los cuales se envía la re-notificación (dentro de alert, no data y warn) y opcionalmente establece un límite al número de mensajes de re-notificación enviados.
Por ejemplo, configura el seguimiento para stop renotifying after 1 occurrence para recibir un solo mensaje de escalación después de la alerta principal.
Nota:Variables de atributo y etiqueta en la re-notificación se completan con los datos disponibles para el seguimiento durante el período de tiempo de la re-notificación.
Si la re-notificación está habilitada, se te ofrece la opción de incluir un mensaje de escalación que se envía si el seguimiento permanece en uno de los estados elegidos durante el período de tiempo especificado.
El mensaje de escalación se puede agregar de las siguientes maneras:
En el {{#is_renotify}} bloque en el mensaje de notificación original (recomendado).
En el campo Mensaje de Renotificación en la Configure notifications and automations sección.
Con el atributo escalation_message en la API.
Si utilizas el {{#is_renotify}} bloque, el mensaje de notificación original también se incluye en la renotificación, así que:
Incluye solo detalles adicionales en el {{#is_renotify}} bloque y no repitas los detalles del mensaje original.
Envía el mensaje de escalación a un subconjunto de grupos.
Aprende a configurar tus seguimientos para esos casos de uso en la sección de ejemplos.
Metadatos
Agrega metadatos (Prioridad, Etiquetas, Equipo de Datadog) a tu monitor. La Prioridad del Monitor te permite establecer la importancia de tu monitor a través del nivel P (P1 a P5). Las etiquetas del monitor–que son diferentes de las etiquetas de métrica–se utilizan en la interfaz de usuario para agrupar y buscar monitores. Si se configuran políticas de etiquetas, se deben agregar las etiquetas y valores de etiqueta requeridos. Para aprender más, consulta Políticas de Etiquetas. Los Equipos de Datadog te permiten establecer un nivel de propiedad para este monitor y ver todos los monitores vinculados a tu equipo. Para aprender más, consulta Equipos de Datadog.
Prioridad
Agrega una prioridad (opcional) asociada con tus 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, usa {{override_priority 'Pi'}} where Pi está entre P1 y P5.
Por ejemplo, puedes establecer diferentes prioridades para alert y warning notificaciones:
Si la consulta del monitor está agrupada, puedes eliminar una o más de las dimensiones de la agrupación de notificación, o eliminarlas todas y notificar como una alerta simple.
Después de definir tu monitor, prueba las notificaciones con el botón Notificaciones de Prueba en la parte inferior derecha de la página del monitor.
Las notificaciones de prueba son compatibles con los tipos de monitores: host, métrica, anomalía, valor anómalo, pronóstico, registro, rum, apm, integración (solo verificación), proceso (solo verificación), red (solo verificación), verificación personalizada, evento y composite.
Desde el pop-up de notificaciones de prueba, elige la transición del monitor para probar y el grupo (disponible solo si la consulta tiene agrupación). Solo puedes probar estados que están disponibles en la configuración del monitor para los umbrales especificados en las condiciones de alerta. 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 advertencia.
Haz clic en Ejecutar Prueba para enviar notificaciones a las personas y servicios listados en el monitor.
Eventos
Las notificaciones de prueba producen eventos que pueden ser buscados dentro del explorador de eventos. 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 aleatoriamente según el contexto de la definición de tu monitor, por ejemplo:
{{#is_alert}}
{{host.name}} <-- will populate
{{/is_alert}}
