알림 메시지에 변수를 사용해 조건부 메시징을 표시하고 조건 변수를 사용하여 알림을 여러 팀으로 라우팅하거나 속성 및 태그 변수와 템플릿 변수를 사용하여 메시지 내용을 보강하세요.

조건 변수

조건 변수는 if-else 로직을 사용하여 모니터의 상태, 어떻게 트리거되었는지 세부 정보에 따라 다른 메시지를 표시합니다. 이러한 변수는 알림 메시지의 제목이나 본문 안에서 사용할 수 있습니다.

사용 가능한 조건 변수는 다음과 같습니다.

예시

조건 변수는 텍스트로 시작과 끝을 페어로 지정하고 그 사이에 @-notifications가 있어야 합니다. 모니터 상태에 기반한 변수(예를 들어 is_alert 또는 is_warning)에는 자체 메시지 블록이 있어야 합니다. 모니터는 한 번에 한 가지 상태만 가능하기 때문에, 이러한 항목을 결합할 수는 없습니다. 하지만 속성에서 일치하는 조건은 중첩할 수 있습니다(is_renotify 예시 참조).

{{#is_alert}}
  <ALERT_MESSAGE_TEXT> <@-NOTIFICATION>
{{/is_alert}}

{{#is_warning}}
  <WARNING_MESSAGE_TEXT> <@-NOTIFICATION>
{{/is_warning}}

{{#is_recovery}}
  <RECOVERY_MESSAGE_TEXT> <@-NOTIFICATION>
{{/is_recovery}}

{{#is_match "<TAG_VARIABLE>.name" "<COMPARISON_STRING>"}}
  This displays if <COMPARISON_STRING> is included in <TAG_VARIABLE>.
{{/is_match}}

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

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

{{^is_match "host.role.name" "db"}}
  This displays if the role tag doesn't contain `db`.
  @slack-example
{{/is_match}}

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

{{#is_exact_match "<TAG_VARIABLE>.name" "<COMPARISON_STRING>"}}
  This displays if <COMPARISON_STRING> is exactly <TAG_VARIABLE>.
{{/is_exact_match}}

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

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

{{#is_exact_match "value" "<VALUE>"}}
  This displays if the value that breached the threshold of the monitor is exactly <VALUE>.
{{/is_exact_match}}

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

{{#is_exact_match "host.datacenter" ""}}
  This displays if the attribute or tag does not exist or if it's empty
{{/is_exact_match}}

{{#is_renotify}}
{{#is_match "env" "production"}}
  This is an escalation message sent to @dev-team@company.com
{{/is_match}}
{{/is_renotify}}

{{^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}}

This part is generic and sent both for the first trigger and the escalation message.

This is the escalation message @dev-team@company.com

@-notifications 핸들을 사용하여 alert 또는 warning 조건으로 상태 전환을 위해 조건 블록을 구성하는 경우, Datadog은 핸들에 복구 알림을 보내도록 해당하는 recovery 조건을 구성하는 편을 권장합니다.

참고: 구성된 조건 변수 외부에 배치된 모든 텍스트 또는 알림 핸들은 모니터 상태가 전환될 때마다 호출됩니다. 구성된 조건 변수 내부에 배치된 모든 텍스트 또는 알림 핸들은 모니터 상태 전환이 조건과 일치할 때만 호출됩니다.

속성 및 태그 변수

속성 및 태그 변수는 경보의 성격을 이해하는 데 도움이 되는 사용자 지정, 정보 제공용, 구체적인 경보 메시지를 렌더링하는 데 사용하세요. 예시 및 사용 사례는 다음 섹션 참조:

• 다중 경보 변수
• 일치하는 속성/태그 변수

태그

자동으로 연결되거나(예: 호스트 이름, 컨테이너 이름, 로그 파일 이름, 서버리스 함수 이름 등) 사용자 지정 태그를 통해 추가됩니다(담당 팀, 환경, 애플리케이션 또는 버전).

속성

로그 내용을 따르며 참조표에서 조회하여 구문 분석되거나 추가됩니다(예: geoip).

참고: 모니터가 데이터 없음 조건에서 복구되도록 구성된 경우(예를 들어 쿼리와 일치하는 이벤트가 없을 때), 복구 메시지에 아무런 데이터가 포함되지 않습니다. 복구 메시지에 정보를 계속 유지하려면 추가적인 태그 기준으로 그룹화하세요. 여기에는 {{tag.name}}으로 액세스할 수 있습니다.

다중 경보 변수

다중 경보 그룹 박스에서 선택한 디멘션에 따라 다중 경보 모니터에서 다중 경보 변수를 구성합니다. 알림을 강화하려면 각 경보의 그룹화 기준 디멘션과 연결된 값을 포함하세요.

참고: 집계에 group_by 필드를 사용하는 경우, 모니터에서 추가적인 태그 및 경보가 자동으로 상속될 수 있습니다. 다시 말해 모니터링되는 엔드포인트에 설정된 모든 경보 또는 구성이 집계로 인해 발생하는 각 그룹에 적용될 수 있습니다.

{{ key.name }}

{{[dot.key.test].name}}

{{ @facet_key.name }}

This alert was triggered on {{ @machine_id.name }}

{{ [@network.client.ip].name }}

그룹 기준으로 알림 사용자 지정

쿼리가 특정 디멘션을 기준으로 그룹화되는 경우, 그룹과 연결된 동적 메타데이터를 사용해 알림을 강화할 수 있습니다. 태그 선택에 따른 태그 변수 목록을 보려면 구성 알림 및 자동화 섹션 아래에 있는 메시지 템플릿 변수 사용을 클릭하세요. 다음 예시 참조:

{{service.links[Runbook]}}

일치하는 속성/태그 변수

모니터 쿼리와 일치하는 로그, 트레이스 스팬, RUM 이벤트, CI 파이프라인 또는 CI 테스트 이벤트의 속성 또는 태그를 아무것이나 포함할 수 있습니다. 다음 테이블에 다양한 모니터 유형에서 추가할 수 있는 속성 및 변수의 예를 표시했습니다.

중요 참고 사항

• 선택된 이벤트가 속성 또는 태그 키를 포함하지 않는 경우, 알림 메시지에서 변수가 빈 상태로 렌더링됩니다. 알림을 놓치지 않으려면 {{#is_match}} 핸들이 있는 알림을 라우팅하는 데 이러한 변수 사용을 피하세요.
• 쿼리에서 수식 및 함수를 사용하는 모니터의 경우, 값이 첫 번째 쿼리에서 추출한 이벤트에 따라 리졸브됩니다.

예약된 속성

로그, Event Management, 스팬, RUM, CI 파이프라인 및 CI 테스트 이벤트에는 일반적인 예약된 속성이 있고, 이것을 다음 구문과 함께 변수에 사용할 수 있습니다.

일치하는 이벤트의 정의에 속성이 포함되어 있지 않으면, 변수가 빈 상태로 렌더링됩니다.

탐색기 링크

{{log.link}}, {{span.link}}, {{rum.link}}, and {{issue.link}}를 사용하여 쿼리와 일치하는 이벤트에서 범위가 지정된 Log Explorer, Trace Explorer, RUM Explorer 또는 Error Tracking으로 이동하는 링크로 알림을 강화하세요.

모니터 변수 검사

검사 모니터 변수의 경우(사용자 지정 검사 및 통합 검사), 변수 {{check_message}}를 사용할 수 있으며 사용자 지정 검사 또는 통합 검사에 지정된 메시지를 렌더링합니다.

복합 모니터 변수

복합 모니터는 경보가 트리거될 때 하위 모니터와 연결된 값과 상태에 접근할 수 있습니다.

예를 들어 복합 모니터에 하위 모니터 a가 있는 경우, 다음을 사용하여 a 값을 포함할 수 있습니다.

{{ a.value }}

하위 모니터 a의 상태를 검색하려면 다음 사용:

{{ a.status }}

상태로 가능한 값은: OK, Alert, Warn, No Data입니다.

복합 모니터는 기본 모니터와 같은 방식으로 태그 변수도 지원합니다. 다른 모니터와 같은 형식을 따르며, 단 여기에는 기본 모니터가 동일한 태그 또는 패싯 기준으로 그룹화되어 있어야 한다는 전제 조건이 수반됩니다.

예를 들어 복합 모니터에 하위 모니터 a가 있고 이것이 로그 모니터라고 가정하겠습니다. 다음을 사용하여 a의 모든 태그 또는 패싯 값을 포함할 수 있습니다.

{{ a.log.message }} or {{ a.log.my_facet }}

문자 이스케이프

변수 내용은 기본적으로 HTML로 인코딩됩니다. 원시, 인코딩되지 않은 내용을 출력하려면 중괄호 두 개 대신 중괄호 세 개를 사용하세요.

예를 들어 변수의 값에 쿼리 파라미터가 있는 URL이 포함된 경우, &는 중괄호를 두 개 사용했는지, 세 개 사용했는지에 따라 다르게 취급됩니다.

예를 들어 HTML 인코딩 없이 검사 메시지를 렌더링하려면 다음과 같이 작성합니다.

{{{check_message}}}

이는 특히 {{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}}}를 사용하세요.

템플릿 변수

모니터 알림을 사용자 지정하려면 템플릿 변수를 사용합니다. 기본 제공 변수는 다음과 같습니다.

트리거된 변수

{{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}}를 사용하여 모니터 이벤트 시점의 지속 시간을 표시합니다.

{{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}}은 이전 상태와 무관합니다.

예시: 모니터가 OK → WARN로 전환되면, {{first_triggered_at}} and {{last_triggered_at}}의 값 둘 모두에 타임스탬프 A가 포함됩니다. 아래 표에 모니터가 복구될 때까지의 값을 표시했습니다.

평가

숫자 값을 반환하는 템플릿 변수는 연산과 함수를 지원하며, 이것을 사용하면 수학 연산을 수행하거나 값의 형식을 변경할 수 있습니다. 자세한 내용은 템플릿 변수 평가를 참조하세요.

현지 시각

알림에 선택한 표준 시간대로 날짜를 하나 더 추가하려면 local_time 함수를 사용하세요. 이 함수는 날짜를 현지 시각 {{local_time 'time_variable' 'timezone'}}으로 변환합니다. 예를 들어 알림에 모니터가 마지막으로 트리거된 시간을 도쿄 표준 시간대로 추가하려면, 알림 메시지에 다음 내용 포함:

{{local_time 'last_triggered_at' 'Asia/Tokyo'}}

결과는 ISO 8601 형식 yyyy-MM-dd HH:mm:ss±HH:mm으로 표시됩니다(예: 2021-05-31 23:43:27+09:00). 사용 가능한 표준 시간대 값 목록은 tz 데이터베이스 표준 시간대 목록, 특히 TZ 데이터베이스 이름 열을 참조하세요.

고급

동적 핸들

태그 변수를 사용하면 동적으로 알림 핸들을 구축하고, 모니터가 감지한 문제의 유형에 따라 알림을 적절한 팀 또는 서비스로 라우팅할 수 있습니다.

예: 모니터가 메트릭을 쿼리하고 이를 service 태그 기준으로 그룹화하는 경우, 실패하는 서비스에 따라 알림을 여러 다른 Slack 채널로 라우팅할 수 있습니다.

@slack-{{service.name}} There is an ongoing issue with {{service.name}}.

모니터가 service:ad-server 그룹부터 실패하기 시작하는 경우, #ad-server Slack 채널로 다음과 같은 내용의 알림이 전송됩니다.

@slack-ad-server There is an ongoing issue with ad-server.

항상 있지는 않을 수 있는 속성으로 동적 핸들을 구축하면 알림 전송과 관련해 문제가 발생할 수 있습니다. 속성이 누락되면 알림 메시지에 변수가 빈 것으로 렌더링되고, 따라서 잘못된 핸들이 생성됩니다.

이러한 변수로 동적 핸들을 사용할 때 알림 누락을 피하려면 폴백 핸들을 추가하세요.

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

동적 링크

태그 변수를 사용하여 팀을 적절한 리소스로 연결하는 동적 URL 구축을 활성화할 수 있습니다. 예를 들어 대시보드, 호스트 맵, 모니터와 같이 Datadog 안의 페이지로 이동하는 링크를 제공할 수 있습니다.

https://app.datadoghq.com/dash/integration/system_overview?tpl_var_scope=host:{{host.name}}

https://app.datadoghq.com/dash/integration/<INTEGRATION_NAME>?tpl_var_scope=host:{{host.name}}

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

https://app.datadoghq.com/infrastructure/map?filter=service:{{service.name}}

https://app.datadoghq.com/monitors/manage?q=scope:host:{{host.name}}

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

주석

모니터 메시지에 주석을 포함하려면 다음 구문 사용:

{{!-- this is a comment --}}
{{!-- this is a comment }}

Raw 형식

경보 메시지가 중괄호 두 개, 예를 들어 {{ <TEXT> }}, use {{{{raw}}}} 형식을 보내야 하는 경우입니다. 예를 들면 다음과 같습니다.

{{{{raw}}}}
{{ <TEXT_1> }} {{ <TEXT_2> }}
{{{{/raw}}}}

출력:

{{ <TEXT_1> }} {{ <TEXT_2> }}

조건 변수에 사용된 ^|# 도우미는 {{{{raw}}}} formatting and must be removed. For instance, to output raw text with the {{is_match}} conditional variable use the following template:

{{{{is_match "host.name" "<HOST_NAME>"}}}}
{{ .matched }} the host name
{{{{/is_match}}}}

host.name이 <HOST_NAME>과 일치하면, 템플릿이 다음을 출력함:

{{ .matched }} the host name

URL 인코드

경보 메시지에 URL로 인코딩해야 하는 정보가 포함된 경우(예를 들어 리디렉션용으로) {{ urlencode "<variable>"}} 구문을 사용하세요.

예: 모니터 메시지에 특정 서비스로 필터링된 Software Catalog로 이동하는 URL이 포함된 경우, service 태그 변수를 사용하고 URL에 {{ urlencode "<variable>"}} 구문을 추가하세요.

https://app.datadoghq.com/services/{{urlencode "service.name"}}

추가 자료

추가 유용한 문서, 링크 및 기사:

템플릿 변수 평가를 사용하여 산술 연산 및 함수를 수행합니다.가이드 모니터 생성설명서 모니터링 알림설명서 모니터 관리설명서 코스를 듣고 경보 모니터 알림 사용자 지정학습 센터 Datadog 모니터 알림 규칙을 사용해 모니터 경보 라우팅블로그