기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
알림 템플릿 생성
이 설명서 항목은 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
연락처 탭에서 알림 템플릿 목록을 볼 수 있습니다.
알림 템플릿 만들기
알림 템플릿을 만들려면
-
알림 관리 포털 IRM, 연락처를 선택합니다.
-
알림 템플릿 탭을 선택한 다음 + 알림 템플릿 추가를 선택합니다.
-
알림 템플릿의 이름을 선택합니다 (예:)
email.subject
. -
콘텐츠 필드에 템플릿의 콘텐츠를 작성합니다.
예:
{{ if .Alerts.Firing -}} {{ len .Alerts.Firing }} firing alerts {{ end }} {{ if .Alerts.Resolved -}} {{ len .Alerts.Resolved }} resolved alerts {{ end }}
-
변경 내용을 저장합니다.
{{ define "email.subject" }}
(여기서email.subject
은 템플릿 이름){{ end }}
이며 콘텐츠의 시작과 끝에 자동으로 추가됩니다.
두 개 이상의 템플릿이 포함된 알림 템플릿을 만들려면
-
알림 관리 포털 IRM, 연락처를 선택합니다.
-
알림 템플릿 탭을 선택한 다음 + 알림 템플릿 추가를 선택합니다.
-
전체 알림 템플릿의 이름을 입력합니다. 예를 들어
email
입니다. -
각 템플릿의
{{ define "
시작과name-of-template
" }}{{ end }}
끝을 포함하여 콘텐츠 필드에 각 템플릿을 작성합니다. 알림 템플릿의 각 템플릿에 설명이 포함된 이름을 사용할 수 있습니다 (예:email.subject
또는email.message
). 이 경우 위에서 입력한 알림 템플릿의 이름을 다시 사용하지 마십시오.이후 섹션에서는 만들 수 있는 템플릿의 자세한 예를 보여줍니다.
-
저장을 클릭합니다.
알림 템플릿 미리 보기
연락처에서 알림 템플릿을 사용하기 전에 알림 템플릿이 어떻게 보일지 미리 볼 수 있으므로 만들고 있는 템플릿의 결과를 이해하는 데 도움이 될 뿐만 아니라 템플릿을 저장하기 전에 오류를 수정할 수 있습니다.
참고
알림 미리보기는 Grafana Alertmanager에서만 사용할 수 있습니다.
알림 템플릿을 미리 보려면
-
알림 관리 포털 IRM, 연락처를 선택합니다.
-
알림 템플릿 탭을 선택한 다음 + 알림 템플릿 추가 또는 기존 템플릿을 편집합니다.
-
템플릿 콘텐츠를 추가하거나 업데이트하세요.
기본 데이터가 제공되며 이 데이터에 경고 데이터와 경고 인스턴스를 추가하거나 편집할 수 있습니다. 페이로드 데이터 창에서 직접 알림 데이터를 추가하거나 알림 인스턴스 선택 또는 사용자 지정 알림 추가를 클릭할 수 있습니다.
-
[선택 사항] 기존 알림 인스턴스의 알림 데이터를 추가하려면:
-
알림 인스턴스 선택을 선택합니다.
-
알림 인스턴스 위에 마우스를 놓으면 각 알림 인스턴스에 대한 자세한 정보를 볼 수 있습니다/
-
확인을 선택하여 페이로드에 알림 인스턴스를 추가합니다.
-
-
[선택 사항] 경고 데이터 편집기를 사용하여 경고 데이터를 추가하려면 사용자 지정 데이터 추가를 선택합니다.
-
주석, 사용자 지정 레이블을 추가하거나 대시보드 또는 패널을 설정합니다.
-
알림에 실행 알림을 추가할지 아니면 해결된 알림을 추가할지에 따라 실행 또는 해결을 전환할 수 있습니다.
-
알림 데이터 추가를 선택합니다.
-
새로 고침 미리보기를 선택하여 템플릿 콘텐츠가 어떻게 보일지 확인하고 해당 페이로드 데이터를 확인할 수 있습니다.
템플릿에 오류가 있는 경우 미리보기에 표시되며 저장하기 전에 수정할 수 있습니다.
-
-
변경 내용을 저장합니다.
메시지 제목의 템플릿 만들기
다음 예와 같이 발생 및 해결된 알림 수가 포함된 이메일 제목의 템플릿을 생성하십시오.
1 firing alerts, 0 resolved alerts
이메일 제목의 템플릿을 만들려면
-
다음 내용이
email.subject
포함된 템플릿을 생성합니다.{{ define "email.subject" }} {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts {{ end }}
-
연락처 통합을 만들 때 템플릿을
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
이메일 메시지의 템플릿을 만들려면
-
내용에 두 개의 템플릿 (
email
email.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 }}
-
연락처 통합을 만들 때 템플릿을
template
키워드와 함께 텍스트 본문 필드에 입력하여 사용하십시오.{{ template "email.message" . }}
Slack 메시지 제목을 위한 템플릿 만들기
다음 예와 같이 발생 및 해결된 알림 수가 포함된 Slack 메시지 제목의 템플릿을 만드세요.
1 firing alerts, 0 resolved alerts
Slack 메시지 제목의 템플릿을 만들려면
-
다음 내용이
slack.title
포함된 템플릿을 생성하십시오.{{ define "slack.title" }} {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts {{ end }}
-
연락처 통합의 제목 필드에서 템플릿을 실행합니다.
{{ 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 메시지 콘텐츠를 위한 템플릿을 만들려면
-
콘텐츠에 두 개의 템플릿 (
slack.print_alert
및slack.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 }}
-
연락처 통합의 텍스트 본문 필드에서 템플릿을 실행합니다.
{{ template "slack.message" . }}
공유 템플릿을 사용하여 이메일과 Slack을 모두 템플릿으로 작성하십시오.
이메일과 Slack과 같은 각 연락처에 대해 별도의 알림 템플릿을 만드는 대신 동일한 템플릿을 공유할 수 있습니다.
예를 들어 이 제목이 포함된 이메일과 이 제목의 Slack 메시지를 보내려는 경우 공유 1 firing alerts, 0 resolved
alerts
템플릿을 만들 수 있습니다.
공유 템플릿을 만들려면
-
다음 내용이
common.subject_title
포함된 템플릿을 생성하십시오.{{ define "common.subject_title" }} {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts {{ end }}
-
이메일의 경우 이메일 연락처 통합의 제목 필드에서 템플릿을 실행합니다.
{{ template "common.subject_title" . }}
-
Slack의 경우 Slack 연락처 통합의 제목 필드에서 템플릿을 실행하세요.
{{ template "common.subject_title" . }}