Alertmanager 데이터 소스

Alertmanager 데이터 소스 (Alertmanager data source)

Grafana는 Prometheus와 Grafana Mimir의 Alertmanager 구현을 내장 지원해요. Alertmanager 데이터 소스를 추가한 뒤 Grafana Alerting의 Choose Alertmanager 드롭다운으로 침묵, 연락처 포인트, 알림 정책 같은 Alertmanager 리소스를 보고 관리할 수 있습니다. 또한 Alertmanager가 Grafana-managed 알림을 받도록 활성화할 수 있어요.

출처: 문서

본문

Grafana는 Prometheus와 Grafana Mimir의 Alertmanager 구현을 내장 지원합니다. Alertmanager 데이터 소스 추가 후 Grafana Alerting의 Choose Alertmanager 드롭다운으로 침묵(silences), 연락처 포인트, 알림 정책(notification policies) 등 Alertmanager 리소스를 보고 관리할 수 있어요. 또한 Alertmanager가 Grafana-managed 알림을 받도록 활성화할 수 있습니다.

Alertmanager 구현 (Alertmanager implementations)

데이터 소스의 Settings 페이지에서 구현을 지정할 수 있어요.

Prometheus 구현을 사용할 때 Grafana Alerting UI에서 침묵을 관리할 수 있어요. 연락처 포인트, 알림 정책, 템플릿은 Prometheus Alertmanager API가 이 리소스에 대한 쓰기 작업을 지원하지 않으므로 읽기 전용입니다.

데이터 소스 구성 (Configure the data source)

1. 왼쪽 메뉴에서 Connections 를 클릭합니다.
2. Your connections 아래에서 Data sources 를 클릭합니다.
3. 검색창에 Alertmanager 를 입력합니다.
4. Alertmanager 를 클릭합니다. 데이터 소스의 Settings 탭이 표시됩니다.

기본 구성 옵션 설정:

인증: 데이터 소스는 basic auth와 TLS를 포함한 모든 표준 Grafana HTTP 인증 방법을 지원합니다. Grafana에서 SigV4 인증이 전역 활성화되면 이 데이터 소스에서도 사용 가능해요. 인증 옵션·연결 설정에 대한 자세한 내용은 Data source management을 참고하세요.

연결 확인 (Verify the connection)

Save & test 를 클릭해 연결을 확인합니다. 성공하면 Health check passed. 가 반환됩니다.

참고: Mimir 구현을 사용 중이고 Mimir Alertmanager가 아직 구성되지 않았다면 헬스 체크가 통과할 수 있어요. Mimir가 lazy configuration 모드로 실행 중일 때 예상되는 동작입니다.

데이터 소스 프로비저닝 (Provision the data source)

Alertmanager 데이터 소스는 구성 파일이나 Terraform으로 프로비저닝할 수 있어요. 두 방법에서 사용되는 jsonData 필드:

구성 파일 (Configuration file): 자세한 내용은 Provisioning data sources를 참고하세요.

apiVersion: 1

datasources:
  - name: Alertmanager
    type: alertmanager
    url: http://localhost:9093
    access: proxy
    jsonData:
      implementation: prometheus
      handleGrafanaManagedAlerts: false
    basicAuth: true
    basicAuthUser: <USERNAME>
    secureJsonData:
      basicAuthPassword: <PASSWORD>

Terraform:

resource "grafana_data_source" "alertmanager" {
  name = "Alertmanager"
  type = "alertmanager"
  url  = "http://localhost:9093"

  json_data_encoded = jsonencode({
    implementation            = "prometheus"
    handleGrafanaManagedAlerts = false
  })
}

모든 구성 옵션은 Grafana provider 데이터 소스 리소스 문서를 참고하세요.

문제 해결 (Troubleshoot Alertmanager data source issues)

"Health check failed." — Save & test 가 Health check failed. 반환. URL이 접근 불가하거나 예상치 못한 응답 반환.

"It looks like you have chosen Prometheus implementation, but detected a Mimir or Cortex endpoint." — Alertmanager Implementation 이 Prometheus 로 설정된 상태에서 발생. 입력한 URL이 Mimir 또는 Cortex Alertmanager 엔드포인트입니다. 구현을 Mimir 또는 Cortex 로 변경하고 다시 Save & test 하세요.

"It looks like you have chosen a Mimir or Cortex implementation, but detected a Prometheus endpoint." — 구현이 Mimir 또는 Cortex 로 설정된 상태에서 발생. 입력한 URL이 Prometheus Alertmanager 엔드포인트입니다. 구현을 Prometheus 로 변경하고 다시 Save & test 하세요.

Grafana-managed 알림이 수신되지 않음 — 데이터 소스 설정에서 Receive Grafana Alerts 토글이 활성화되어 있어도 알림이 도착하지 않는다면, 데이터 소스에서의 활성화만으로는 부족합니다. Grafana UI의 Alerting > Administration 에서 알림 전달도 활성화해야 해요. Grafana-managed 알림이 이 Alertmanager로 전달되려면 두 설정이 모두 켜져 있어야 합니다.

연락처 포인트·알림 정책이 읽기 전용 — Prometheus 구현을 사용 중일 때 발생. Prometheus Alertmanager API는 이 리소스에 대한 쓰기 작업을 지원하지 않아요. 연락처 포인트·알림 정책에 전체 읽기/쓰기 접근이 필요하면 Mimir 또는 Cortex Alertmanager로 전환하고 Alertmanager Implementation 설정을 업데이트하세요.

더 알아보기 (Learn more)

• 출처 문서: Alertmanager data source
• Grafana Alerting
• 외부 Alertmanager 구성
• Prometheus Alertmanager 문서
• Grafana Mimir 문서