Utiliza variables en los mensajes de notificación para mostrar mensajes condicionales y dirigir la notificación a diferentes equipos utilizando variables condicionales, o para enriquecer su contenido utilizando variables de atributo y etiqueta y variables de plantilla.
Variables condicionales
Las variables condicionales utilizan if-else lógica para mostrar un mensaje diferente dependiendo del estado del seguimiento y los detalles de cómo fue activado. Estas variables pueden ser utilizadas dentro del asunto o cuerpo del mensaje de notificación.
Las siguientes variables condicionales están disponibles:
| Variable Condicional | El texto se muestra si |
|---|
{{#is_alert}} | The monitor alerts |
{{^is_alert}} | The monitor does not alert |
{{#is_match}} | The context matches the provided substring. If a numeric value is used, it is converted to a string. |
{{^is_match}} | The context does not match the provided substring |
{{#is_exact_match}} | The context exactly matches the provided string.
If a number is used, the numeric value is considered, regardless of its type. This means that as long as two numbers have the same value, they are considered equal by the function. |
{{^is_exact_match}} | The context does not exactly match the provided string |
{{#is_no_data}} | The monitor is triggered for missing data |
{{^is_no_data}} | The monitor is not triggered for missing data |
{{#is_warning}} | The monitor warns |
{{^is_warning}} | The monitor does not warn |
{{#is_recovery}} | The monitor recovers from ALERTA, ADVERTENCIA, DESCONOCIDO, or SIN DATOS |
{{^is_recovery}} | The monitor does not recover from ALERTA, ADVERTENCIA, DESCONOCIDO, or SIN DATOS |
{{#is_warning_recovery}} | The monitor recovers from ADVERTENCIA to OK |
{{^is_warning_recovery}} | The monitor does not recover from ADVERTENCIA to OK |
{{#is_alert_recovery}} | The monitor recovers from ALERTA to OK |
{{^is_alert_recovery}} | The monitor does not recover from an ALERT to OK |
{{#is_alert_to_warning}} | The monitor transitions from ALERTA to ADVERTENCIA |
{{^is_alert_to_warning}} | The monitor does not transition from ALERTA to ADVERTENCIA |
{{#is_no_data_recovery}} | The monitor recovers from SIN DATOS |
{{^is_no_data_recovery}} | The monitor does not recover from SIN DATOS |
{{#is_priority 'value'}} | The monitor has priority value. Value ranges from P1 to P5 |
{{#is_unknown}} | The monitor is in the unknown state |
{{^is_unknown}} | The monitor is not in the unknown state |
{{#is_renotify}} | The monitor is renotifying |
{{^is_renotify}} | El seguimiento no está renotificando. |
Ejemplos
Las variables condicionales deben tener un par de apertura y cierre con el texto y @-notificaciones en medio. Las variables basadas en el estado del seguimiento (como is_alert o is_warning), deben tener su propio bloque de mensaje. Debido a que un seguimiento solo puede estar en un estado a la vez, no puedes combinarlos. Sin embargo, puedes anidar condicionales que coincidan con atributos, consulta los is_renotify ejemplos.
Para enviar un mensaje de notificación cuando un seguimiento alerta, utiliza el formato:
{{#is_alert}}
<ALERT_MESSAGE_TEXT> <@-NOTIFICATION>
{{/is_alert}}
Para enviar un mensaje de notificación cuando un seguimiento advierte, utiliza el formato:
{{#is_warning}}
<WARNING_MESSAGE_TEXT> <@-NOTIFICATION>
{{/is_warning}}
Para enviar un mensaje de notificación cuando un seguimiento se recupera, utiliza el formato:
{{#is_recovery}}
<RECOVERY_MESSAGE_TEXT> <@-NOTIFICATION>
{{/is_recovery}}
Busca una subcadena en una variable de etiqueta con el formato:
{{#is_match "<TAG_VARIABLE>.name" "<COMPARISON_STRING>"}}
This displays if <COMPARISON_STRING> is included in <TAG_VARIABLE>.
{{/is_match}}
Para notificar a tu equipo de base de datos si un servidor desencadenante tiene la etiqueta role:db_cassandra o role:db_postgres, utiliza lo siguiente:
{{#is_match "host.role.name" "db"}}
This displays if the host triggering the alert contains `db`
in the role name. @db-team@company.com
{{/is_match}}
La is_match condición también admite la coincidencia de múltiples cadenas:
{{#is_match "host.role.name" "db" "database"}}
This displays if the host triggering the alert contains `db` or `database`
in the role name. @db-team@company.com
{{/is_match}}
Para enviar una notificación diferente si la etiqueta no contiene db, utiliza la negación de la condición de la siguiente manera:
{{^is_match "host.role.name" "db"}}
This displays if the role tag doesn't contain `db`.
@slack-example
{{/is_match}}
O utiliza el {{else}} parámetro en el primer ejemplo:
{{#is_match "host.role.name" "db"}}
This displays if the host triggering the alert contains `db`
in the role name. @db-team@company.com
{{else}}
This displays if the role tag doesn't contain `db`.
@slack-example
{{/is_match}}
Nota: Para verificar si un <TAG_VARIABLE> no existe o si está vacío, utiliza is_exact_match. Consulta la pestaña is_exact_match para más detalles.
Busca una cadena exacta en una variable de etiqueta con el formato:
{{#is_exact_match "<TAG_VARIABLE>.name" "<COMPARISON_STRING>"}}
This displays if <COMPARISON_STRING> is exactly <TAG_VARIABLE>.
{{/is_exact_match}}
Para notificar a tu equipo de desarrollo si un servidor desencadenante tiene el nombre production, utiliza lo siguiente:
{{#is_exact_match "host.name" "production"}}
This displays if the host that triggered the alert is exactly
named production. @dev-team@company.com
{{/is_exact_match}}
La is_exact_match condición también admite la coincidencia de múltiples cadenas:
{{#is_exact_match "host.name" "production" "staging"}}
This displays if the host that triggered the alert is exactly
named production or staging. @dev-team@company.com
{{/is_exact_match}}
La is_exact_match variable condicional también admite {{value}} variables de plantilla:
{{#is_exact_match "value" "<VALUE>"}}
This displays if the value that breached the threshold of the monitor is exactly <VALUE>.
{{/is_exact_match}}
Para notificar a tu equipo de desarrollo si el valor que superó el umbral de tu seguimiento es 5 (o 5.0), utiliza lo siguiente:
{{#is_exact_match "value" "5"}}
This displays if the value that breached the threshold of the monitor is 5. @dev-team@company.com
{{/is_exact_match}}
La is_exact_match variable condicional también admite una cadena vacía para el <COMPARISON_STRING> para verificar si el atributo o etiqueta está vacío o no existe.
{{#is_exact_match "host.datacenter" ""}}
This displays if the attribute or tag does not exist or if it's empty
{{/is_exact_match}}
Para enviar un mensaje de escalación a un destino diferente solo para el production entorno:
{{#is_renotify}}
{{#is_match "env" "production"}}
This is an escalation message sent to @dev-team@company.com
{{/is_match}}
{{/is_renotify}}
Para enviar un mensaje de escalación diferente que no contenga los detalles del mensaje original, utiliza una combinación de {{^is_renotify}} and {{#is_renotify}} bloques:
{{^is_renotify}}
This monitor is alerting and sending a first message @dev-team@company.com
To solve this monitor follow the steps:
1. Go there
2. Do this
{{/is_renotify}}
This part is generic and sent both for the first trigger and the escalation message.
{{#is_renotify}}
This is the escalation message @dev-team@company.com
{{/is_renotify}}
En la renotificación del seguimiento, los usuarios recibirán el siguiente mensaje de escalación:
This part is generic and sent both for the first trigger and the escalation message.
This is the escalation message @dev-team@company.com
Si configuras un bloque condicional para una transición de estado en las condiciones alert o warning con un manejador de @-notifications, Datadog recomienda que configures una condición correspondiente recovery para enviar una notificación de recuperación al manejador.
Nota: Cualquier texto o manejador de notificación colocado fuera de las variables condicionales configuradas se invoca con cada transición de estado del monitor. Cualquier texto o manejador de notificación colocado dentro de las variables condicionales configuradas solo se invoca si la transición de estado del seguimiento coincide con su condición.
Variables de atributo y etiqueta
Utiliza variables de atributo y etiqueta para generar mensajes de alerta que sean personalizados, informativos y específicos para ayudar a entender la naturaleza de la alerta. Consulta las siguientes secciones para ejemplos y casos de uso:
- Etiquetas
- Adjuntadas automáticamente (como el nombre del servidor, el nombre del contenedor, el nombre del archivo de registro y el nombre de la función sin servidor) o añadidas a través de etiquetas personalizadas (como el equipo a cargo, el entorno, la aplicación o la versión).
- Atributos
- Basado en el contenido del registro y ya sea analizado o añadido mediante búsquedas en tablas de referencia (por ejemplo, geoip).
Nota: Si el seguimiento está configurado para recuperarse en condiciones de sin datos (por ejemplo, cuando no hay eventos que coincidan con la consulta), el mensaje de recuperación no contiene ningún dato. Para persistir información en el mensaje de recuperación, agrupa por etiquetas adicionales, que son accesibles mediante {{tag.name}}.
Variables de alerta múltiple
Configura variables de alerta múltiple en seguimientos de alerta múltiple según la dimensión seleccionada en el cuadro de grupo de alerta múltiple. Enriquece las notificaciones incluyendo dinámicamente el valor asociado con la dimensión de agrupación en cada alerta.
Nota: Cuando uses el campo group_by en la agregación, las etiquetas y alertas adicionales del seguimiento pueden ser heredadas automáticamente. Esto significa que cualquier alerta o configuración establecida en el punto de conexión monitoreado podría aplicarse a cada grupo resultante de la agregación.
Si una métrica está etiquetada con cualquier etiqueta en el formato key:value y la consulta del seguimiento está agrupada por esta etiqueta, usa la variable:
Esta variable inserta el value asociado con el key en cada notificación de alerta. Por ejemplo, si tu seguimiento activa una alerta por cada env, entonces la variable {{env.name}} está disponible en tu mensaje de notificación.
Si un grupo tiene múltiples values asociados con el mismo key, el mensaje de alerta muestra una cadena de todos los valores separados por comas, en orden lexicográfico.
Clave de etiqueta con punto
Si la clave de tu etiqueta tiene un punto, incluye corchetes alrededor de la clave completa al usar una variable de etiqueta. Por ejemplo, si tu etiqueta es dot.key.test:five y tu seguimiento está agrupado por dot.key.test, usa:
Los seguimientos de registro, los seguimientos de Trace Analytics, los seguimientos de RUM y los seguimientos de eventos pueden usar facetas como variables si el seguimiento está agrupado por faceta. Si un seguimiento de registro está agrupado por @facet_key, usa la variable:
Ejemplo: Para incluir información específica del grupo en un seguimiento de registros de alerta múltiple agrupado por @machine_id:
This alert was triggered on {{ @machine_id.name }}
Si tu faceta tiene puntos, usa corchetes alrededor de la faceta, por ejemplo:
{{ [@network.client.ip].name }}
Personaliza la notificación según el grupo
Cuando tu consulta está agrupada por dimensiones específicas, puedes enriquecer las notificaciones con metadatos dinámicos asociados con el grupo. Para ver una lista de variables de plantilla de etiqueta según tu selección de etiquetas, haz clic en Usar variables de plantilla de mensaje en la sección Configurar notificaciones y automatizaciones. Mira los siguientes ejemplos:
Si tu monitor activa una alerta para cada host, entonces las variables de etiqueta {{host.name}} and {{host.ip}} están disponibles, así como cualquier etiqueta de host que esté disponible en este host.
Variables de metadatos específicos del host:
Versión del agente: {{host.metadata_agent_version}}
Máquina: {{host.metadata_machine}}
Plataforma: {{host.metadata_platform}}
Procesador: {{host.metadata_processor}}
Si tu monitor activa una alerta para cada kube_namespace y kube_cluster_name, entonces puedes acceder a cualquier atributo del espacio de nombres.
Variables de metadatos del namespace:
- Nombre del clúster:
{{kube_namespace.cluster_name}} - Nombre del espacio de nombres:
{{kube_namespace.display_name}} - Estado del espacio de nombres:
{{kube_namespace.status}} - Etiquetas del espacio de nombres:
{{kube_namespace.labels}}
La siguiente tabla contiene todos los atributos disponibles:
| Sintaxis de variable | Atributos de primer nivel |
|---|
{{kube_namespace.key}} | k8s_namespace_key, tags, annotations, cluster_id, cluster_name, creation_timestamp, deletion_timestamp, display_name, external_id, finalizers, first_seen_at, group_size, labels, name, namespace, status, uid |
Si tu monitor activa una alerta para cada pod_name y kube_namespace y kube_cluster_name, entonces puedes acceder a cualquier atributo del pod.
Variables de metadatos del pod:
- Nombre del clúster:
{{pod_name.cluster_name}} - Nombre del pod:
{{pod_name.name}} - Fase del pod:
{{pod_name.phase}}
La siguiente tabla contiene todos los atributos disponibles:
| Sintaxis de variable | Atributos de primer nivel |
|---|
{{pod_name.key}} | k8s_pod_key, tags, annotations, cluster_id, cluster_name, conditions, container_statuses, creation_timestamp, deletion_timestamp, display_name, external_id, finalizers, first_seen_at, host_id, host_key, hostname, init_container_statuses, ip, labels, name, namespace, node_name, nominated_node_name, phase, pod_scheduled_timestamp, priority_class_name, qosclass, resource_requirements, uid |
Si tu monitor activa una alerta para cada service, entonces puedes acceder a algún atributo del servicio, como se define en el Software Catalog.
Variables de metadatos del servicio:
- Nombre del servicio:
{{service.name}} - Nombre del equipo:
{{service.team}} - Documentos:
{{service.docs}} - Enlaces:
{{service.links}}
Para Documentos y Enlaces, también puedes acceder a un elemento específico con la siguiente sintaxis [<name>]. Por ejemplo, para servicios que tienen un esquema de definición como el que se define en este ejemplo, puedes acceder al enlace “Runbook” utilizando la siguiente sintaxis
{{service.links[Runbook]}}
Variables de atributo/etiqueta coincidentes
Puedes incluir cualquier atributo o etiqueta de un registro, traza, evento RUM, canalización CI o evento de prueba CI que coincida con la consulta del monitor. La siguiente tabla muestra ejemplos de atributos y variables que puedes agregar de diferentes tipos de monitores.
Para ver la lista completa de variables disponibles para tu monitor, en la parte inferior de la configuración de notificaciones haz clic en {{ Agregar Variable y selecciona de las opciones del menú expandido.
Para cualquier par key:value, la variable {{log.tags.key}} renders valor en el mensaje de alerta.
El @ que precede a todos los atributos no está incluido. Por ejemplo, si un monitor de registros está agrupado por @http.status_code, puedes incluir el mensaje de error o las etiquetas de infraestructura en el mensaje de notificación utilizando las variables:
{{ log.attributes.[error.message] }}
{{ log.tags.env }}
...
El mensaje muestra el atributo error.message de un registro que coincide con la consulta, si el atributo existe.
Si la etiqueta está en un evento, utiliza la siguiente sintaxis:
{{ event.tags.[dot.key.test] }}
Notas importantes
- Si el evento seleccionado no incluye el atributo o la clave de la etiqueta, la variable se muestra vacía en el mensaje de notificación. Para evitar notificaciones perdidas, evita usar estas variables para enrutar notificaciones con
{{#is_match}} manejadores. - Para monitores que utilizan Fórmulas y Funciones en consultas, los valores se resuelven en función de los eventos extraídos de la primera consulta.
Atributos reservados
Los registros, la Gestión de Eventos, los spans, RUM, la Pipeline CI y los eventos de Prueba CI tienen atributos reservados genéricos, que puedes usar en variables con la siguiente sintaxis:
| Tipo de monitor | Sintaxis de variable | Atributos de primer nivel |
|---|
| Registro | {{log.key}} | mensaje, servicio, estado, fuente, span_id, timestamp, trace_id, enlace, host |
| Trace Analytics | {{span.key}} | env, nombre_de_operación, nombre_de_recurso, servicio, estado, span_id, timestamp, trace_id, tipo, enlace |
| RUM | {{rum.key}} | servicio, estado, marca de tiempo, enlace |
| Event | {{event.key}} | atributos, nombre del servidor, id, enlace, título, texto, etiquetas |
| CI Pipeline | {{cipipeline.key}} | servicio, ambiente, nombre_recurso, nivel_ci, id_traza, id_span, huella_pipeline, nombre_operación, arreglo_parcial_ci, estado, marca de tiempo, enlace |
| CI Test | {{citest.key}} | servicio, ambiente, nombre_recurso, trace_id, span_id, nombre_operación, estado, marca de tiempo, enlace |
Si el evento coincidente no contiene el atributo en su definición, la variable se muestra vacía.
Enlace del explorador
Usar {{log.link}}, {{span.link}}, {{rum.link}}, and {{issue.link}} para enriquecer la notificación con un enlace al Explorador de Registros, Explorador de Trazas, Explorador RUM o Error Tracking, limitado a los eventos que coinciden con la consulta.
Variables del monitor de verificación
Para las variables del monitor de verificación (verificación personalizada y verificación de integración), la variable {{check_message}} está disponible y muestra el mensaje especificado en la verificación personalizada o la verificación de integración.
Variables de monitores composite
Los monitores composite pueden acceder al valor y al estado asociados a los submonitores en el momento en que se activa la alerta.
Por ejemplo, si su monitor composite tiene un submonitor a, puede incluir el valor de a con:
Para recuperar el estado del submonitor a, utiliza:
Los valores posibles para el estado son: OK, Alert, Warn y No Data.
Los monitores composite también admiten variables de etiqueta de la misma manera que sus monitores subyacentes. Siguen el mismo formato que otros monitores, siempre que los monitores subyacentes estén agrupados por la misma etiqueta o faceta.
Por ejemplo, suponga que su monitor composite tiene un submonitor a, que es un monitor de registros. Puede incluir el valor de cualquier etiqueta o faceta de a con:
{{ a.log.message }} or {{ a.log.my_facet }}
Escape de caracteres
El contenido variable está codificado en HTML por defecto. Para mostrar contenido sin codificar, use llaves triples en lugar de llaves dobles.
Por ejemplo, cuando el valor de una variable contiene una URL con parámetros de consulta, el & se trata de manera diferente dependiendo de si se utilizan llaves dobles o triples:
| Sintaxis | Ejemplo de salida |
|---|
{{template_variable}} (double braces) | https://status.example.com/check?service=web&region=us-east |
{{{template_variable}}} (triple braces) | https://status.example.com/check?service=web®ion=us-east |
| Sintaxis | Salida |
|---|
{{variable}} | HTML-encoded (default) |
{{{variable}}} | Sin codificar, sin procesar |
Por ejemplo, para mostrar el mensaje de verificación sin codificación HTML:
Esto es particularmente relevante cuando {{check_message}} contains auto-generated URLs with query parameters (for example, on HTTP Check monitors). The & characters in those URLs are HTML-encoded by default, which can break clickable links in notifications. Use {{{check_message}}} para preservar las URL tal como están.
Variables de plantilla
Utiliza variables de plantilla para personalizar las notificaciones de tu monitor. Las variables integradas son:
| Variable | Descripción |
|---|
{{value}} | The value that breached the alert for metric based query monitors. |
{{threshold}} | The value of the alert threshold set in the monitor’s alert conditions. |
{{warn_threshold}} | The value of the warning threshold set in the monitor’s alert conditions. |
{{alert_recovery_threshold}} | The value that recovered the monitor from its ALERT state. |
{{warn_recovery_threshold}} | The value that recovered the monitor from its WARN state. |
{{ok_threshold}} | The value that recovered the Service Check monitor. |
{{comparator}} | The relational value set in the monitor’s alert conditions. |
{{first_triggered_at}}
See section below | The UTC date and time when the monitor first triggered. |
{{first_triggered_at_epoch}}
See section below | The UTC date and time when the monitor first triggered in epoch milliseconds. |
{{last_triggered_at}}
See section below | The UTC date and time when the monitor last triggered. |
{{last_triggered_at_epoch}}
See section below | The UTC date and time when the monitor last triggered in epoch milliseconds. |
{{triggered_duration_sec}} | El número de segundos que el monitor ha estado en un estado activado. |
Variables activadas
El {{first_triggered_at}}, {{first_triggered_at_epoch}}, {{last_triggered_at}}, and {{last_triggered_at_epoch}} monitor template variables reflect the values when a monitor changes state, NOT when a new monitor event occurs. Renotification events show the same template variable if the monitor state has not changed. Use {{triggered_duration_sec}} para mostrar la duración en el momento del evento del monitor.
{{first_triggered_at}} is set when the monitor group goes from OK to a non-OK state or when a new group appears in a non-OK state. {{last_triggered_at}} gets set when the monitor group goes to a non-OK state independently from its previous state (including WARN → ALERT, ALERT → WARN). Additionally, {{last_triggered_at}} is set when a new group appears in a non-OK state. The difference is that {{last_triggered_at}} es independiente de su estado anterior.
Ejemplo: Cuando el monitor transita de OK → WARN, los valores de {{first_triggered_at}} and {{last_triggered_at}} ambos tienen la marca de tiempo A. La tabla a continuación muestra los valores hasta que el monitor se recupere.
| Transición | first_triggered_at | last_triggered_at | triggered_duration_sec |
|---|
OK → WARN | A | A | 0 |
WARN → ALERT | A | B | B - A |
ALERT → NO DATA | A | C | C - A |
NO DATA → OK | A | C | D - A |
Evaluación
Las variables de plantilla que devuelven valores numéricos admiten operaciones y funciones, lo que permite realizar operaciones matemáticas o cambios de formato en el valor. Para más detalles, consulte Evaluación de Variables de Plantilla.
Hora local
Utiliza la local_time función para agregar otra fecha en tu notificación en la zona horaria de tu elección. Esta función transforma una fecha en su hora local: {{local_time 'time_variable' 'timezone'}}.
Por ejemplo, para agregar el último momento en que se activó el monitor en la zona horaria de Tokio en tu notificación, incluye lo siguiente en el mensaje de notificación:
{{local_time 'last_triggered_at' 'Asia/Tokyo'}}
El resultado se muestra en el formato ISO 8601: yyyy-MM-dd HH:mm:ss±HH:mm, por ejemplo 2021-05-31 23:43:27+09:00.
Consulta la lista de zonas horarias de la base de datos tz, particularmente la columna del nombre de la base de datos TZ, para ver la lista de valores de zona horaria disponibles.
Avanzado
Manejadores dinámicos
Utiliza variables de etiqueta para construir dinámicamente manejadores de notificación y dirigir notificaciones al equipo o servicio adecuado según el tipo de problema detectado por tu monitor.
Ejemplo: Si tu monitor consulta una métrica y la agrupa por una service etiqueta, puedes hacer que tus notificaciones se dirijan a diferentes canales de Slack dependiendo del servicio que falla:
@slack-{{service.name}} There is an ongoing issue with {{service.name}}.
Si tu monitor comienza a fallar en el grupo service:ad-server, la notificación se envía al canal de Slack #ad-server con el siguiente contenido:
@slack-ad-server There is an ongoing issue with ad-server.
Al construir manejadores dinámicos con atributos que pueden no estar siempre presentes, puedes encontrar problemas con la entrega de notificaciones. Si falta un atributo, la variable se renderiza vacía en el mensaje de notificación, lo que resulta en un manejador inválido.
Para evitar notificaciones perdidas al usar manejadores dinámicos con estas variables, asegúrate de agregar un manejador de respaldo:
{{#is_exact_match "kube_namespace.owner" ""}}
@slack-example
// This will notify @slack-example if the kube_namespace.owner variable is empty or does not exist.
{{/is_exact_match}}
Enlaces dinámicos
Utiliza variables de etiqueta para habilitar la construcción dinámica de URL que vincule a tu equipo a un recurso apropiado. Por ejemplo, puedes proporcionar enlaces a páginas dentro de Datadog, como tableros, el mapa de hosts y monitores.
Utiliza el {{host.name}} variable de etiqueta para proporcionar un enlace a un tablero del sistema:
https://app.datadoghq.com/dash/integration/system_overview?tpl_var_scope=host:{{host.name}}
Utiliza el {{host.name}} tag variable and an <INTEGRATION_NAME> para proporcionar un enlace a un tablero de integración:
https://app.datadoghq.com/dash/integration/<INTEGRATION_NAME>?tpl_var_scope=host:{{host.name}}
Utiliza el {{last_triggered_at_epoch}} template variable as well as a <DASHBOARD_ID> and <DASHBOARD_NAME> para enlazar a Dashboards con rangos de tiempo relativos desde el momento de la alerta:
https://app.datadoghq.com/dashboard/<DASHBOARD_ID>/<DASHBOARD_NAME>?from_ts={{eval "last_triggered_at_epoch-10*60*1000"}}&to_ts={{eval "last_triggered_at_epoch+10*60*1000"}}&live=false
Utiliza una variable de etiqueta como {{service.name}} para proporcionar un enlace al mapa de servidores:
https://app.datadoghq.com/infrastructure/map?filter=service:{{service.name}}
El enlace del mapa de servidores es personalizable con parámetros adicionales. Los más comunes son:
| Parámetro | Definido con | Determina |
|---|
fillby | fillby=avg:<METRIC_NAME> | El color de relleno de los hexágonos de los servidores. |
groupby | groupby=<TAG_KEY> | Los grupos para los hexágonos de los servidores. |
sizeby | sizeby=avg:<METRIC_NAME> | El tamaño de los hexágonos de los servidores. |
Utiliza el {{host.name}} variable de etiqueta para proporcionar un enlace a todos los monitors relacionados con un servidor específico:
https://app.datadoghq.com/monitors/manage?q=scope:host:{{host.name}}
El enlace del seguimiento es personalizable con parámetros adicionales. Los más comunes son:
| Parámetro | Ejemplo | Muestra |
|---|
status | status:Alert | Seguimientos en estado de alerta (estados adicionales: WARN, NO DATA y OK) |
muted | muted: true | Seguimientos silenciados (usa false para seguimientos no silenciados) |
type | type:log | Monitores de registros (ver otros tipos de seguimientos) |
Utiliza el {{last_triggered_at_epoch}} variable de plantilla para proporcionar un enlace a todos los registros que ocurren en el momento de la alerta.
https://app.datadoghq.com/logs?from_ts={{eval "last_triggered_at_epoch-10*60*1000"}}&to_ts={{eval "last_triggered_at_epoch+10*60*1000"}}&live=false
El enlace de registros es personalizable con parámetros adicionales. Los más comunes son:
| Parámetro | Definido con | Determina |
|---|
service | service=<SERVICE_NAME> | Filtrar en registros de un servicio específico. |
host | host=<HOST_NAME> | Filtrar en registros de un servidor específico |
status | status=<STATUS> | Estado de los registros: Error, Advertencia, Información, etc. |
Para incluir un comentario en el mensaje del monitor, utiliza la sintaxis:
{{!-- this is a comment --}}
{{!-- this is a comment }}
Si tu mensaje de alerta necesita enviar llaves dobles, como {{ <TEXT> }}, use {{{{raw}}}} formato. Por ejemplo, lo siguiente:
{{{{raw}}}}
{{ <TEXT_1> }} {{ <TEXT_2> }}
{{{{/raw}}}}
Salidas:
{{ <TEXT_1> }} {{ <TEXT_2> }}
Los ^|# ayudantes utilizados en variables condicionales no pueden ser utilizados con {{{{raw}}}} formatting and must be removed. For instance, to output raw text with the {{is_match}} variable condicional utiliza la siguiente plantilla:
{{{{is_match "host.name" "<HOST_NAME>"}}}}
{{ .matched }} the host name
{{{{/is_match}}}}
Si host.name coincide con <HOST_NAME>, la plantilla produce:
{{ .matched }} the host name
Codificar URL
Si tu mensaje de alerta incluye información que necesita ser codificada en una URL (por ejemplo, para redirecciones), utiliza el {{ urlencode "<variable>"}} sintaxis.
Ejemplo: Si el mensaje de tu monitor incluye una URL al Catálogo de Software filtrado a un servicio específico, utiliza la service variable de etiqueta y agrega el {{ urlencode "<variable>"}} sintaxis a la URL:
https://app.datadoghq.com/services/{{urlencode "service.name"}}
Lectura adicional
Más enlaces, artículos y documentación útiles:
