알림 템플릿 생성 - Amazon Managed Grafana

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

알림 템플릿 생성

이 설명서 항목은 Grafana 버전 10.x를 지원하는 Grafana 작업 영역을 위해 설계되었습니다.

Grafana 버전 9.x를 지원하는 Grafana 작업 영역에 대한 내용은 을 참조하십시오. Grafana 버전 9에서 작업하기

Grafana 버전 8.x를 지원하는 Grafana 작업 영역에 대해서는 을 참조하십시오. Grafana 버전 8에서 작업하기

재사용 가능한 알림 템플릿을 만들어 연락처로 보내세요.

알림 템플릿에 하나 이상의 템플릿을 추가할 수 있습니다.

알림 템플릿 이름은 고유해야 합니다. 같은 알림 템플릿이나 다른 알림 템플릿에 이름이 같은 두 개의 템플릿을 둘 수는 없습니다. 기본 템플릿과 이름이 같은 템플릿 (예:__subject,,,) 은 정의하지 마십시오default.message. __text_values_list __text_alert_list default.title

연락처 탭에서 알림 템플릿 목록을 볼 수 있습니다.

알림 템플릿 만들기

알림 템플릿을 만들려면
  1. 알림 관리 포털 IRM, 연락처를 선택합니다.

  2. 알림 템플릿 탭을 선택한 다음 + 알림 템플릿 추가를 선택합니다.

  3. 알림 템플릿의 이름을 선택합니다 (예:)email.subject.

  4. 콘텐츠 필드에 템플릿의 콘텐츠를 작성합니다.

    예:

    {{ if .Alerts.Firing -}} {{ len .Alerts.Firing }} firing alerts {{ end }} {{ if .Alerts.Resolved -}} {{ len .Alerts.Resolved }} resolved alerts {{ end }}
  5. 변경 내용을 저장합니다.

    {{ define "email.subject" }}(여기서 email.subject 은 템플릿 이름) {{ end }} 이며 콘텐츠의 시작과 끝에 자동으로 추가됩니다.

두 개 이상의 템플릿이 포함된 알림 템플릿을 만들려면
  1. 알림 관리 포털 IRM, 연락처를 선택합니다.

  2. 알림 템플릿 탭을 선택한 다음 + 알림 템플릿 추가를 선택합니다.

  3. 전체 알림 템플릿의 이름을 입력합니다. 예를 들어 email입니다.

  4. 각 템플릿의 {{ define "name-of-template" }} 시작과 {{ end }} 끝을 포함하여 콘텐츠 필드에 각 템플릿을 작성합니다. 알림 템플릿의 각 템플릿에 설명이 포함된 이름을 사용할 수 있습니다 (예: email.subject 또는email.message). 이 경우 위에서 입력한 알림 템플릿의 이름을 다시 사용하지 마십시오.

    이후 섹션에서는 만들 수 있는 템플릿의 자세한 예를 보여줍니다.

  5. 저장을 클릭합니다.

알림 템플릿 미리 보기

연락처에서 알림 템플릿을 사용하기 전에 알림 템플릿이 어떻게 보일지 미리 볼 수 있으므로 만들고 있는 템플릿의 결과를 이해하는 데 도움이 될 뿐만 아니라 템플릿을 저장하기 전에 오류를 수정할 수 있습니다.

참고

알림 미리보기는 Grafana Alertmanager에서만 사용할 수 있습니다.

