알림 리소스 파일 프로비저닝
알림 리소스 파일 프로비저닝 (File provisioning)
Grafana Alerting 리소스(알림 규칙, 연락 지점, 알림 정책 등)를 파일로 프로비저닝하는 방법을 안내해요. Grafana의 프로비저닝 기능을 사용하면 설정 파일로 알림 리소스를 선언적으로 정의·관리할 수 있어 코드로 인프라를 관리(IaC)할 때 유용합니다.
출처: 문서
본문
파일 프로비저닝은 Grafana가 시작할 때 YAML 파일에서 알림 리소스를 로드해 생성·업데이트합니다. 이를 통해 알림 리소스를 버전 관리하고 환경 간에 재사용할 수 있습니다.
프로비저닝 구성
프로비저닝 파일은 Grafana 구성 파일(grafana.ini)의 [alerting] 섹션에서 지정합니다.
- Alerting 프로비저닝 경로 —
provisioning디렉터리 안의alerting/폴더를 사용.
기본 경로는 /etc/grafana/provisioning/alerting/입니다.
프로비저닝 파일 형식
프로비저닝은 JSON 또는 YAML 형식을 지원합니다. 파일을 수정하면 Grafana를 재시작하거나 핫 리로드(hot reload)로 변경 사항을 반영할 수 있습니다.
프로비저닝 가능한 리소스
파일로 프로비저닝할 수 있는 리소스는 다음과 같습니다.
- Alert rules (알림 규칙)
- Contact points (연락 지점)
- Notification policies (알림 정책)
- Mute timings (음소거 타이밍)
- Templates (템플릿)
각 리소스는 apiVersion, kind, metadata, spec 필드를 가진 YAML로 정의합니다.
연락 지점 프로비저닝 예시
apiVersion: 1
contactPoints:
- orgId: 1
name: team-a
receivers:
- type: email
settings:
addresses: [email protected]
알림 정책 프로비저닝 예시
apiVersion: 1
policies:
- orgId: 1
policy:
receiver: team-a
group_by: ['alertname']
프로비저닝 규칙
- 파일의 리소스는 기존 리소스를 덮어쓰거나 새로 생성합니다.
- 프로비저닝된 리소스는 파일이 존재하는 한 UI에서 삭제하거나 수정할 수 없습니다.