Alertmanager 구성
Alertmanager 구성 (Configure Alertmanagers)
Grafana Alerting은 Prometheus 알림 시스템의 아키텍처를 기반으로 해요. Grafana는 발화·해결 알림을 Alertmanager로 보내며, Alertmanager가 알림 처리를 담당합니다. 이 아키텍처는 알림 규칙 평가와 알림 처리를 분리해 확장성을 높입니다. Grafana에는 내장 Grafana Alertmanager가 포함되어 있어요.
출처: 문서
본문
주의(Caution): 사전 프로비저닝된 Loki·Prometheus 데이터 소스 관리 알림은 Grafana Cloud에서 더 이상 지원되지 않으며 새 스택에서 만들 수 없어요. 새 Grafana Cloud 스택은 기본적으로 Grafana-managed alerting(GMA)을 사용합니다. 데이터 소스 관리 알림(DMA)은 새 스택에서 프로비저닝되지 않습니다. 기존 스택은 영향을 받지 않아요. 이는 Grafana Labs가 관리하는 기본 Loki·Prometheus Grafana Cloud 데이터 소스와 Cloud Alertmanager에 적용됩니다. 직접 Mimir, Loki, Alertmanager 데이터 소스를 추가하면 데이터 소스 관리 알림을 계속 사용할 수 있어요. Cloud 사용자는 import 도구로 DMA 규칙을 GMA 규칙으로 가져올 수 있습니다. 자세한 내용은 데이터 소스 관리 알림을 Grafana 관리 알림으로 가져오기 문서를 참고하세요.
참고: Grafana Cloud의 독립형 Alertmanager UI(예:
https://alertmanager-<REGION>.grafana.net/alertmanager/)는 더 이상 사용되지 않으며(deprecated) 제공되지 않아요. 침묵, 알림 정책, 연락처 포인트, mute timing을 포함한 모든 Alertmanager 기능은 이제 Grafana Alerting UI에서 사용할 수 있습니다. 관리할 Alertmanager를 선택하려면 Choose Alertmanager 드롭다운을 사용하세요. 침묵을 관리하려면 Alerts & IRM > Alerting > Silences 로 이동합니다.
Grafana의 Alertmanager 유형 (Types of Alertmanagers in Grafana)
Grafana는 다양한 Alertmanager로 알림을 처리하도록 구성할 수 있어요.
- Grafana Alertmanager: Grafana에는 Prometheus Alertmanager를 확장하는 내장 Alertmanager가 포함됩니다. 기본 Alertmanager이며 UI에서 "Grafana"라고 부릅니다. Grafana-managed 알림만 처리할 수 있어요.
- 다른 Alertmanager(Other Alertmanagers): Grafana Alerting은 Prometheus Alertmanager 같은 다른 Alertmanager로도 알림을 보낼 수 있습니다.
Grafana Alerting은 여러 Alertmanager 조합 사용을 지원하며 다른 Alertmanager가 Grafana-managed 알림을 받도록 활성화할 수 있어요. 결정은 알림 설정과 알림이 생성되는 위치에 따라 달라집니다. 예를 들어 온프레미스나 클라우드 인프라에서 Prometheus 알림을 처리하는 Alertmanager가 이미 있다면, Grafana-managed 알림을 같은 Alertmanager로 전달해 통합 알림 처리를 할 수 있어요.
Alertmanager 리소스 (Alertmanager resources)
각 Alertmanager는 연락처 포인트·알림 템플릿, 알림 정책·mute timing, 침묵, 활성 알림 같은 자체 독립적인 알림 리소스를 관리한다는 점이 중요해요. 이 페이지들에서 Choose Alertmanager 드롭다운을 사용해 Alertmanager를 전환하고 리소스를 보거나 관리할 수 있습니다.
Alertmanager 추가 (Add an Alertmanager)
Alertmanager는 Grafana 기본 탐색 메뉴의 Grafana Configuration을 사용해 데이터 소스로 구성해야 해요.
- 왼쪽 메뉴에서 Connections 를 클릭합니다.
- Your connections 아래에서 Data sources 를 클릭합니다.
- 검색창에
Alertmanager를 입력합니다. - Alertmanager 를 클릭합니다. 데이터 소스의 Settings 탭이 표시됩니다.
기본 구성 옵션:
| 이름 | 설명 |
|---|---|
| Name | 데이터 소스를 지칭하는 이름 |
| Default | 새 패널·쿼리에서 미리 선택 여부 |
| Alertmanager Implementation | Alertmanager 구현. Mimir, Cortex, Prometheus 지원 |
| Receive Grafana Alerts | 활성화 시 Alertmanager가 Grafana-managed 알림을 받을 수 있음. 중요: Grafana Alerting Settings 페이지에서 해당 Alertmanager에 대해 알림 수신이 활성화된 경우에만 작동함 |
| HTTP URL | Alertmanager 인스턴스의 HTTP 프로토콜, IP, 포트 (예: https://alertmanager.example.org:9093) |
| Access | Server 액세스 모드만 작동함 |
프로비저닝 지침은 Alertmanager 데이터 소스 문서를 참고하세요. Alertmanager를 추가한 뒤 Grafana Alerting UI에서 알림 정책, 연락처 포인트, 침묵 등 알림 리소스를 관리할 수 있어요.
참고: Prometheus 사용 시 Grafana Alerting UI에서 침묵을 관리할 수 있지만, 연락처 포인트·알림 정책·템플릿 같은 다른 Alertmanager 리소스는 Prometheus Alertmanager HTTP API가 이 리소스의 업데이트를 지원하지 않으므로 읽기 전용입니다. 여러 Alertmanager를 사용할 때는 Choose Alertmanager 드롭다운으로 전환하세요.
Alertmanager가 Grafana-managed 알림을 받도록 활성화 (Enable an Alertmanager to receive Grafana-managed alerts)
Data Source Settings에서 Receive Grafana Alerts 를 활성화한 뒤 Alerting Settings 페이지에서도 Alertmanager를 구성해야 해요. Grafana는 생성된 모든 Grafana-managed 알림을 받도록 하나 또는 여러 Alertmanager를 활성화하는 것을 지원합니다.
- 왼쪽 메뉴에서 Alerts & IRM 을 클릭한 다음 Alerting 을 클릭합니다.
- Settings 를 클릭해 구성된 Alertmanager 목록을 봅니다.
- 선택한 Alertmanager에 대해 Enable/Disable 버튼을 클릭해 Grafana-managed 알림 수신을 토글합니다. 활성화되면 Alertmanager에 Receiving Grafana-managed alerts 가 표시됩니다.
모든 Grafana-managed 알림은 Receiving Grafana-managed alerts 로 표시된 Alertmanager로 전달됩니다.
참고: Grafana Alerting은 Amazon Managed Service for Prometheus의 AlertManager로 Grafana-managed 알림을 전달하는 것을 지원하지 않아요. 자세한 내용은 이 GitHub 이슈를 참고하세요.
특정 알림을 받도록 Alertmanager를 연락처 포인트로 사용 (Use an Alertmanager as a contact point to receive specific alerts)
이전 지침은 모든 Grafana-managed 알림을 Alertmanager로 보냅니다. 특정 알림을 Alertmanager로 보내려면 Alertmanager를 연락처 포인트로 구성하세요. 그런 다음 이 연락처 포인트를 알림 정책이나 개별 알림 규칙에 할당할 수 있습니다. 자세한 지침은 Alertmanager 연락처 포인트, Grafana-managed 알림 규칙 구성, 알림 정책 구성 문서를 참고하세요.
Alertmanager 구성 관리 (Manage Alertmanager configurations)
Settings 페이지에서 Alertmanager 구성을 관리할 수 있어요.
- 내장 Alertmanager에 대한 버전 스냅샷을 관리해, 관리자가 Alertmanager 구성의 의도치 않은 변경이나 실수를 되돌릴 수 있습니다.
- 과거 스냅샷과 최신 구성을 비교해 어떤 변경이 있었는지 확인합니다.
구성 이력 제한 (Configuration history limits): Grafana는 내장 Grafana Alertmanager의 최근 100개 구성 버전을 조직당 저장하며(현재 버전 포함), Alertmanager 구성이 변경될 때마다 Grafana는 새 버전을 저장하고 한도를 초과하면 가장 오래된 버전을 영구 삭제합니다. 작동하는 구성을 잃지 않으려면:
- 구성 백업: 변경을 자동화하거나 대규모 업데이트를 실행하기 전에 Alertmanager 구성을 Grafana 밖으로 내보내서 저장하세요.
- 영향이 적은 환경에서 테스트: 프로덕션에 적용하기 전에 개발·스테이징 Grafana 인스턴스에서 자동화와 구성 실험을 실행하세요.
- 자동 변경 빈도 제한: 빈번한 자동 업데이트는 사용 가능한 구성 이력을 소모합니다. 단일 실수가 모든 복구 가능한 버전을 덮어쓰지 않도록 가능하면 변경을 일괄 처리하세요.