알림 템플릿을 미리 보려면
  1. 알림 관리 포털 IRM, 연락처를 선택합니다.

  2. 알림 템플릿 탭을 선택한 다음 + 알림 템플릿 추가 또는 기존 템플릿을 편집합니다.

  3. 템플릿 콘텐츠를 추가하거나 업데이트하세요.

    기본 데이터가 제공되며 이 데이터에 경고 데이터와 경고 인스턴스를 추가하거나 편집할 수 있습니다. 페이로드 데이터 창에서 직접 알림 데이터를 추가하거나 알림 인스턴스 선택 또는 사용자 지정 알림 추가를 클릭할 수 있습니다.

  4. [선택 사항] 기존 알림 인스턴스의 알림 데이터를 추가하려면:

    1. 알림 인스턴스 선택을 선택합니다.

    2. 알림 인스턴스 위에 마우스를 놓으면 각 알림 인스턴스에 대한 자세한 정보를 볼 수 있습니다/

    3. 확인을 선택하여 페이로드에 알림 인스턴스를 추가합니다.

  5. [선택 사항] 경고 데이터 편집기를 사용하여 경고 데이터를 추가하려면 사용자 지정 데이터 추가를 선택합니다.

    1. 주석, 사용자 지정 레이블을 추가하거나 대시보드 또는 패널을 설정합니다.

    2. 알림에 실행 알림을 추가할지 아니면 해결된 알림을 추가할지에 따라 실행 또는 해결을 전환할 수 있습니다.

    3. 알림 데이터 추가를 선택합니다.

    4. 새로 고침 미리보기를 선택하여 템플릿 콘텐츠가 어떻게 보일지 확인하고 해당 페이로드 데이터를 확인할 수 있습니다.

    템플릿에 오류가 있는 경우 미리보기에 표시되며 저장하기 전에 수정할 수 있습니다.

  6. 변경 내용을 저장합니다.

메시지 제목의 템플릿 만들기

다음 예와 같이 발생 및 해결된 알림 수가 포함된 이메일 제목의 템플릿을 생성하십시오.

