Configurar canais de notificação para alertas

Com a plataforma de observabilidade, é possível configurar canais de notificação para os alertas definidos. O sistema envia um alerta para esses canais personalizados sempre que um evento causa um alerta. Assim, você pode notificar os destinatários necessários de acordo com seus métodos preferidos.

O appliance isolado do Google Distributed Cloud (GDC) não predefine canais de notificação para envio de alertas. É necessário definir pelo menos um canal para receber alertas. Se você não definir uma configuração de canal de notificação, o sistema de observabilidade do GDC vai usar a configuração dos recursos da plataforma como padrão. Consequentemente, se você não configurar canais de notificação do, mas um administrador fizer isso para a organização, o sistema enviará alertas para esses canais.

Antes de começar

Para receber as permissões necessárias para configurar ou visualizar canais de notificação, peça ao administrador do IAM do projeto para conceder a você um dos seguintes papéis no namespace do projeto:

• Editor de pipeline de observabilidade: edita ou modifica recursos personalizados ObservabilityPipeline. Solicite o papel de editor do pipeline de observabilidade (observabilitypipeline-editor).
• Leitor do pipeline de observabilidade: visualiza recursos personalizados ObservabilityPipeline. Solicite o papel de Leitor do pipeline de observabilidade (observabilitypipeline-viewer).

Configurar canais de notificação

Siga estas etapas para configurar canais de notificação para os alertas definidos para o monitoramento do sistema:

1. Defina a configuração de alertas de observabilidade seguindo a especificação em https://prometheus.io/docs/alerting/latest/configuration/.

2. Crie um objeto ConfigMap e implante-o no namespace do projeto. O objeto precisa conter as regras de configuração no arquivo alertmanager.yml.

   apiVersion: v1
   kind: ConfigMap
   metadata:
     # The name must match the ConfigMap name specified in the ObservabilityPipeline custom resource.
     name: CUSTOMIZED_CONFIGMAP_NAME
     # Choose namespace that matches the project's namespace
     namespace: PROJECT_NAMESPACE
   data:
     # The file name must be alertmanager.yml.
     alertmanager.yml: |
       # Add the customized Alertmanager configuration here.
   

   Substitua:

   • CUSTOMIZED_CONFIGMAP_NAME: o nome do arquivo de configuração para usar na CR ObservabilityPipeline na próxima etapa.
   • PROJECT_NAMESPACE: o namespace do projeto.
   Observação: siga a mesma sintaxe descrita em https://prometheus.io/docs/alerting/latest/configuration para definir os canais de notificação no arquivo alertmanager.yml.

3. Configure o recurso personalizado ObservabilityPipeline em um editor de linha de comando para importar a configuração no campo alertmanagerConfig aninhado no campo alerting.

     # Configure observability pipeline
   apiVersion: observability.gdc.goog/v1
   kind: ObservabilityPipeline
   metadata:
     # Choose namespace that matches the project's namespace
     namespace: PROJECT_NAMESPACE
     name: observability-config
   spec:
     # Configure Alertmanager
     alerting:
       # Permission: PA and AO
       # The alerts configuration must be in the key "alertmanager.yml" of the configMap
       alertmanagerConfig: CUSTOMIZED_CONFIGMAP_NAME
     ...
   

   Substitua:

   • PROJECT_NAMESPACE: o namespace do projeto.
   • CUSTOMIZED_CONFIGMAP_NAME: o nome usado para o arquivo de configuração no objeto ConfigMap. O nome precisa ser exatamente igual.

4. Salve as mudanças no CR ObservabilityPipeline e saia do editor de linha de comando.