문서 템플릿의 변수

이 페이지에서는 알림 정책과 관련된 문서 템플릿에 사용할 수 있는 변수 및 채널별 컨트롤에 관해 설명합니다.

변수 사용

Markdown 외에도 ${varname} 형식의 변수를 사용해 문서 콘텐츠를 조정할 수 있습니다. 문서를 알림과 함께 전송하면 ${varname} 문자열이 varname의 값을 대체합니다. 다음 스크린샷에서는 문서 추가에 설명된 문서 템플릿으로 만든, 이메일 알림에 포함된 문서를 보여줍니다.

이메일의 문서

문서 필드에 사용할 수 있는 변수는 다음과 같습니다.

변수
condition.name 조건의 REST 리소스 이름(예: projects/foo/alertPolicies/1234/conditions/5678)
condition.display_name 조건의 표시 이름(예: CPU usage increasing rapidly)
metric.type 측정항목 유형(예: compute.googleapis.com/instance/cpu/utilization)
metric.display_name 측정항목 유형의 표시 이름(예: CPU utilization)
metric.label.[KEY] 측정항목 라벨 key1
policy.user_label.[KEY] 사용자 라벨 key1,2
policy.name 정책의 REST 리소스 이름(예: projects/foo/alertPolicies/1234)
policy.display_name 정책의 표시 이름(예: High CPU rate of change)
project 작업공간의 프로젝트 ID(예: a-gcp-project)
resource.project 알림 정책 모니터링 리소스의 프로젝트 ID
resource.type 모니터링 리소스의 유형(예: api)
resource.label.[KEY] 리소스 라벨 key1

1 예를 들어 ${resource.label.zone}zone 라벨 값으로 대체됩니다.
2 Monitoring API를 사용하여 정책의 사용자 라벨을 설정할 수 있습니다.

참고

  • 표에 나온 변수만 지원됩니다. ${varname1 + varname2} 같이 더 복잡한 표현식으로 변수를 결합할 수 없습니다.

  • 문서에 리터럴 문자열 ${을 포함하려면 $ 기호를 두 번째 $ 기호로 이스케이프 처리합니다. 그러면 문서에서 $${${로 렌더링됩니다.

채널 컨트롤 사용

알림 채널에서 사용하는 특수 문자를 문서 필드의 텍스트에 포함시켜 형식 지정 및 알림을 컨트롤할 수도 있습니다.

예를 들어 Slack에서는 멘션에 @를 사용합니다. 이를 사용해 알림을 특정 사용자에게 연결할 수 있습니다. 이와 같은 문자열을 문서 필드에 포함한다고 가정해 보겠습니다.

<@backendoncall> policy ${policy.display_name} triggered an incident

관련 Slack 채널에서 알림의 일부로 문서 필드를 받으면 이 행에서 사용자 backendoncall에게 추가 메시지를 트리거합니다(예: policy High CPU rate of change triggered an incident).

제공되는 추가 옵션은 채널마다 다릅니다. 사용 가능한 옵션에 대한 자세한 내용은 채널 공급업체가 제공하는 문서를 참조하세요.

이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...

Stackdriver Monitoring
도움이 필요하시나요? 지원 페이지를 방문하세요.