알림 리소스 내보내기

알림 리소스 내보내기 (Export alerting resources)

알림 규칙·컨택트 포인트·알림 정책 같은 알림 리소스를 프로비저닝을 위해 내보낼 수 있어요. Grafana UI, HTTP Alerting API, Export API 엔드포인트 세 가지 방법이 있으며, 단일 폴더와 단일 그룹을 자동으로 가져올 수 있습니다. YAML·JSON·Terraform 형식으로 내보내 프로비저닝할 수 있어요.

참고: 파일 프로비저닝으로 가져온 알림 리소스는 Grafana UI에서 편집할 수 없어요. 이는 Grafana 재시작 시 파일 프로비저닝이 UI 변경을 덮어쓰는 것을 방지하기 위함입니다. 프로비저닝된 리소스를 수정하려면 HTTP API 리소스를 UI에서 편집 또는 Terraform 리소스를 UI에서 편집 문서를 참고하세요.

출처: 문서

본문

Grafana UI에서 내보내기

YAML, JSON, 또는 Terraform 형식으로 리소스를 다운로드받아 구성 파일 또는 Terraform으로 프로비저닝할 수 있어요.

알림 규칙 내보내기

  1. Alerts & IRM → Alert rules 클릭
  2. 모든 Grafana 관리 규칙을 내보내려면 Export rules 클릭
  3. 폴더를 내보내려면 View as를 List로 변경 → 내보낼 폴더 선택 후 Export rules folder 아이콘 클릭
  4. 그룹을 내보내려면 View as를 Grouped로 변경 → 내보낼 그룹 찾아 Export rule group 아이콘 클릭
  5. 내보낼 형식 선택(YAML, JSON, Terraform)
  6. Copy Code 또는 Download 클릭

변경 저장 없이 알림 규칙 수정·내보내기

참고: Grafana 관리 알림 규칙 전용이며 Admin, Viewer, Editor 역할에 사용 가능합니다. Modify export 모드로 알림 규칙을 업데이트 없이 편집·내보낼 수 있어요. 내보낸 데이터는 같은 알림 그룹의 모든 규칙을 포함합니다.

  1. Alerts & IRM → Alert rules 클릭
  2. 편집할 규칙 찾아 More → Modify Export 클릭해 Alert Rule 폼 열기
  3. 변경할 필드 편집(알림 규칙에는 적용되지 않음)
  4. Export 클릭 → 형식 선택(YAML, JSON, Terraform) → Copy Code 또는 Download

변경 저장 없이 새 알림 규칙 정의 내보내기

참고: Terraform(HCL) 형식으로만 내보낼 수 있습니다. 기존 프로비저닝된 규칙 그룹에 새 알림 규칙 정의를 추가할 수 있어요. 알림 규칙 정의는 규칙을 정의하되 저장하지 않는 것이며, Terraform으로 프로비저닝할 때만 저장된 알림 규칙이 됩니다.

  1. Alerts & IRM → Alert rules 클릭
  2. Export rule definition 클릭
  3. 알림 규칙 상세 입력
  4. 규칙 정의를 추가할 프로비저닝된 폴더·그룹 선택
  5. Export 클릭 → 코드를 Terraform 파이프라인에 복사해 새 알림 규칙 생성

컨택트 포인트 내보내기

  1. Alerts & IRM → Contact points 클릭
  2. 내보낼 컨택트 포인트 찾아 More → Export 클릭
  3. 형식 선택 → Copy Code 또는 Download

알림 템플릿 그룹 내보내기

Grafana는 알림 템플릿 그룹에 대한 Export UI나 Export 엔드포인트를 제공하지 않아요. 대신 UI에서 내용과 이름을 수동으로 복사하세요.

  1. Alerts & IRM → Contact points → Notification templates 탭
  2. 내보낼 템플릿 그룹 찾기
  3. 내용과 이름 복사
  4. 파일 프로비저닝 형식 또는 Terraform 리소스에 맞게 조정

알림 정책 트리 내보내기

모든 알림 정책은 단일 리소스(알림 정책 트리의 루트)를 통해 프로비저닝됩니다.

경고: 정책 트리는 단일 리소스이므로 프로비저닝하면 정책 트리의 모든 정책이 덮어써집니다. 다만 알림 규칙이 컨택트 포인트를 직접 선택할 때 생성되는 내부 정책에는 영향이 없어요.

  1. Alerts & IRM → Notification policies 클릭
  2. Default notification policy 섹션에서 … → Export 클릭
  3. 형식 선택 → Copy Code 또는 Download

개별 named routing tree도 내보낼 수 있어요: 목록에서 라우팅 트리 찾기 → More actions → Export → 형식 선택 → Copy Code/Download.

Mute timing 내보내기

  1. Alerts & IRM → Notification policies → Mute timings 탭
  2. 내보낼 mute timing 찾아 Export 클릭
  3. 형식 선택 → Copy Code 또는 Download

HTTP Alerting API

Alerting HTTP API로 기존 알림 리소스를 JSON으로 반환받고 같은 엔드포인트로 다른 Grafana 인스턴스에 가져올 수 있어요.

리소스 URI
Alert rules /api/v1/provisioning/alert-rules
Contact points /api/v1/provisioning/contact-points
Notification policy tree /api/v1/provisioning/policies
Notification template groups /api/v1/provisioning/templates
Mute timings /api/v1/provisioning/mute-timings

이 표준 엔드포인트는 구성 파일·Terraform 프로비저닝과 호환되지 않는 JSON 형식을 반환해요(아래 /export 엔드포인트 제외).

Export API 엔드포인트

Alerting HTTP API는 YAML 또는 JSON으로 프로비저닝 파일 형식의 리소스를 내보내는 전용 엔드포인트를 제공해요.

리소스 Method / URI
Alert rules GET /api/v1/provisioning/alert-rules/export
Alert rules GET /api/v1/provisioning/folder/:folderUid/rule-groups/:group/export
Alert rules GET /api/v1/provisioning/alert-rules/:uid/export
Contact points GET /api/v1/provisioning/contact-points/export
Notification policy tree GET /api/v1/provisioning/policies/export
Mute timings GET /api/v1/provisioning/mute-timings/export
Mute timings GET /api/v1/provisioning/mute-timings/:name/export

이 엔드포인트들은 내보낸 리소스 파일을 다운로드하는 download 파라미터를 지원합니다.

더 알아보기 (Learn more)