Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

알림의 알림 채널 구성

이 페이지에서는 알림을 수신하도록 알림 채널을 구성하는 프로세스를 간략하게 설명합니다.

알림 채널은 구성된 알림의 전송 메커니즘입니다. 이벤트가 알림을 트리거하면 시스템은 이러한 채널을 통해 지정된 수신자에게 알립니다. 이 프로세스를 통해 중요한 알림이 선호하는 커뮤니케이션 방법을 통해 적절한 담당자에게 전달됩니다.

Google Distributed Cloud (GDC) 에어 갭 환경에서는 Slack 또는 이메일과 같은 사전 정의된 알림 채널을 사용할 수 없습니다. 알림을 받으려면 커스텀 알림 채널을 하나 이상 구성해야 합니다. 프로젝트 네임스페이스에서 ObservabilityPipeline 커스텀 리소스를 수정하여 채널 구성을 적용합니다.

관리자는 알림 채널을 맞춤설정하여 다음을 수행할 수 있습니다.

특정 수신자 타겟팅: 문제를 해결할 책임이 있는 개인, 팀 또는 온콜 순환 근무자에게 알림을 보냅니다.
선호하는 커뮤니케이션 방법 사용: SMS, PagerDuty, 웹훅, 커스텀 통합과 같은 채널을 통해 알림을 전송하여 개인의 선호도와 운영 워크플로를 충족합니다.
알림 피로 방지: 노이즈를 줄이고 조치를 취해야 하는 사용자가 알림을 받도록 합니다.

GDC에서 알림 채널을 구현하려면 관리자가 시스템 내에서 채널 구성을 정의해야 합니다. 이 프로세스에는 일반적으로 다음과 같은 매개변수를 지정하는 작업이 포함됩니다.

채널 유형: 사용 중인 채널의 유형입니다.
대상: 시스템에서 알림을 전송해야 하는 엔드포인트입니다.
인증: 대상에 액세스하는 데 필요한 사용자 인증 정보입니다.

관리자는 알림 채널을 구성하여 모니터링 플랫폼이 중요한 알림을 효과적으로 전달하도록 보장함으로써 잠재적인 문제에 신속하게 대응하고 GDC 환경의 안정성과 성능을 유지할 수 있습니다.

시작하기 전에

ObservabilityPipeline 커스텀 리소스를 관리하려면 필요한 권한이 있어야 합니다.

IAM 조직 역할 요청

IAM 조직 관리자에게 문의하여 다음 역할을 요청하세요.

ObservabilityPipeline PA 생성자 (observabilitypipeline-pa-creator): ObservabilityPipeline 커스텀 리소스를 만듭니다.
ObservabilityPipeline PA 편집자 (observabilitypipeline-pa-editor): ObservabilityPipeline 커스텀 리소스를 수정하거나 변경합니다.
ObservabilityPipeline PA 뷰어 (observabilitypipeline-pa-viewer): ObservabilityPipeline 커스텀 리소스를 봅니다.
ConfigMap 편집자 (observabilitypipeline-configmap-editor): 플랫폼 네임스페이스에 ConfigMap 객체를 만듭니다.

IAM 프로젝트 역할 요청

IAM 프로젝트 관리자에게 문의하여 다음 역할을 요청하세요.

ObservabilityPipeline 편집자 (observabilitypipeline-editor): 프로젝트 네임스페이스에서 ObservabilityPipeline 커스텀 리소스를 수정합니다.
ObservabilityPipeline 뷰어 (observabilitypipeline-viewer): 프로젝트 네임스페이스에서 ObservabilityPipeline 커스텀 리소스를 봅니다.

알림 채널 구성

프로젝트 네임스페이스에서 알림의 알림 채널을 구성합니다.

alertmanager.yml이라는 YAML 파일에서 알림 채널의 커스텀 구성을 정의합니다. Alertmanager 사양과 동일한 문법을 따라야 합니다.

https://prometheus.io/docs/alerting/latest/configuration/.

ConfigMap 객체를 만들고 data 필드의 alertmanager.yml 파일에서 커스텀 구성을 포함합니다.

다음 예시에서는 alertmanager.yml 파일과 함께 ConfigMap 객체가 어떻게 표시되어야 하는지 보여줍니다.

apiVersion: v1
kind: ConfigMap
metadata:
  name: CONFIGMAP_NAME
  # The namespace must match your project namespace.
  namespace: PROJECT_NAMESPACE
data:
  # The file name must be alertmanager.yml
  alertmanager.yml: |
    # Define your notification channels.
    # Add the custom configuration in the following lines of this file.
    # Follow the same syntax as in https://prometheus.io/docs/alerting/latest/configuration

  [...]

다음을 바꿉니다.

CONFIGMAP_NAME: ConfigMap 정의 파일의 이름입니다. 이 이름은 나중에 ObservabilityPipeline 커스텀 리소스에서 사용합니다.
PROJECT_NAMESPACE: 프로젝트 네임스페이스입니다.

구성된 알림과 동일한 네임스페이스 내에서 Management API 서버에 ConfigMap 객체를 적용합니다.
```
kubectl --kubeconfig KUBECONFIG_PATH apply -f CONFIGMAP_NAME.yaml
```
다음을 바꿉니다.
- KUBECONFIG_PATH: Management API 서버의 kubeconfig 파일 경로
- CONFIGMAP_NAME: ConfigMap 정의 파일의 이름입니다.
ObservabilityPipeline 커스텀 리소스 사양을 수정하여 구성을 alertmanagerConfig 필드로 가져옵니다.
```
 # Configure the observability pipeline.
apiVersion: observability.gdc.goog/v1
kind: ObservabilityPipeline
metadata:
  # The namespace must match your project namespace.
  namespace: PROJECT_NAMESPACE
  name: OBSERVABILITY_PIPELINE_NAME
spec:
  # Configure alerts.
  alerting:
    # The alerting configuration must be in the ConfigMap.
    # The value must match the ConfigMap name exactly.
    alertmanagerConfig: CONFIGMAP_NAME

  [...]
```
다음을 바꿉니다.
- PROJECT_NAMESPACE: 프로젝트 네임스페이스입니다.
- OBSERVABILITY_PIPELINE_NAME: ObservabilityPipeline 커스텀 리소스의 이름입니다.
- CONFIGMAP_NAME: ConfigMap 정의 파일에 사용한 이름입니다. 이름은 정확하게 일치해야 합니다.
참고: ObservabilityPipeline 커스텀 리소스의 alerting 필드에서 볼륨 (volumes) 및 볼륨 마운트 (volumeMounts)와 같은 프로젝트 네임스페이스의 다른 구성을 정의할 수도 있습니다. alertmanager.yml 파일에서 볼륨 마운트 이름을 참조합니다.
파일을 저장합니다.
구성된 알림과 동일한 네임스페이스 내에서 ObservabilityPipeline 커스텀 리소스의 변경사항을 Management API 서버에 적용합니다.
```
kubectl --kubeconfig KUBECONFIG_PATH apply -f OBSERVABILITY_PIPELINE_NAME.yaml
```
다음을 바꿉니다.
- KUBECONFIG_PATH: Management API 서버의 kubeconfig 파일 경로
- OBSERVABILITY_PIPELINE_NAME: ObservabilityPipeline 정의 파일의 이름입니다.