Las reglas de notificación de seguimiento son conjuntos predefinidos de condiciones que automatizan el proceso de alertar a tu equipo basado en etiquetas y lógica de reglas. En lugar de configurar individualmente los destinatarios para cada seguimiento, las reglas de notificación te permiten definir una vez y enrutarlas automáticamente a todas las notificaciones de seguimiento cuyo conjunto de etiquetas de notificación coincida con el contexto de la regla.
Hay un límite predeterminado de 1000 reglas por organización..
Agrega las etiquetas requeridas para que una notificación de seguimiento sea dirigida a esta regla. La coincidencia evalúa el conjunto de etiquetas de notificación. Aprende más en Cómo funciona la coincidencia.
Los seguimientos creados o actualizados después de que se guarda la regla de notificación son enrutados a los destinatarios definidos si coincide con el contexto de la regla.
Sintaxis del alcance de la regla
La consulta del alcance de la regla de notificación soporta lógica booleana y sigue la sintaxis de búsqueda basada en eventos soportada por muchos otros productos de la plataforma.
Elemento de Sintaxis
Descripción
Operadores booleanos
Soportados: AND, OR, NOT Operador implícito: AND
Comodines
Solo se soporta key:* (por ejemplo, env:*). Los comodines parciales como env:prod-* no son soportados. key:* coincide si la clave existe en cualquier lugar del conjunto de etiquetas de notificación.
Valores múltiples para la misma clave
Usa ya sea env:(prod OR staging) o env:prod OR env:staging.
Citas
Envuelve los valores que contienen espacios o caracteres especiales entre comillas, por ejemplo: team:"data platform".
Ejemplos de alcance
Alcance de la regla de notificación
Explicación
service:web-store
Dirige cualquier notificación sobre el servicio web-store.
service:web-store AND env:prod
Dirija cualquier notificación sobre el servicio web-store que se esté ejecutando en el entorno prod.
service:webstore AND NOT env:staging
Dirija cualquier notificación sobre el servicio web-store que no se esté ejecutando en el entorno staging.
env:*
Dirija cualquier notificación que lleve la etiqueta env:<value> (ya sea de etiquetas de monitor o de grupo).
Limitaciones del alcance de la regla
Lo siguiente no es compatible:
Las etiquetas sin clave, como prod AND service:(A or B) o prod, no son compatibles. Las etiquetas deben tener una clave, en este caso, por ejemplo, env:prod.
Los comodines parciales (service:web-*) y los comodines de signo de interrogación service:auth? no son compatibles. El comodín solo se permite si se usa solo, como service:*.
Longitud del alcance de hasta 3000 caracteres.
Configure el enrutamiento y los destinatarios
Elija cómo enrutear las notificaciones cuando una alerta de monitor coincida con el alcance de la regla. Puede especificar manualmente los destinatarios o usar enrutamiento dinámico para resolver automáticamente los destinatarios de las configuraciones de su equipo y servicio.
Enrutamiento manual
Especifique qué destinatarios notificar cuando una notificación de monitor coincida con el alcance de la regla. Siempre puede notificar a todos los destinatarios, o establecer destinatarios condicionales que solo se notifiquen cuando se cumplan ciertas condiciones (por ejemplo, enrutar alertas críticas a su destinatario de guardia y enviar advertencias a un canal de Slack).
Las condiciones pueden basarse en el estado del monitor o en etiquetas:
Condiciones basadas en el estado: Notifique a los destinatarios cuando el monitor cambie a un estado específico (Alerta, OK, Advertencia o Sin datos).
Condiciones basadas en etiquetas: Notifique a los destinatarios cuando una clave de etiqueta específica tenga un valor dado (por ejemplo, env:prod). Cada condición admite solo una clave de etiqueta.
Las notificaciones se pueden enviar por correo electrónico o cualquier canal de integración. Hay un límite de 50 destinatarios de notificaciones por regla. Para más información, consulte Notificaciones.
Enrutamiento dinámico
El enrutamiento dinámico está en vista previa. Para solicitar acceso, comuníquese con su equipo de cuentas de Datadog o contacte a Soporte de Datadog.
El enrutamiento dinámico enruta automáticamente las alertas de seguimiento al equipo correcto según sus configuraciones existentes de Teams y Catálogo. En lugar de mantener listas de destinatarios estáticas, el enrutamiento dinámico utiliza la etiqueta service o team en el monitor de alertas para determinar a dónde enviar las notificaciones.
Configuración
Descripción
Requisitos
Basado en servicio
Verifica la etiqueta service del monitor o la etiqueta de grupo, busca qué equipo gestiona ese servicio en el Catálogo y luego envía la alerta a los canales de notificación configurados de ese equipo.
El servicio debe tener un equipo asignado en el Catálogo. Si no se asigna ningún equipo, la alerta se envía a los destinatarios de respaldo.
Basado en equipo
Verifica directamente la etiqueta team del monitor o la etiqueta de grupo, y luego envía la alerta a los canales de notificación configurados de ese equipo.
El monitor debe tener una etiqueta team.
Respaldo
Si el enrutamiento no puede resolverse (por ejemplo, el servicio no tiene un equipo asignado o el equipo no tiene canales de notificación configurados), la alerta va a los destinatarios de respaldo. Los destinatarios de respaldo se comportan de la misma manera que los destinatarios de enrutamiento manual.
Requerido para todas las reglas de enrutamiento dinámico.
Tanto el enrutamiento basado en servicios como el enrutamiento basado en equipos son compatibles con Slack, correo electrónico, PagerDuty y Microsoft Teams. Los equipos pueden configurar sus canales de notificación en Configuración de equipos.
Alcance: Muestra las combinaciones de etiquetas que definen cuándo se aplica esta regla (por ejemplo, team:shopist service:web-store env:prod).
Equipo: Enumera los equipos con los que está asociada esta regla de notificación (disponible solo cuando se agrega la etiqueta de equipo en el alcance)
Cobertura: Muestra el número de monitores que coinciden con los alcances de esta regla. Utiliza esto para verificar la cobertura de la regla e identificar reglas que necesitan ajustes.
Notifica: Enumera los canales de notificación (como Slack o correo electrónico) que recibirán alertas cuando esta regla coincida.
Además, puedes hacer clic en el menú vertical de tres puntos en la regla de notificación para Editar o Eliminar.
Desde un monitor individual
En la configuración de tu monitor, el Resumen de Destinatarios muestra los destinatarios que se aplican al monitor mediante reglas de notificación coincidentes. En la página de edición del Monitor, también puedes ver reglas que podrían coincidir cuando nuevos grupos informan (monitores de múltiples alertas). La página de estado del Monitor muestra reglas que coinciden.
Cómo funciona la coincidencia
El conjunto de etiquetas de notificación es la unión de las etiquetas de seguimiento y las etiquetas del grupo activador (para seguimientos de múltiples alertas). Si una clave tiene múltiples valores en el seguimiento/grupo, se consideran todos los valores.
Actualmente coincide: Una regla coincide si al menos un grupo de reporte, combinado con las etiquetas de seguimiento, satisface el contexto; o, si las etiquetas de seguimiento por sí solas lo hacen. NO se evalúa por cada conjunto de etiquetas candidato, por lo que un grupo con un valor denegado no coincide.
Podría coincidir cuando nuevos grupos reportan (monitors de múltiples alertas, Monitor edit surface): Trate cada clave de agrupación como presente con cualquier valor, condicionado a los filtros allow/deny de la consulta del monitor.
Si múltiples reglas coinciden con una sola notificación, los destinatarios de todas las reglas coincidentes se fusionan y se eliminan duplicados.
Ejemplo: Coincidencia de Regla de Notificación
La siguiente tabla demuestra cómo los monitors con diferentes combinaciones de etiquetas coinciden con las reglas de notificación y las notificaciones resultantes. Esta tabla muestra cómo:
Múltiples reglas de notificación pueden coincidir con una sola notificación de monitor, en función de sus etiquetas.
La lógica AND funciona para múltiples etiquetas dentro de una regla.
Todas las reglas de notificación coincidentes contribuyen con sus destinatarios a la lista final de notificaciones.
Los destinatarios se deduplican en la lista final de notificaciones.
