컨택 포인트 구성

컨택 포인트 구성 (Configure contact points)

컨택 포인트(contact point)는 알림을 받을 위치를 지정하는 데 사용해요. 컨택 포인트에는 이메일, Slack, IRM, 웹훅 같은 대상과 그 알림 메시지를 포함해 알림을 보내는 설정이 담겨 있어요. 컨택 포인트 하나에 여러 대상(contact point integration)을 둘 수 있으며, 선택한 컨택 포인트 안의 각 통합으로 알림이 전송돼요.

출처: Configure contact points

본문

Contact Points 탭에서는 다음을 할 수 있어요.

  • 컨택 포인트와 통합(integration) 추가, 편집, 보기
  • 컨택 포인트와 통합의 이름·유형 검색
  • 각 컨택 포인트가 몇 개의 알림 정책에 사용되는지 확인하고 연결된 알림 정책으로 바로 이동
  • 알림 전달 상태 보기
  • 개별 컨택 포인트 또는 전체 컨택 포인트를 JSON, YAML, Terraform 형식으로 내보내기
  • 컨택 포인트 삭제. 단, 알림 정책에서 사용 중인 컨택 포인트는 삭제할 수 없어요. 삭제하려면 알림 정책을 삭제하거나 다른 컨택 포인트를 사용하도록 정책을 업데이트해야 해요.

참고: 컨택 포인트는 특정 Alertmanager에 할당되며 다른 Alertmanager의 알림 정책에서는 사용할 수 없어요.

보호 필드 (Protected fields)

Grafana 사용자에게 컨택 포인트에는 수정에 관리자 권한이 필요한 보호 필드가 있을 수 있어요. 보호 필드는 알림이 전송되는 위치에 영향을 주는 민감한 구성 설정으로, 예를 들면:

  • 통합의 대상 URL(웹훅, PagerDuty, Opsgenie 또는 기타 통합)
  • API 엔드포인트
  • 기타 대상 관련 설정

이 필드는 권한 없는 사용자가 알림을 손상된 서버로 리다이렉트해 권한 토큰, API 키, 알림 데이터 같은 민감 정보를 노출하는 것을 막기 위해 보호돼요.

편집 권한이 있는 사용자는 대부분의 컨택 포인트 설정을 수정하고 통합을 추가·제거할 수 있지만, 기존 통합의 보호 필드는 변경할 수 없어요. 보호 필드를 업데이트할 수 있는 사람은 컨택 포인트에 대한 관리자 권한이 있는 사용자뿐이에요.

보호 필드 수정 능력은 RBAC 액션 alert.notifications.receivers.protected:write로 제어돼요. 이 역할은 기본적으로 다음 사용자에게 부여돼요.

  • 고정 "Alerting Admin" 역할을 가진 사용자
  • 해당 컨택 포인트에 대한 관리자 권한이 있는 사용자

지원되는 컨택 포인트 통합

각 컨택 포인트 통합은 고유한 구성 옵션과 설정 과정을 가져요. Grafana가 지원하는 컨택 포인트 통합 목록은 다음과 같아요.

위 통합 중 일부는 Prometheus Alertmanager에서 지원되지 않아요. 지원 통합 목록은 Prometheus Alertmanager receiver settings를 참고하세요.

컨택 포인트 추가

다음 단계를 수행해 컨택 포인트를 추가해요.

  1. 왼쪽 메뉴에서 Alerts & IRM을 클릭한 다음 Alerting을 클릭해요.
  2. Notification configuration을 클릭한 다음 Contact points 탭을 선택해요.
  3. Choose Alertmanager 드롭다운에서 Alertmanager를 선택해요. 기본적으로 Grafana Alertmanager가 선택돼 있어요.
  4. + New contact point를 클릭해요.
  5. 컨택 포인트의 설명적인 이름을 입력해요.
  6. Integration에서 유형을 선택하고 필수 필드를 채워요. 예를 들어 email을 선택하면 이메일 주소를, Slack을 선택하면 Slack 채널과 연락할 사용자를 입력해요.
  7. email이나 Webhook 같은 일부 컨택 포인트 통합에는 선택 설정이 있어요. Optional settings에서 선택한 컨택 포인트 통합의 추가 설정을 지정해요.
  8. Notification settings에서 알림이 해결(resolve)될 때 알림을 받고 싶지 않다면 Disable resolved message를 선택해요.
  9. 변경 사항을 저장해요.

컨택 포인트 통합 추가

컨택 포인트에는 여러 통합(알림을 보낼 대상)이 있을 수 있어요. 컨택 포인트에 다른 통합을 추가하려면:

  1. 기존 컨택 포인트를 추가하거나 편집해요.
  2. Add contact point integration을 클릭하고 "컨택 포인트 추가"와 동일한 단계를 반복해요.
    • Integration에서 유형을 선택하고 필수 필드를 채워요.
    • Optional settings에서 선택한 컨택 포인트 통합의 추가 설정을 지정해요.
  3. 변경 사항을 저장해요.

알림 메시지 사용자 지정

컨택 포인트에서 알림 메시지를 사용자 지정할 수도 있어요. 예를 들어 이메일 컨택 포인트 통합을 설정할 때 Message나 Subject를 클릭해 수정해요.

기본적으로 알림 메시지는 대부분의 경우에 충분한 공통 알림 세부 정보를 포함해요. 필요하면 알림 메시지의 내용과 형식을 사용자 지정할 수 있어요. 커스텀 알림 템플릿을 만들고 이를 하나 이상의 컨택 포인트에 적용할 수 있어요.

Notification configuration 아래의 Templates 탭에서 알림 템플릿을 보기, 편집, 복사, 삭제할 수 있어요. 컨택 포인트의 템플릿 선택 또는 생성 지침은 알림 템플릿 관리를 참고하세요.

컨택 포인트 테스트

컨택 포인트 테스트는 Grafana Alertmanager에서만 사용할 수 있어요. 다음 단계를 수행해 컨택 포인트를 테스트해요.

  1. 왼쪽 메뉴에서 Alerts & IRM을 클릭한 다음 Alerting을 클릭해요.
  2. Notification configuration을 클릭한 다음 Contact points 탭을 선택해 기존 컨택 포인트 목록을 봐요.
  3. 테스트할 컨택 포인트를 찾아 Edit을 클릭해요. 필요하면 새 컨택 포인트를 만들 수도 있어요.
  4. Test를 클릭해 컨택 포인트 테스트 대화 상자를 열어요.
  5. 미리 정의된 테스트 알림을 보낼지, 아니면 Custom을 선택해 알림에 포함할 자체 커스텀 어노테이션과 라벨을 추가할지 선택해요.
  6. Send test notification을 클릭해 알림을 발화해요.

컨택 포인트 알림 활성화

컨택 포인트를 만든 뒤 다음 방법 중 하나로 알림을 받도록 활성화할 수 있어요.

알림 전달 문제 해결

Contact points 탭은 각 컨택 포인트의 최신 알림 전달 상태를 보여줘요. 과거 전달 시도를 검토하고 컨택 포인트나 전달 결과로 필터링하려면 알림 이력 보기를 참고하세요.

더 알아보기 (Learn more)