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

# 연락 지점 구성
<a name="v10-alerting-configure-contactpoints"></a>

****  
이 설명서 주제는 **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 관리형 알림에 대한 연락 지점을 생성 및 편집할 수 있습니다. 데이터 소스에 대한 관리형 알림의 연락 지점은 읽기 전용입니다.

## 연락 지점 작업
<a name="v10-alerting-configure-contactpoints-working"></a>

다음 절차에서는 연락 지점을 추가, 편집, 삭제, 테스트하는 방법을 안내합니다.

**연락 지점을 추가하는 방법**

1. 왼쪽 메뉴에서 **알림**을 선택하세요.

1. **연락 지점**을 선택하세요.

1. **Alertmanager 선택** 드롭다운에서 Alertmanager를 선택하세요. Grafana Alertmanager는 기본적으로 선택됩니다.

1. **연락 지점** 탭에서 **\$1 연락 지점 추가**를 선택하세요.

1. 연락 지점의 **이름**을 입력하세요.

1. **통합**에서 유형을 선택하고 해당 유형을 기반으로 필수 필드를 작성하세요. 예를 들어 Slack을 선택한 경우 Slack 채널과 연락을 받아야 하는 사용자를 입력하세요.

1. 선택한 연락 지점에 대해 사용할 수 있는 경우 원하는 **선택적 설정**을 선택하여 추가 설정을 지정하세요.

1. **알림 설정**에서 알림이 확인될 때 알림을 받지 않으려면 **확인된 메시지 비활성화**를 선택하세요.

1. 다른 연락 지점 통합을 추가하려면 **연락 지점 통합 추가**를 선택하고 필요한 각 연락 지점 유형에 대해 단계를 반복하세요.

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

**연락 지점을 편집하는 방법**

1. 왼쪽 메뉴에서 **알림**을 선택하세요.

1. **연락 지점**을 선택하여 기존 연락 지점 목록을 확인하세요.

1. 편집할 연락 지점을 선택한 다음, **편집**을 선택하세요.

1. 연락 지점을 업데이트한 다음, 변경 사항을 저장하세요.

알림 정책에서 사용하지 않는 연락 지점을 삭제할 수 있습니다.

**연락 지점을 삭제하는 방법**

1. 왼쪽 메뉴에서 **알림**을 선택하세요.

1. **연락 지점**을 선택하여 기존 연락 지점 목록을 여세요.

1. **연락 지점**에서 삭제할 연락 지점을 선택한 다음, **추가**, **삭제**를 선택하세요.

1. 확인 대화 상자에서 **예, 삭제**를 선택하세요.

**참고**  
알림 정책에서 연락 지점을 사용 중인 경우 연락 지점을 삭제하기 전에 알림 정책을 삭제하거나 다른 연락 지점을 사용하도록 편집해야 합니다.

연락 지점을 생성한 후 테스트 알림을 보내 올바르게 구성되었는지 확인할 수 있습니다.

**테스트 알림을 전송하는 방법**

1. 왼쪽 메뉴에서 **알림**을 선택하세요.

1. **연락 지점**을 선택하여 기존 연락 지점 목록을 여세요.

1. **연락 지점**에서 테스트할 연락 지점을 선택한 다음, **편집**을 선택하세요. 필요한 경우 새 연락 지점을 생성할 수도 있습니다.

1. **테스트**를 선택하여 연락 지점 테스트 대화 상자를 여세요.

1. 사전 정의된 테스트 알림을 보낼지 또는 **사용자 지정**을 선택하여 테스트 알림에 사용자 지정 주석과 레이블을 추가할지 선택하세요.

1. 지정된 연락 지점으로의 알림을 테스트하려면 **테스트 알림 전송**을 선택하세요.

## 연락 지점 통합 구성
<a name="v10-alerting-configure-contactpoints-integration"></a>

알림 규칙이 실행될 때 알림을 수신할 선호하는 통신 채널을 선택하도록 Grafana에서 연락 지점 통합을 구성합니다. 각 통합에는 고유한 구성 옵션과 설정 프로세스가 있습니다. 대부분의 경우 API 키 또는 웹후크 URL 제공이 포함됩니다.

구성되면 통합을 연락 지점의 일부로 사용하여 알림 상태가 변경될 때마다 알림을 받을 수 있습니다. 이 섹션에서는 PagerDuty를 예로 사용하여 통합을 구성하는 기본 단계를 다룹니다. 이를 통해 실시간 알림을 수신하고 모니터링 데이터를 계속 확인할 수 있습니다.

**지원되는 통합 목록**

다음 표에는 Grafana에서 지원하는 연락 지점 유형이 나열되어 있습니다.


| 이름 | Type | 
| --- | --- | 
| Amazon SNS | `sns` | 
| OpsGenie | `opsgenie` | 
| PagerDuty | `pagerduty` | 
| Slack | `slack` | 
| VictorOps | `victorops` | 

**알림을 위한 PagerDuty 구성**

PagerDuty를 설정하려면 통합 키를 제공해야 합니다. 다음 세부 정보를 제공합니다.


| 설정 | 설명 | 
| --- | --- | 
| 통합 키 | PagerDuty의 통합 키 | 
| 심각도 | 동적 알림 수준. 기본값은 critical입니다. | 
| 사용자 지정 세부 정보 | 이벤트에 대한 추가 세부 정보. | 

`CustomDetails` 필드는 임의의 키-값 페어가 포함된 객체입니다. 사용자 정의 세부 정보는 기본적으로 사용되는 정보와 병합됩니다.

`CustomDetails`의 기본값은 다음과 같습니다.

```
{
	"firing":       `{{ template "__text_alert_list" .Alerts.Firing }}`,
	"resolved":     `{{ template "__text_alert_list" .Alerts.Resolved }}`,
	"num_firing":   `{{ .Alerts.Firing | len }}`,
	"num_resolved": `{{ .Alerts.Resolved | len }}`,
}
```

중복 키의 경우 사용자 정의 세부 정보가 기본 키를 덮어씁니다.