알림 메시지 템플릿

알림 메시지 템플릿을 사용하면 알림 이벤트 데이터를 타사 대상으로 보내기 전에 사용자 지정할 수 있습니다. 템플릿은 사용자 지정 값을 타사 대상에서 사용하는 값에 매핑합니다.

이를 통해 전송되는 데이터와 위치를 완전히 제어할 수 있을 뿐만 아니라 사용하는 서비스에 완전히 참여할 수 있습니다.

메시지 템플릿 변수

메시지 템플릿은 New Relic 이벤트 데이터를 타사 서비스에서 사용할 수 있는 데이터로 변환하는 데 사용하는 것입니다. 변수는 타사 서비스의 데이터 필드에 매핑되는 특정 속성입니다.

메시지 템플릿은 Handlebars 라는 간단한 템플릿 언어로 작성됩니다. 메시지 템플릿의 변수는 이중 중괄호 {{ }} 안에 표현식 으로 작성됩니다.

변수 메뉴

New Relic 변수 이름은 메시지 템플릿 변수 메뉴에 나열됩니다. 변수는 하위 범주로 그룹화됩니다.

변수 메뉴에서 {{ 을 입력하여 변수 목록에서 선택합니다. 입력할 때 자동 완성을 통해 변수 이름이 나타납니다. 변수 유형은 오른쪽에 기록됩니다. 이러한 변수에 풍부한 데이터를 추가할 수 있습니다.

핸들바 구문 사용

이벤트가 알림을 생성하면 메시지 템플릿은 핸들바 변수를 사용하여 알림 데이터를 타사 서비스에서 사용하는 필드에 매핑합니다.

Handlebars 언어는 반복(루프), 조건문 등과 같은 중첩 입력 개체 및 함수 평가를 포함하여 기본 변수 대체 외에도 많은 기능을 제공합니다. 핸들바에서 이러한 기능을 도우미라고 합니다.

도우미 기능

메시지 템플릿은 핸들바에 내장된 도우미를 지원합니다.

또한 유용할 수 있는 다른 도우미를 추가했습니다.

{
  "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'}}

{{#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

사용 예

예는 data 이라는 변수를 기반으로 합니다.

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

data 값은 동등한 점 표기 형식을 가집니다.

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

데이터 검증

id 이 123456789 이면 출력은 valid 입니다. 그렇지 않은 경우 출력은 not valid 입니다.

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

name 이 Alice 이면 출력은 valid 입니다.

JSON 반환

JSON 형식으로 tags 및 객체 속성을 가져옵니다.

{{json data.tags}}

그러면 다음 JSON이 반환됩니다.

["infra", "team-a"]

배열에서 값 가져오기

tags 배열에서 첫 번째 태그를 가져옵니다.

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

이렇게 하면 배열에서 첫 번째 값이 반환됩니다.

$
"infra"

배열을 통해 반복

배열 유형의 변수를 반복하고 값을 문자열로 집계합니다.

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

결과에는 쉼표로 구분된 태그가 포함됩니다(후행 쉼표는 생략됨).

$
infra, team

마찬가지로 data 변수를 반복하고 객체의 값을 집계하고 JSON 요소를 출력합니다.

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

그러면 다음과 같은 JSON이 반환됩니다.

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

data 변수를 반복한 다음 객체의 항목을 문자열로 집계합니다.

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

그러면 다음과 같은 문자열이 반환됩니다.

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

누락된 속성 처리

어떤 경우에는 변수 메뉴 에서 속성이 누락되거나 존재하지 않을 수 있습니다.

#if 문을 사용하여 다음과 같이 대체를 설정할 수 있습니다.

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

문자열 "N/A" 을 반환합니다.