1 firing alerts, 0 resolved alerts
이메일 제목의 템플릿을 만들려면
  1. 다음 내용이 email.subject 포함된 템플릿을 생성합니다.

    {{ define "email.subject" }} {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts {{ end }}
  2. 연락처 통합을 만들 때 템플릿을 template 키워드와 함께 제목 필드에 입력하여 사용하십시오.

    {{ template "email.subject" . }}

이메일 메시지를 위한 템플릿 만들기

다음 예와 같이 모든 발생 및 해결된 알림의 요약이 포함된 이메일 메시지용 템플릿을 생성하십시오.

There are 2 firing alerts, and 1 resolved alerts Firing alerts: - alertname=Test 1 grafana_folder=GrafanaCloud has value(s) B=1 - alertname=Test 2 grafana_folder=GrafanaCloud has value(s) B=2 Resolved alerts: - alertname=Test 3 grafana_folder=GrafanaCloud has value(s) B=0
이메일 메시지의 템플릿을 만들려면
  1. 내용에 두 개의 템플릿 (emailemail.message_alert및) 이 들어 있는 알림 템플릿을 만드십시오email.message.

    email.message_alert템플릿은 각 발생 및 해결된 알림의 레이블과 값을 인쇄하는 데 사용되며 email.message 템플릿에는 이메일의 구조가 포함되어 있습니다.

    {{- define "email.message_alert" -}} {{- range .Labels.SortedPairs }}{{ .Name }}={{ .Value }} {{ end }} has value(s) {{- range $k, $v := .Values }} {{ $k }}={{ $v }}{{ end }} {{- end -}} {{ define "email.message" }} There are {{ len .Alerts.Firing }} firing alerts, and {{ len .Alerts.Resolved }} resolved alerts {{ if .Alerts.Firing -}} Firing alerts: {{- range .Alerts.Firing }} - {{ template "email.message_alert" . }} {{- end }} {{- end }} {{ if .Alerts.Resolved -}} Resolved alerts: {{- range .Alerts.Resolved }} - {{ template "email.message_alert" . }} {{- end }} {{- end }} {{ end }}
  2. 연락처 통합을 만들 때 템플릿을 template 키워드와 함께 텍스트 본문 필드에 입력하여 사용하십시오.

    {{ template "email.message" . }}

Slack 메시지 제목을 위한 템플릿 만들기

다음 예와 같이 발생 및 해결된 알림 수가 포함된 Slack 메시지 제목의 템플릿을 만드세요.

1 firing alerts, 0 resolved alerts
Slack 메시지 제목의 템플릿을 만들려면
  1. 다음 내용이 slack.title 포함된 템플릿을 생성하십시오.

    {{ define "slack.title" }} {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts {{ end }}
  2. 연락처 통합의 제목 필드에서 템플릿을 실행합니다.

    {{ template "slack.title" . }}

Slack 메시지 콘텐츠를 위한 템플릿 만들기

레이블, 주석, 대시보드 URL을 포함하여 모든 발생 및 해결된 알림에 대한 설명이 포함된 Slack 메시지 내용을 위한 템플릿을 만드세요.

참고

이 템플릿은 Grafana 관리 알림 전용입니다. 데이터 소스 관리 알림에 템플릿을 사용하려면 대시보드 URL 및 SilenceURL에 대한 참조를 삭제하세요. Prometheus 알림 구성에 대한 자세한 내용은 알림에 대한 Prometheus 설명서를 참조하십시오.

1 firing alerts: [firing] Test1 Labels: - alertname: Test1 - grafana_folder: GrafanaCloud Annotations: - description: This is a test alert Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1 1 resolved alerts: [firing] Test2 Labels: - alertname: Test2 - grafana_folder: GrafanaCloud Annotations: - description: This is another test alert Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1
Slack 메시지 콘텐츠를 위한 템플릿을 만들려면
  1. 콘텐츠에 두 개의 템플릿 (slack.print_alertslack.message) 이 slack 포함된 템플릿을 생성하세요.

    slack.print_alert템플릿은 레이블, 주석 및 대시보드 URL을 인쇄하는 데 사용되며 slack.message 템플릿에는 알림 구조가 포함되어 있습니다.

    {{ define "slack.print_alert" -}} [{{.Status}}] {{ .Labels.alertname }} Labels: {{ range .Labels.SortedPairs -}} - {{ .Name }}: {{ .Value }} {{ end -}} {{ if .Annotations -}} Annotations: {{ range .Annotations.SortedPairs -}} - {{ .Name }}: {{ .Value }} {{ end -}} {{ end -}} {{ if .DashboardURL -}} Go to dashboard: {{ .DashboardURL }} {{- end }} {{- end }} {{ define "slack.message" -}} {{ if .Alerts.Firing -}} {{ len .Alerts.Firing }} firing alerts: {{ range .Alerts.Firing }} {{ template "slack.print_alert" . }} {{ end -}} {{ end }} {{ if .Alerts.Resolved -}} {{ len .Alerts.Resolved }} resolved alerts: {{ range .Alerts.Resolved }} {{ template "slack.print_alert" .}} {{ end -}} {{ end }} {{- end }}
  2. 연락처 통합의 텍스트 본문 필드에서 템플릿을 실행합니다.

    {{ template "slack.message" . }}

공유 템플릿을 사용하여 이메일과 Slack을 모두 템플릿으로 작성하십시오.

이메일과 Slack과 같은 각 연락처에 대해 별도의 알림 템플릿을 만드는 대신 동일한 템플릿을 공유할 수 있습니다.

예를 들어 이 제목이 포함된 이메일과 이 제목의 Slack 메시지를 보내려는 경우 공유 1 firing alerts, 0 resolved alerts 템플릿을 만들 수 있습니다.

공유 템플릿을 만들려면
  1. 다음 내용이 common.subject_title 포함된 템플릿을 생성하십시오.

    {{ define "common.subject_title" }} {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts {{ end }}
  2. 이메일의 경우 이메일 연락처 통합의 제목 필드에서 템플릿을 실행합니다.

    {{ template "common.subject_title" . }}
  3. Slack의 경우 Slack 연락처 통합의 제목 필드에서 템플릿을 실행하세요.

    {{ template "common.subject_title" . }}