Plantillas de mensajes de notificación

Las plantillas de mensajes de notificación le permiten personalizar los datos de su evento de notificación antes de enviarlos a su destino externo. Las plantillas asignan sus valores personalizados a los valores utilizados por su destino de terceros.

Esto le brinda control total sobre qué datos se enviarán y dónde, además de poder participar plenamente en los servicios que utiliza.

Variables de plantilla de mensaje

Una plantilla de mensaje es lo que se utiliza para convertir los datos del evento New Relic en datos que puede consumir su servicio de terceros. Las variables son atributos específicos que se asignan a campos de datos en su servicio de terceros.

Las plantillas de mensajes están escritas en un lenguaje de plantillas sencillo llamado Manillar. Las variables en las plantillas de mensajes se escriben como expresiones dentro de llaves dobles {{ }}.

El menú de variables.

Los nombres de las variables de New Relic se enumeran en el menú de variables de la plantilla de mensaje. Las variables se agrupan en subcategorías.

En el menú de variables, escriba {{ para seleccionar de una lista de variables. A medida que escribe, los nombres de las variables aparecen mediante autocompletar. El tipo de variable está escrito en el lado derecho. Puede agregar datos enriquecidos a estas variables.

Utilice la sintaxis de manillares

Cuando un evento genera una notificación, la plantilla de mensaje utiliza las variables del manillar para asignar los datos de la notificación a los campos utilizados por su servicio de terceros.

El lenguaje de manillar proporciona muchas características además del reemplazo básico de variables, incluida la evaluación de funciones y objetos de entrada anidados , como iteraciones (bucles), declaraciones condicionales y más. En Manillar, estas funciones se denominan ayudantes. Haga clic aquí para obtener una explicación de las variables utilizadas para el flujo de trabajo.

Funciones auxiliares

Nuestras plantillas de mensajes son compatibles con los asistentes integrados de Manubrios.

Además, hemos agregado otras ayudas que podrían resultarle útiles.

{
  "data": {
    "tags": ["infra, team-a"]
  }
}

{{json data.tags}}

["infra", "team-a"]

Compares variables a and b, renders 'yes' or 'no':

{{#eq a b}} yes {{else}} no {{/eq}}

Compares string value "a" to variable b, renders 'yes' or 'no':

{{#eq "a" b}} yes {{else}} no {{/eq}}

Renders 'true' or 'false':

{{eq a b}}

Renders 'y' or 'n':

{{eq a b yes='y' no='n'}}

Asserts that b contains a, renders 'yes' or 'no':

{{#contains a b}} yes {{else}} no {{/contains}}

Asserts that variable b contains string value "a", renders 'yes' or 'no':

{{#contains "a" b}} yes {{else}} no {{/contains}}

Renders 'true' or 'false':

{{contains a b}}

Renders 'y' or 'n':

{{contains a b yes='y' no='n'}}

Renders addition of two number values:

{{#math openIncidentsCount '+' closedIncidentsCount}} {{/math}}

Renders subtraction of two number values:

{{#math createdAt '-' closedAt}}{{/math}}

Renders multiplication of two number values:

{{#math 3 '*' 3}}{{/math}}

Renders division of two number values:

{{#math 9 '/' 3}}{{/math}}

{{#timezone createdAt 'US/Eastern'}}{{/timezone}}

"2023-06-06 09:45:07 EDT"

{{#timezone 1686059107319 'Europe/Paris'}}{{/timezone}}

"2023-06-06 15:45:07 GMT+2"

{{#replace "dog" "The dog likes to eat"}}cat{{/replace}}

The cat likes to eat

{{#replace "cat" "The dog likes to eat"}}mouse{{/replace}}

{{#replace "cat" "The dog likes to eat"}}mouse{{else}}There is no cat to replace{{/replace}}

There is no cat to replace

{{#replace "/dog/i" "The DOG likes to eat"}}cat{{/replace}}

The cat likes to eat

{{#replace needle haystack}}{{replacement}}{{/replace}}

{
  "needle": "/dog/i",
  "haystack": "The DOG likes to eat",
  "replacement": "cat"
}

The cat likes to eat

Nuestras funciones auxiliares también se pueden anidar. Aquí hay un ejemplo:

{{#eq "a" b}} yes1 {{else}}{{#eq "a" c}} yes2 {{else}} no {{/eq}}{{/eq}}

Ejemplos de uso

Los ejemplos se basan en una variable llamada data:

"data": {
  "tags":["infra, team-a"],
  "id":123456789,
  "name": "Alice",
}

El valor data tiene un formato equivalente con puntos:

"data.tags": ["infra, team-a"]
"data.id": 123456789
"data.name": "Alice"

Validar datos

Si id es igual a 123456789, entonces el resultado es valid. Si no, la salida es not valid.

{{eq data.name "Alice" yes='valid' no='not valid'}}

Si name es igual a Alice, entonces el resultado es valid.

Devolver JSON

Obtenga tags y las propiedades del objeto en formato JSON:

{{json data.tags}}

Esto devolvería el siguiente JSON:

["infra", "team-a"]

Obtener valores de una matriz

Obtenga la primera etiqueta de la matriz tags :

{{json data.tags.[0]}}

Esto devolvería el primer valor de la matriz:

"infra"

Iterar a través de una matriz

Itere una variable de tipo matriz y agregue los valores en una cadena:

{{#each tags}}{{this}}{{#unless @last}}, {{/unless}}{{/each}}

El resultado contiene la etiqueta, separada por comas (se omite la coma final):

infra, team

De manera similar, itere la variable data , agregue los valores del objeto y genere un elemento JSON:

{{#each (json data)}}{{this}}{{/each}}

Esto devolvería un JSON como:

{
  "tags": ["infra, team-a"],
  "name": "Alice",
  "id": "123456789"
}

Itere la variable data y luego agregue las entradas del objeto a una cadena:

{{#each data}}{{@key}}: {{this}}{{#unless @last}}, {{/unless}}{{/each}}

Esto devolvería una cadena como:

tags: infra,team-a, name: Alice, id: 123456789

Manejar el atributo que falta

En algunos casos, como en el caso de etiquetas que no estaban presentes en números anteriores, es posible que falte un atributo en el menú de variables o que no exista en absoluto.

Podemos usar la instrucción #if para establecer un respaldo, como por ejemplo:

{{#if data.type}} {{ json data.type }} {{else}}"N/A"{{/if}}

Esto devolvería la cadena "N/A".