기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 알림 관리 **** 이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다. Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요. Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요. 알림 규칙, 연락 지점 및 알림 정책을 설정한 후에는 Grafana 알림을 사용하여 알림을 실제로 관리할 수 있습니다. **Topics** + [알림 사용자 지정](v10-alerting-manage-notifications.md) + [연락 지점 관리](v10-alerting-manage-contactpoints.md) + [알림 전달 무음 처리](v10-alerting-silences.md) + [알림 규칙 보기 및 필터링](v10-alerting-manage-rules-viewfilter.md) + [음소거 타이밍](v10-alerting-manage-muting.md) + [알림 규칙의 상태 조건 및 상태 보기](v10-alerting-manage-rulestate.md) + [알림 그룹별 보기 및 필터링](v10-alerting-manage-viewfiltergroups.md) + [알림 오류 보기](v10-alerting-manage-viewnotificationerrors.md) # 알림 사용자 지정 **** 이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다. Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요. Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요. 알림 템플릿을 사용하여 알림을 사용자 지정합니다. 알림 템플릿을 사용하여 알림에서 메시지의 제목, 메시지 및 형식을 변경할 수 있습니다. 알림 템플릿은 Amazon SNS 또는 Slack과 같은 특정 연락 지점 통합과 연결되지 않습니다. 그러나 서로 다른 연락 지점 통합을 위한 별도의 알림 템플릿을 생성하도록 선택할 수 있습니다. 알림 템플릿을 사용하여 다음을 수행할 수 있습니다. + 요약, 설명, 레이블 및 주석, 값 및 링크를 포함하여 알림에서 정보를 추가, 제거 또는 재정렬합니다. + 텍스트를 굵은 기울임꼴 서식으로 지정하고 줄 바꿈 추가 또는 제거 알림 템플릿을 사용하여 다음을 수행할 수 없습니다. + Slack 및 Microsoft Teams와 같은 인스턴트 메시징 서비스의 알림 설계 변경 **Topics** + [Go의 템플릿 지정 언어 사용](v10-alerting-notifications-go-templating.md) + [알림 템플릿 생성](v10-alerting-create-templates.md) + [알림 템플릿 사용](#v10-alerting-use-notification-templates) + [템플릿 참조](v10-alerting-template-reference.md) # Go의 템플릿 지정 언어 사용 **** 이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다. Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요. Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요. 알림 템플릿을 Go의 템플릿 지정 언어인 [text/template](https://pkg.go.dev/text/template)으로 작성합니다. 이 섹션에서는 Go의 템플릿 지정 언어에 대한 개요와 text/template에서 템플릿을 작성하는 방법을 제공합니다. ## 점 text/template에는 점(dot)이라는 특수 커서가 있습니다(`.`로 씀). 이 커서는 사용되는 템플릿의 위치에 따라 값이 변경되는 변수로 간주할 수 있습니다. 예를 들어 알림 템플릿의 시작 부분에서 `.`은 `ExtendedData` 객체를 참조합니다. 여기에서는 `Alerts`, `Status`, `GroupLabels`, `CommonLabels`, `CommonAnnotations`, `ExternalURL`을 포함하여 여러 필드를 포함합니다. 그러나 점은 목록의 `range`에서 사용할 때, `with`에서 사용할 때 또는 다른 템플릿에서 사용할 기능 템플릿을 작성할 때 다른 항목을 참조할 수 있습니다. [알림 템플릿 생성](v10-alerting-create-templates.md)에서 이에 대한 예제를 확인할 수 있으며, [템플릿 참조](v10-alerting-template-reference.md)에서 모든 데이터 및 함수를 확인할 수 있습니다. ## 여는 태그 및 닫는 태그 text/template에서 템플릿은 템플릿이 변수를 인쇄하는지 여부와 if 문과 같이 제어 구조를 실행하는지 여부에 관계없이 `{{`로 시작하고 `}}`로 끝납니다. Jinja(변수를 인쇄할 때 `{{` 및 `}}`를 사용하고 제어 구조에서 `{%` 및 `%}`를 사용함)와 같은 다른 템플릿 지정 언어와는 다릅니다. ## 인쇄 무언가의 값을 인쇄하려면 `{{` 및 `}}`를 사용합니다. 점 값, 점 필드, 함수 결과 및 [변수](#v10-go-variables) 값을 인쇄할 수 있습니다. 예를 들어 점이 `ExtendedData`를 참조하는 `Alerts` 필드를 인쇄하려면 다음과 같이 작성합니다. ``` {{ .Alerts }} ``` ## 알림에 대한 반복 알림에 대한 모든 정보가 아닌 각 알림의 레이블만 인쇄하려면 `range`를 사용하여 `ExtendedData`에서 알림을 반복할 수 있습니다. ``` {{ range .Alerts }} {{ .Labels }} {{ end }} ``` 범위 내에서 점은 더 이상 `ExtendedData`를 참조하지 않고 `Alert`를 참조합니다. `{{ .Labels }}`를 사용하여 각 알림의 레이블을 인쇄할 수 있습니다. `{{ range .Alerts }}`에서 알림 목록의 현재 알림을 참조하도록 점을 변경하기 때문에 이러한 방식이 작동합니다. 범위가 완성되면 범위가 시작되기 전에 사용했던 값으로 점이 재설정됩니다(이 예제에서 `ExtendedData`). ``` {{ range .Alerts }} {{ .Labels }} {{ end }} {{/* does not work, .Labels does not exist here */}} {{ .Labels }} {{/* works, cursor was reset */}} {{ .Status }} ``` ## 주석 및 레이블에 대한 반복 `The name of the label is $name, and the value is $value` 형식으로 각 알림의 레이블을 인쇄하도록 템플릿을 작성합니다. 여기서 `$name` 및 `$value`에는 각 레이블의 이름 및 값이 포함됩니다. 이전 예제와 마찬가지로 점을 사용하여 `.Alerts`에서 알림에 대해 반복합니다. 이때 점은 알림 목록에서 현재 알림을 참조합니다. 그리고 정렬된 레이블에서 두 번째 범위를 사용합니다. 이때 두 번째로 현재 레이블을 참조할 때 점이 업데이트됩니다. 두 번째 범위 내에서 `.Name` 및 `.Value`를 사용하여 각 레이블의 이름 및 값을 인쇄합니다. ``` {{ range .Alerts }} {{ range .Labels.SortedPairs }} The name of the label is {{ .Name }}, and the value is {{ .Value }} {{ end }} {{ range .Annotations.SortedPairs }} The name of the annotation is {{ .Name }}, and the value is {{ .Value }} {{ end }} {{ end }} ``` ## index 함수 특정 주석 또는 레이블을 인쇄하려면 `index` 함수를 사용합니다. ``` {{ range .Alerts }} The name of the alert is {{ index .Labels "alertname" }} {{ end }} ``` ## If 문 템플릿에서 if 문을 사용할 수 있습니다. 예를 들어 `.Alerts`에 알림이 없는 경우 `There are no alerts`를 인쇄하려면 다음을 작성합니다. ``` {{ if .Alerts }} There are alerts {{ else }} There are no alerts {{ end }} ``` ## With With는 if 문과 유사하지만, if 문과 달리 `with`에서는 with에서의 값을 참조하기 위해 점을 업데이트합니다. ``` {{ with .Alerts }} There are {{ len . }} alert(s) {{ else }} There are no alerts {{ end }} ``` ## 변수 text/template의 변수는 템플릿 내에서 생성해야 합니다. 예를 들어 점의 현재 값을 사용해 `$variable` 변수를 생성하려면 다음을 작성합니다. ``` {{ $variable := . }} ``` `with` 또는 범위 내에서 `$variable`을 사용할 수 있으며, 이는 점의 현재 값이 아니라 변수가 정의된 시점에 점의 값을 참조합니다. 예를 들어 두 번째 범위에서 `{{ .Labels }}`를 사용하는 템플릿은 작성할 수 없습니다. 여기서 점은 현재 알림이 아닌 현재 레이블을 참조하기 때문입니다. ``` {{ range .Alerts }} {{ range .Labels.SortedPairs }} {{ .Name }} = {{ .Value }} {{/* does not work because in the second range . is a label not an alert */}} There are {{ len .Labels }} {{ end }} {{ end }} ``` 첫 번째 범위와 두 번째 범위 앞에서 `$alert` 변수를 정의하여 이 문제를 해결할 수 있습니다. ``` {{ range .Alerts }} {{ $alert := . }} {{ range .Labels.SortedPairs }} {{ .Name }} = {{ .Value }} {{/* works because $alert refers to the value of dot inside the first range */}} There are {{ len $alert.Labels }} {{ end }} {{ end }} ``` ## 인덱스가 있는 범위 범위 시작 위치에서 인덱스 및 값 변수를 정의하여 범위 내 각 알림의 인덱스를 가져올 수 있습니다. ``` {{ $num_alerts := len .Alerts }} {{ range $index, $alert := .Alerts }} This is alert {{ $index }} out of {{ $num_alerts }} {{ end }} ``` ## 템플릿 정의 `define` 및 템플릿 이름(큰따옴표로 묶음)을 다른 템플릿 내에서 사용할 수 있는 템플릿을 정의할 수 있습니다. `__subject`, `__text_values_list`, `__text_alert_list`, `default.title`, `default.message`와 같은 기본 템플릿을 포함하여 다른 템플릿과 동일한 이름의 템플릿을 정의해서는 안 됩니다. 템플릿이 기본 템플릿과 동일한 이름으로 생성되었거나 다른 알림 템플릿의 템플릿인 경우 Grafana는 두 템플릿 중 하나를 사용할 수 있습니다. Grafana는 이름이 같은 템플릿이 두 개 이상 있는 경우 이를 금지하거나 오류 메시지를 표시하지 않습니다. ``` {{ define "print_labels" }} {{ end }} ``` ## 템플릿 실행 `template`, 템플릿 이름(큰따옴표로 묶음), 템플릿에 전달해야 하는 커서를 사용하여 템플릿 내에서 정의된 템플릿을 실행할 수 있습니다. ``` {{ template "print_labels" . }} ``` ## 템플릿에 데이터 전달 템플릿 내에서 점은 템플릿에 전달되는 값을 참조합니다. 예를 들어 템플릿에 실행 알림 목록이 전달되면 점에서는 해당 실행 알림 목록을 나타냅니다. ``` {{ template "print_alerts" .Alerts }} ``` 템플릿에 알림에 대해 정렬된 레이블이 전달되면 점은 정렬된 레이블 목록을 참조합니다. ``` {{ template "print_labels" .SortedLabels }} ``` 재사용 가능한 템플릿을 작성할 때 유용합니다. 예를 들어 모든 알림을 인쇄하려면 다음을 작성할 수 있습니다. ``` {{ template "print_alerts" .Alerts }} ``` 그런 다음, 실행 알림만 인쇄하려면 다음을 작성하면 됩니다. ``` {{ template "print_alerts" .Alerts.Firing }} ``` `.Alerts` 및 `.Alerts.Firing`이 모두 알림 목록이므로 이 방식이 가능합니다. ``` {{ define "print_alerts" }} {{ range . }} {{ template "print_labels" .SortedLabels }} {{ end }} {{ end }} ``` ## 설명 `{{/*` 및 `*/}}`를 사용하여 주석을 추가할 수 있습니다. ``` {{/* This is a comment */}} ``` 설명에 줄 바꿈을 추가하지 못하도록 하려면 다음을 사용합니다. ``` {{- /* This is a comment with no leading or trailing line breaks */ -}} ``` ## 들여쓰기 탭과 공백, 줄 바꿈에서 모두 들여쓰기를 사용하여 템플릿의 가독성을 개선할 수 있습니다. ``` {{ range .Alerts }} {{ range .Labels.SortedPairs }} {{ .Name }} = {{ .Value }} {{ end }} {{ end }} ``` 그러나 템플릿의 들여쓰기는 텍스트에도 표시됩니다. 다음으로 이를 제거하는 방법을 살펴봅니다. ## 공백 및 줄 바꿈 제거 text/template에서 `{{-` 및 `-}}`를 사용하여 선행 및 후행 공백과 줄 바꿈을 제거합니다. 예를 들어 들여쓰기 및 줄 바꿈을 사용하여 템플릿의 가독성을 높이는 경우: ``` {{ range .Alerts }} {{ range .Labels.SortedPairs }} {{ .Name }} = {{ .Value }} {{ end }} {{ end }} ``` 들여쓰기 및 줄 바꿈도 텍스트에 표시됩니다. ``` alertname = "Test" grafana_folder = "Test alerts" ``` 각 범위의 시작 위치에서 `}}`를 `-}}`로 변경하여 텍스트에서 들여쓰기 및 줄 바꿈을 제거할 수 있습니다. ``` {{ range .Alerts -}} {{ range .Labels.SortedPairs -}} {{ .Name }} = {{ .Value }} {{ end }} {{ end }} ``` 이제 템플릿의 들여쓰기 및 줄 바꿈은 텍스트에 없습니다. ``` alertname = "Test" grafana_folder = "Test alerts" ``` # 알림 템플릿 생성 **** 이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다. Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요. Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요. 연락 지점으로 전송할 재사용 가능한 알림 템플릿을 생성합니다. 알림 템플릿에 하나 이상의 템플릿을 추가할 수 있습니다. 알림 템플릿 이름은 고유해야 합니다. 동일한 알림 템플릿 또는 다른 알림 템플릿에서 이름이 같은 두 개의 템플릿을 사용할 수 없습니다. `__subject`, `__text_values_list`, `__text_alert_list`, `default.title`, `default.message`와 같이 기본 템플릿과 이름이 같은 템플릿을 정의하지 마세요. 연락 지점 탭에서 알림 템플릿 목록을 볼 수 있습니다. ## 알림 템플릿 생성 **알림 템플릿을 생성하는 방법** 1. **알림**, **연락 지점**을 선택하세요. 1. **알림 템플릿** 탭을 선택한 다음, **\$1 알림 템플릿 추가**를 선택하세요. 1. `email.subject`와 같은 알림 템플릿의 이름을 선택하세요. 1. 콘텐츠 필드에서 템플릿의 콘텐츠를 작성하세요. 예제: ``` {{ if .Alerts.Firing -}} {{ len .Alerts.Firing }} firing alerts {{ end }} {{ if .Alerts.Resolved -}} {{ len .Alerts.Resolved }} resolved alerts {{ end }} ``` 1. 변경 내용을 저장합니다. `{{ define "email.subject" }}`(여기서 `email.subject`는 템플릿의 이름임) 및 `{{ end }}`는 콘텐츠의 시작과 끝에 자동으로 추가됩니다. **둘 이상의 템플릿이 포함된 알림 템플릿을 생성하는 방법** 1. **알림**, **연락 지점**을 선택하세요. 1. **알림 템플릿** 탭을 선택한 다음, **\$1 알림 템플릿 추가**를 선택하세요. 1. 전체 알림 템플릿의 이름을 입력하세요. 예를 들어 `email`입니다. 1. 각 템플릿의 시작과 끝에 있는 `{{ define "name-of-template" }}` 및 `{{ end }}`를 포함하여 콘텐츠 필드에서 각 템플릿을 작성하세요. 알림 템플릿의 각 템플릿에 대해 설명이 포함된 이름(예: `email.subject` 또는 `email.message`)을 사용할 수 있습니다. 이 경우 위에 입력한 알림 템플릿의 이름을 재사용하지 마세요. 이후 섹션에서는 생성할 수 있는 템플릿에 대한 자세한 예제를 보여줍니다. 1. 저장을 클릭합니다. ## 알림 템플릿 미리 보기 알림 템플릿을 연락 지점에서 사용하기 전에 모양을 미리 살펴보고, 생성 중인 템플릿의 결과를 이해하며, 템플릿을 저장하기 전에 오류를 수정할 수 있는 기회를 제공합니다. **참고** 알림 미리 보기는 Grafana Alertmanager에서만 사용할 수 있습니다. **알림 템플릿을 미리 보는 방법** 1. **알림**, **연락 지점**을 선택하세요. 1. **알림 템플릿** 탭을 선택한 다음, **\$1 알림 템플릿 추가**를 선택하거나 기존 템플릿을 편집하세요. 1. 템플릿 콘텐츠를 추가하거나 업데이트하세요. 기본 데이터가 제공되며, 알림 인스턴스뿐만 아니라 알림 데이터를 추가하거나 편집할 수 있습니다. 페이로드 데이터 창에서 직접 알림 데이터를 추가하거나 **알림 인스턴스 선택** 또는 **사용자 지정 알림 추가**를 클릭할 수 있습니다. 1. [선택 사항] 기존 알림 인스턴스에서 알림 데이터를 추가하는 방법: 1. **알림 인스턴스 선택**을 선택하세요. 1. 각 알림 인스턴스에 대한 자세한 내용을 보려면 알림 인스턴스 위로 마우스를 가져가세요. 1. **확인**을 선택하여 알림 인스턴스를 페이로드에 추가하세요. 1. [선택 사항] 알림 데이터 편집기를 사용하여 알림 데이터를 추가하려면 **사용자 지정 데이터 추가**를 선택하세요. 1. 주석, 사용자 지정 레이블을 추가하거나 대시보드 또는 패널을 설정하세요. 1. 알림에 실행 알림 또는 해결된 알림을 추가할지 여부에 따라 실행 알림 또는 해결된 알림을 전환하세요. 1. **알림 데이터 추가**를 선택하세요. 1. **미리 보기 새로 고침**을 선택하여 템플릿 콘텐츠의 모양과 해당 페이로드 데이터를 확인하세요. 템플릿에 오류가 있는 경우 미리 보기에 오류가 표시되고 저장하기 전에 수정할 수 있습니다. 1. 변경 내용을 저장합니다. ## 메시지 제목에 대한 템플릿 생성 이 예제와 같이 실행 알림 및 해결된 알림 수가 포함된 이메일 제목에 대한 템플릿을 생성합니다. ``` 1 firing alerts, 0 resolved alerts ``` **이메일 제목에 대한 템플릿을 생성하는 방법** 1. 다음 콘텐츠로 `email.subject`라는 템플릿을 생성하세요. ``` {{ define "email.subject" }} {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts {{ end }} ``` 1. `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. 콘텐츠에 두 개의 템플릿(`email.message_alert` 및 `email.message`)을 포함하는 `email` 알림 템플릿을 생성하세요. `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 }} ``` 1. `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 }} ``` 1. 연락 지점 통합의 제목 필드에서 템플릿을 실행하세요. ``` {{ template "slack.title" . }} ``` ## Slack 메시지 콘텐츠에 대한 템플릿 생성 레이블, 주석 및 대시보드 URL을 포함하여 모든 실행 알림 및 해결된 알림에 대한 설명이 포함된 Slack 메시지의 콘텐츠에 대한 템플릿을 생성합니다. **참고** 이 템플릿은 Grafana 관리형 알림 전용입니다. 데이터 소스 관리형 알림에 템플릿을 사용하려면 DashboardURL 및 SilenceURL에 대한 참조를 삭제하세요. Prometheus 알림 구성에 대한 자세한 내용은 [알림에 대한 Prometheus 설명서](https://prometheus.io/docs/alerting/latest/notifications/)를 참조하세요. ``` 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_alert` 및 `slack.message`)을 포함하는 `slack` 템플릿을 생성하세요. `slack.print_alert` 템플릿은 레이블, 주석 및 DashboardURL을 인쇄하는 데 사용되는 반면 `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 }} ``` 1. 연락 지점 통합의 텍스트 본문 필드에서 템플릿을 실행하세요. ``` {{ template "slack.message" . }} ``` ## 공유 템플릿으로 이메일 및 Slack 모두 템플릿 지정 이메일 및 Slack과 같이 각 연락 지점에 대해 별도의 알림 템플릿을 생성하는 대신 동일한 템플릿을 공유할 수 있습니다. 예를 들어 이 제목의 이메일과 이 `1 firing alerts, 0 resolved alerts` 제목의 Slack 메시지를 보내려면 공유 템플릿을 생성할 수 있습니다. **공유 템플릿을 생성하는 방법** 1. 다음 콘텐츠로 `common.subject_title`라는 템플릿을 생성하세요. ``` {{ define "common.subject_title" }} {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts {{ end }} ``` 1. 이메일의 경우 이메일 연락 지점 통합의 제목 필드에서 템플릿을 실행하세요. ``` {{ template "common.subject_title" . }} ``` 1. Slack의 경우 Slack 연락 지점 통합의 제목 필드에서 템플릿을 실행하세요. ``` {{ template "common.subject_title" . }} ``` ## 알림 템플릿 사용 연락 지점의 템플릿을 사용하여 알림을 사용자 지정합니다. **연락 지점을 생성할 때 템플릿을 사용하는 방법** 1. **알림** 메뉴에서 **연락 지점** 탭을 선택하여 기존 연락처 목록을 확인하세요. 1. **신규**를 선택합니다. 또는 **편집** 아이콘을 선택하여 기존 연락처를 편집할 수 있습니다. 1. **메시지** 또는 **제목**과 같은 필드에 사용할 템플릿을 입력하세요. 템플릿을 입력하려면 `{{ template "template_name" . }}` 양식을 사용하여 *template\$1name*을 사용하려는 템플릿 이름으로 바꾸세요. 1. **연락 지점 저장**을 선택하세요. # 템플릿 참조 **** 이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다. Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요. Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요. 이 섹션에서는 템플릿을 생성하기 위한 참조 정보를 제공합니다. **알림(유형)** 알림 유형에는 다음 데이터가 포함됩니다. | 이름 | 종류 | 설명 | 예제 | | --- | --- | --- | --- | | Status | 문자열 | `firing` 또는 `resolved` | \$1\$1 .Status \$1\$1 | | 레이블 | KeyValue | 알림에 연결된 레이블 세트. | \$1\$1 .Labels \$1\$1 | | Annotations | KeyValue | 알림에 연결된 주석 세트. | \$1\$1 .Annotations \$1\$1 | | 값 | KeyValue | 클래식 조건을 포함한 모든 표현식의 값 | \$1\$1 .Values \$1\$1 | | StartsAt | time.Time | 알림 실행이 시작되는 시간. | \$1\$1 .StartsAt \$1\$1 | | EndsAt | time.Time | 알림의 종료 시간을 알고 있는 경우에만 설정합니다. 그렇지 않으면 마지막 알림이 수신된 이후부터 구성 가능한 제한 시간으로 설정됩니다. | \$1\$1 .EndsAt \$1\$1 | | GeneratorURL | 문자열 | Grafana 또는 외부 Alertmanager에 대한 백 링크. | \$1\$1 .GeneratorURL \$1\$1 | | SilenceURL | 문자열 | 알림을 음소거하는 링크(이 알림에 대한 레이블이 미리 채워짐). Grafana 관리형 알림에만 적용됩니다. | \$1\$1 .SilenceURL\$1\$1 | | DashboardURL | 문자열 | 알림 규칙이 하나에 속하는 경우 Grafana 대시보드에 대한 링크. Grafana 관리형 알림에만 적용됩니다. | \$1\$1 .DashboardURL \$1\$1 | | PanelURL | 문자열 | 알림 규칙이 하나에 속하는 경우 Grafana 대시보드 패널에 대한 링크. Grafana 관리형 알림에만 적용됩니다. | \$1\$1 .PanelURL \$1\$1 | | 지문 | 문자열 | 알림을 식별하는 데 사용할 수 있는 지문. | \$1\$1 .Fingerprint \$1\$1 | | ValueString | 문자열 | 알림에서 축소된 각 표현식의 레이블과 값을 포함하는 문자열. | \$1\$1 .ValueString \$1\$1 | **ExtendedData** ExtendedData 객체는 다음 속성을 포함합니다. | 이름 | 종류 | 설명 | 예제 | | --- | --- | --- | --- | | 수신기 | `string` | 알림을 보내는 연락 지점의 이름. | `{{ .Receiver }}` | | Status | `string` | 상태는 하나 이상의 알림이 실행 중인 경우 `firing`이고, 그렇지 않으면 `resolved`입니다. | `{{ .Status }}` | | 알림 | `[]Alert` | 이 알림에서 모든 실행 알림과 해결된 알림 목록. | `There are {{ len .Alerts }} alerts` | | 실행 알림 | `[]Alert` | 이 알림에서 모든 실행 알림 목록. | `There are {{ len .Alerts.Firing }} firing alerts` | | 해결된 알림 | `[]Alert` | 이 알림에서 모든 해결된 알림 목록. | `There are {{ len .Alerts.Resolved }} resolved alerts` | | GroupLabels | `KeyValue` | 이 알림에서 이러한 알림을 그룹화하는 레이블. | `{{ .GroupLabels }}` | | CommonLabels | `KeyValue` | 이 알림에서 모든 알림에 공통된 레이블. | `{{ .CommonLabels }}` | | CommonAnnotations | `KeyValue` | 이 알림에서 모든 알림에 공통된 주석. | `{{ .CommonAnnotations }}` | | ExternalURL | `string` | 이 알림을 보낸 Grafana 워크스페이스 또는 Alertmanager에 대한 링크. | `{{ .ExternalURL }}` | **KeyValue 유형** `KeyValue` 유형은 레이블과 주석을 나타내는 키/값 문자열 페어 세트입니다. `KeyValue`로 저장된 데이터에 대한 직접 액세스 외에도 데이터를 정렬, 제거 및 변환하는 방법도 있습니다. | 이름 | 인수 | 반환 | 참고 | 예제 | | --- | --- | --- | --- | --- | | SortedPairs | | 키 및 값 문자열 페어의 정렬된 목록 | | `{{ .Annotations.SortedPairs }}` | | 제거 | []string | KeyValue | 지정된 키 없이 키/값 맵의 사본을 반환합니다. | `{{ .Annotations.Remove "summary" }}` | | 이름 | | []string | 이름 목록 | `{{ .Names }}` | | 값 | | []string | 값 목록 | `{{ .Values }}` | **Time** 시간은 Go [https://pkg.go.dev/time#Time](https://pkg.go.dev/time#Time) 패키지에서 가져옵니다. 여러 형식으로 시간을 인쇄할 수 있습니다. 예를 들어, `Monday, 1st January 2022 at 10:00AM` 형식으로 알림이 실행된 시간을 인쇄하려면 다음 템플릿을 작성합니다. ``` {{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }} ``` [여기](https://pkg.go.dev/time#pkg-constants)에서 Go의 시간 형식에 대한 참조를 찾을 수 있습니다. # 연락 지점 관리 **** 이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다. Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요. Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요. **연락 지점** 목록 보기에는 기존 연락 지점 및 알림 템플릿이 모두 나열됩니다. **연락 지점** 탭에서 다음을 수행할 수 있습니다. + 연락 지점 및 통합의 이름과 유형을 검색합니다. + 모든 기존 연락 지점 및 통합을 봅니다. + 각 연락 지점이 사용되는 알림 정책 수를 보고 연결된 알림 정책으로 직접 이동합니다. + 알림 전송 상태를 봅니다. + 개별 연락 지점 또는 모든 연락 지점을 JSON, YAML 또는 Terraform 형식으로 내보냅니다. + 알림 정책에서 사용하지 않는 연락 지점을 삭제합니다. **알림 템플릿** 탭에서 다음을 수행할 수 있습니다. + 기존 알림 템플릿을 확인, 편집, 복사 또는 삭제합니다. # 알림 전달 무음 처리 **** 이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다. Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요. Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요. *무음*으로 알림 전달을 억제할 수 있습니다. 무음은 알림 생성만 중지합니다. 무음은 알림 규칙이 평가되는 것을 방지하지 않으며 사용자 인터페이스에 인스턴스 알림이 표시되는 것도 중지하지 않습니다. 알림을 무음으로 설정한 경우 알림이 억제되는 기간을 지정합니다. **참고** 정기적인 시간 간격(예: 정기 유지 관리 기간)으로 알림 전달을 억제하려면 무음 대신 [음소거 타이밍](v10-alerting-manage-muting.md)을 사용합니다. **무음을 추가하는 방법** 1. Grafana 콘솔의 Grafana 메뉴에서 **알림**을 선택하세요. 1. **무음**을 선택하세요. 1. Alertmanager 드롭다운에서 **Alertmanager**를 선택하세요. 1. **무음 생성**을 선택하세요. 1. **무음 시작 및 종료**에서 시작 및 종료 날짜를 선택하여 무음이 적용되는 시기와 종료 시기를 표시하세요. 1. 종료 시간을 설정하는 대신 **기간**에서 무음이 적용되는 기간을 지정하세요. 그러면 **무음 시작 및 종료** 필드의 종료 시간이 자동으로 업데이트됩니다. 1. **레이블** 및 **값** 필드에 *일치하는 레이블*을 하나 이상 입력하세요. 매처는 무음이 적용되는 규칙을 결정합니다. 일치하는 모든 알림(실행 중 상태)이 **영향을 받는 알림 인스턴스** 필드에 표시됩니다. 1. 선택적으로 무음을 설명하는 **설명**을 추가하세요. 1. **제출**을 선택합니다. **무음을 편집하는 방법** 1. Grafana 콘솔의 Grafana 메뉴에서 **알림**을 선택하세요. 1. **무음**을 선택하여 기존 무음 목록을 보세요. 1. 편집하려는 무음을 찾은 다음, **편집**(펜 아이콘)을 선택하세요. 1. 원하는 대로 변경한 후에 **제출**을 선택하여 변경 사항을 저장하세요. **편집** 아이콘(펜)을 선택하여 기존 무음을 편집할 수 있습니다. **무음 양식에 대한 URL 링크를 생성하는 방법** 무음 양식에 연결할 때 `matcher` 및 `comment` 쿼리 파라미터를 통해 기본 일치 레이블과 주석을 제공합니다. `matcher` 파라미터는 다음 `[label][operator][value]` 형식 중 하나여야 합니다. 여기서, `operator` 파라미터는 `=`(같음, 정규식 아님), `!=`(같지 않음, 정규식 아님), `=~`(같음, 정규식), `!~`(같지 않음, 정규식) 중 하나일 수 있습니다. URL에는 `matcher` 키와 함께 여러 쿼리 파라미터가 포함될 수 있습니다. 예를 들어, 일치하는 레이블 `severity=critical` 및 `cluster!~europe-.*`와 `Silence critical EU alerts` 설명을 포함하는 무음 양식에 연결하려면 `https://mygrafana/alerting/silence/new?matcher=severity%3Dcritical&matcher=cluster!~europe-*&comment=Silence%20critical%20EU%20alert` URL을 생성합니다. 외부 Alertmanager의 새 무음 페이지에 연결하려면 `alertmanager` 쿼리 파라미터를 추가합니다. **무음을 제거하는 방법** 1. Grafana 콘솔의 Grafana 메뉴에서 **알림**을 선택하세요. 1. **무음**을 선택하여 기존 무음 목록을 보세요. 1. 종료하려는 무음을 선택하고 **무음 해제**를 선택하세요. 그러면 알림 억제가 종료됩니다. **참고** 무음을 해제하면 종료 시간이 현재 시간으로 설정된 것처럼 알림 억제가 종료됩니다. (자동 또는 수동으로) 종료된 무음은 5일 동안 유지되고 나열됩니다. 목록에서 수동으로 무음을 제거할 수 없습니다. # 알림 규칙 보기 및 필터링 **** 이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다. Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요. Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요. **알림** 페이지에는 알림 규칙이 나열됩니다. 기본적으로 규칙은 데이터 소스 유형별로 그룹화됩니다. **Grafana** 섹션에는 Grafana에서 관리하는 규칙이 나열됩니다. Prometheus 호환 데이터 소스에 대한 알림 규칙도 여기에 나열되어 있습니다. Prometheus 호환 데이터 소스에 대한 알림 규칙은 볼 수 있지만 편집할 수 없습니다. Mimir/Cortex/Loki 규칙 섹션에는 Mimir, Cortex 또는 Loki 데이터 소스에 대한 모든 규칙이 나열됩니다. 클라우드 알림 규칙도 이 섹션에 나열되어 있습니다. 대량의 알림을 관리할 때 확장 알림 규칙 검색 기능을 사용하여 폴더, 평가 그룹 및 규칙을 필터링할 수 있습니다. 또한 레이블, 상태 조건, 유형 및 상태와 같은 속성별로 알림 규칙을 필터링할 수 있습니다. ## 알림 규칙 보기 Grafana 알림을 사용하면 한 페이지에서 모든 알림을 볼 수 있습니다. **알림 세부 정보를 보는 방법** 1. Grafana 콘솔의 Grafana 메뉴에서 **알림**, **알림 규칙**을 선택하세요. 기본적으로 목록 보기가 표시됩니다. 1. **보기 형식**에서 원하는 옵션을 선택하여 그룹화, 목록, 상태 보기 사이를 전환할 수 있습니다. 1. 규칙 행을 확장하여 규칙 레이블, 주석, 데이터 소스, 규칙 쿼리 및 규칙에서 발생하는 알림 인스턴스 목록을 봅니다. 이 페이지에서 기존 규칙을 재사용하는 데 도움이 되는 알림 규칙의 사본을 만들 수도 있습니다. ## 알림 규칙 내보내기 Grafana 워크스페이스에서 규칙을 YAML 또는 JSON으로 내보낼 수 있습니다. + YAML, JSON 또는 Terraform으로 내보낼 각 알림 규칙 그룹 옆에 있는 **규칙 그룹 내보내기** 아이콘을 선택합니다. + YAML, JSON 또는 Terraform으로 모든 Grafana 관리형 알림 규칙을 보내려면 **규칙 내보내기**를 선택합니다. + 프로비저닝된 알림 규칙을 편집하고 수정된 버전을 내보내려면 그룹 내 각 개별 알림 규칙 옆에 있는 **추가**, **내보내기 수정**을 선택합니다. ## 프로비저닝된 알림에 대한 쿼리 정의 보기 프로비저닝된 알림에 대한 읽기 전용 쿼리 정의를 봅니다. 규칙 정의를 위해 'as-code' 리포지토리를 탐색하지 않고 알림 규칙 쿼리가 올바른지 빠르게 확인합니다. **그룹화된 보기** 그룹화된 보기에는 폴더별로 그룹화된 Grafana 알림 규칙과 `namespace` \$1 `group`으로 그룹화된 Loki 또는 Prometheus 알림 규칙이 표시됩니다. 이는 규칙 관리를 위한 기본 규칙 목록 보기입니다. 각 그룹을 확장하여 이 그룹의 규칙 목록을 볼 수 있습니다. 규칙을 더 확장하여 세부 정보를 확인합니다. 규칙에서 생성되는 알림 및 작업 버튼을 확장하여 세부 정보를 볼 수도 있습니다. **상태 보기** 상태 보기에는 상태별로 그룹화된 알림 규칙이 표시됩니다. 이 보기를 사용하여 어떤 규칙이 어떤 상태에 있는지에 대한 개요를 확인합니다. 각 규칙을 확장하여 세부 정보를 볼 수 있습니다. 작업 버튼 및 이 규칙에서 생성된 모든 알림과 각 알림을 추가로 확장하여 세부 정보를 볼 수 있습니다. ## 알림 규칙 필터링 알림 페이지에 표시되는 **알림** 규칙을 여러 가지 방법으로 필터링할 수 있습니다. **알림 규칙을 필터링하는 방법** 1. **데이터 소스 선택**에서 데이터 소스를 선택하세요. 선택한 데이터 소스를 쿼리하는 알림 규칙을 볼 수 있습니다. 1. **레이블별 검색**에서 레이블 선택기를 사용하여 검색 기준을 입력하세요. 예를 들어 `environment=production;region=~US|EU,severity!=warning`입니다. 1. **상태별 알림 필터링**에서 보려는 알림 상태를 선택하세요. 해당 상태와 일치하는 알림 규칙을 볼 수 있습니다. 다른 상태와 일치하는 규칙은 숨겨집니다. # 음소거 타이밍 **** 이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다. Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요. Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요. 음소거 타이밍은 정책에 대한 새 알림이 생성되거나 전송되지 않는 반복 간격입니다. 이를 사용하여 정기 유지 관리 기간과 같은 특정 기간 및 반복 기간에 알림이 실행되지 않도록 합니다. 무음과 마찬가지로 음소거 타이밍은 알림 규칙이 평가되지 않도록 하며 사용자 인터페이스에 알림 인스턴스가 표시되지 않도록 합니다. 이 기능은 알림 생성만 방지합니다. Grafana 관리형 음소거 타이밍 및 외부 Alertmanager 데이터 소스에 대한 음소거 타이밍을 구성할 수 있습니다. ## 음소거 타이밍 및 무음 다음 표에서는 음소거 타이밍과 무음의 차이를 강조합니다. | 음소거 타이밍 | 무음 | | --- | --- | | 다시 발생할 수 있는 시간 간격 정의를 사용합니다. | 시작 및 종료 시간이 고정되어 있습니다. | | 생성 후 알림 정책에 추가됩니다. | 레이블을 사용하여 무음 여부를 결정하기 위해 알림과 일치시킵니다. | ## 음소거 타이밍 추가 Grafana 워크스페이스에서 음소거 타이밍을 생성할 수 있습니다. **음소거 타이밍을 추가하는 방법** 1. Grafana 콘솔의 Grafana 메뉴에서 **알림**을 선택하세요. 1. **알림 정책**을 선택한 다음, **타이밍 음소거** 탭을 선택하세요. 1. **Alertmanager** 드롭다운에서 편집할 Alertmanager를 선택하세요. 1. **\$1 음소거 타이밍 추가** 버튼을 선택하세요. 1. 양식을 작성하여 음소거 타이밍과 일치하는 [시간 간격](#v10-alerting-manage-muting-interval)을 생성하세요. 1. 음소거 타이밍을 저장하세요. ## 알림 정책에 음소거 타이밍 추가 음소거 타이밍이 있으면 정기적으로 음소거하려는 알림 정책에 추가하여 이를 사용합니다. **알림 정책에 음소거 타이밍을 추가하는 방법** 1. Grafana 콘솔의 Grafana 메뉴에서 **알림**을 선택하세요. 1. **알림 정책**을 선택한 다음, **알림 정책** 탭을 선택하세요. 1. 음소거 타이밍을 추가하려는 알림 정책을 선택하고 **...**, **편집**을 선택하세요. 1. **음소거 타이밍** 드롭다운에서 정책에 추가할 음소거 타이밍을 선택하세요. 1. 변경 내용을 저장합니다. ## 시간 간격 시간 간격은 알림이 억제되는 특정 기간입니다. 기간은 일반적으로 특정 시간 범위와 요일, 월 또는 연도로 구성됩니다. 지원 시간 간격 옵션은 다음과 같습니다. + **시간 범위** - 시작 시간을 포함하고 종료 시간을 제외한 시간(UTC). 위치가 선택되지 않은 경우 현지 시간입니다. + **위치** - 타이밍의 위치를 설정합니다. 시간 범위는 위치의 현지 시간으로 표시됩니다. + **요일** - 요일 또는 요일 범위. 예를 들어 `monday:thursday`입니다. + **월의 일** - 한 달의 날짜. 가능한 값의 범위는 `1`\$1`31`입니다. 음수 값은 해당 월의 일을 역순으로 지정하므로 `-1`은 해당 월의 마지막 날짜를 나타냅니다. + **월** - 전체 역월 이름 또는 숫자로 표시된 연도의 월. 예를 들어 `1, may:august`입니다. + **연도** - 간격에 대한 하나 이상의 연도. 예를 들어 `2023:2024`입니다. 이러한 각 요소는 목록일 수 있으며, 일치하려면 요소의 항목을 하나 이상 충족해야 합니다. 또한 필드는 `:`을 사용하여 범위를 지원합니다. 예를 들어 `monday:thursday`입니다. 필드를 비워 두면 어느 시간이든 필드와 일치합니다. 전체 시간 간격과 일치하려면 모든 필드가 일치해야 합니다. 음소거 타이밍에는 여러 시간 간격이 포함될 수 있습니다. 정확한 기간을 지정하려면 해당 기간에 필요한 모든 옵션을 지정합니다. 예를 들어 3월, 6월, 9월, 12월의 첫 번째 월요일, 12:00\$124:00 UTC 시간에 시간 간격을 생성하려는 경우 시간 간격 사양은 다음과 같을 수 있습니다. + 시간 범위: + 시작 시간: `12:00` + 종료 시간: `24:00` + 요일: `monday` + 월: `3, 6, 9, 12` + 해당 월의 일: `1:7` # 알림 규칙의 상태 조건 및 상태 보기 **** 이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다. Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요. Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요. 알림 규칙의 상태 조건과 상태는 알림에 대한 몇 가지 주요 상태 표시기를 제공합니다. 세 가지 구성 요소가 있습니다. + [알림 규칙 상태](#v10-alerting-manage-rulestate-state) + [알림 인스턴스 상태](#v10-alerting-manage-rulestate-instance) + [알림 규칙 상태](#v10-alerting-manage-rulestate-health) 서로 관련되었지만 각 구성 요소는 약간 다른 정보를 전달합니다. **알림 규칙의 상태 조건 및 상태를 보는 방법** 1. Grafana 콘솔의 Grafana 메뉴에서 **알림**을 선택하세요. 1. **알림 규칙**을 선택하여 기존 알림 목록을 보세요. 1. 알림 규칙을 선택하여 상태 조건 및 상태를 확인합니다. ## 알림 규칙 상태 알림 규칙은 다음 상태 중 하나일 수 있습니다. | State | 설명 | | --- | --- | | 정상 | 평가 엔진에서 반환한 시계열 중 pending 또는 firing 상태의 시계열은 없습니다. | | 보류중 | 평가 엔진에서 반환한 하나 이상의 시계열이 pending입니다. | | 실행 | 평가 엔진에서 반환한 하나 이상의 시계열이 firing입니다. | **참고** 알림은 먼저 `pending`으로 전환된 다음, `firing`으로 전환되므로 알림이 실행되기까지 최소 2회의 평가 주기가 걸립니다. ## 알림 인스턴스 상태 알림 인스턴스는 다음 상태 중 하나일 수 있습니다. | State | 설명 | | --- | --- | | 정상 | pending 또는 firing이 아닌 알림의 상태. 모든 것이 예상대로 작동합니다. | | 보류중 | 구성된 임계치 기간 미만으로 활성화된 알림의 상태. | | 알림 | 구성된 임계치 기간보다 오래 활성화된 알림의 상태. | | 데이터 없음 | 구성된 기간에 데이터가 수신되지 않았습니다. | | 알림 | 알림 규칙을 평가하려고 할 때 오류가 발생했습니다. | ## 마지막 상태 유지 `NoData` 또는 `Error` 상태가 나타날 때 마지막 상태를 유지하도록 알림 규칙을 구성할 수 있습니다. 이렇게 하면 알림이 실행되지 않고 해결 및 다시 실행되지 않습니다. 일반 평가와 마찬가지로 알림 규칙은 보류 기간이 경과한 후 `pending`에서 `firing`으로 전환됩니다. ## 알림 규칙 상태 알림 규칙은 다음 상태 중 하나일 수 있습니다. | State | 설명 | | --- | --- | | Ok | 알림 규칙을 평가할 때 오류가 없습니다. | | 오류 | 알림 규칙을 평가할 때 오류가 발생했습니다. | | NoData | 규칙 평가 중에 반환된 하나 이상의 시계열에 데이터가 없습니다. | | \$1status\$1, KeepLast | 규칙이 다른 상태를 수신했지만 알림 규칙의 마지막 상태를 유지하도록 구성되었습니다. | ## NoData 및 Error에 대한 특별 알림 알림 규칙 평가에서 `NoData` 또는 `Error` 상태가 생성되면 Grafana 알림은 다음과 같은 추가 레이블이 있는 알림 인스턴스를 생성합니다. | Label | 설명 | | --- | --- | | alertname | 상태에 따라 DatasourceNoData 또는 DatasourceError. | | datasource\$1uid | 상태의 원인이 되는 데이터 소스의 UID. | **참고** 추가 레이블을 생성하려면 [Grafana 관리형 알림 규칙 구성](v10-alerting-configure-grafanamanaged.md) 주제에 설명된 대로 알림 규칙에서 `NoData` 또는 `Error`로 데이터 없음 또는 오류 처리를 설정해야 합니다. 무음 추가, 연락 지점으로 라우팅 등을 포함하여 이러한 알림을 일반 알림과 동일한 방식으로 처리할 수 있습니다. # 알림 그룹별 보기 및 필터링 **** 이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다. Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요. Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요. 알림 그룹에서는 Alertmanager 인스턴스의 그룹화된 경보를 표시합니다. 기본적으로 알림 규칙은 알림 정책의 기본 정책에 대한 레이블 키별로 그룹화됩니다. 공통 알림 규칙을 단일 알림 그룹으로 그룹화하면 중복 알림 규칙이 실행되지 않습니다. 알림 그룹을 보고 특정 기준과 일치하는 알림 규칙을 필터링할 수도 있습니다. **알림 그룹을 보는 방법** 1. Grafana 콘솔의 Grafana 메뉴에서 **알림**을 선택하세요. 1. **그룹**을 선택하여 기존 그룹을 보세요. 1. **Alertmanager** 드롭다운에서 외부 Alertmanager를 데이터 소스로 선택하세요. 1. **사용자 지정 그룹화 기준** 드롭다운에서 레이블 조합을 선택하여 기본값이 아닌 다른 그룹화를 보세요. 이는 알림 정책 그룹을 디버깅하고 확인하는 데 유용합니다. 루트 정책의 그룹화 또는 사용자 지정 그룹화에 지정된 레이블이 알림에 포함되지 않은 경우 헤더가 `No grouping`인 다양한 그룹에 알림이 추가됩니다. 알림의 레이블 또는 상태를 기준으로 알림을 필터링할 수 있습니다. **레이블을 기준으로 필터링하는 방법** + **검색**에서 기존 레이블을 입력하여 레이블과 일치하는 알림을 확인하세요. 예를 들어 `environment=production,region=~US|EU,severity!=warning`입니다. **상태를 기준으로 필터링하는 방법** + **상태**에서 활성, 억제됨 또는 미처리 상태 중에서 선택하여 선택한 상태와 일치하는 알림을 보세요. 다른 모든 알림은 숨겨집니다. # 알림 오류 보기 **** 이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다. Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요. Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요. 알림 오류를 보고 알림 오류가 전송되지 않았거나 수신되지 않은 이유를 이해합니다. **참고** 이 기능은 Grafana Alertmanager에 대해서만 지원됩니다. **알림 오류를 보는 방법** 1. 왼쪽 메뉴에서 **알림**을 선택한 다음, **연락 지점 **을 선택하세요. 연락 지점에서 장애가 발생한 경우 워크스페이스 오른쪽에 오류가 있다는 메시지와 오류 개수가 표시됩니다. 1. 연락 지점을 선택하여 해당 연락 지점에 대한 오류 세부 정보를 확인하세요. 오류 아이콘 위로 마우스를 가져가면 오류 세부 정보가 표시됩니다. 연락 지점에 둘 이상의 통합이 있는 경우 나열된 각 통합에 대한 모든 오류가 표시됩니다. 1. 상태 열에서 알림 상태를 확인하세요. 정상, 시도 없음 또는 오류일 수 있습니다.