Configura un canale di notifica Simple Mail Transfer Protocol (SMTP) per gli avvisi di Prometheus

Un canale di notifica Simple Mail Transfer Protocol (SMTP) nell'appliance GDC con air gap consente di inviare gli avvisi Prometheus attivati direttamente all'indirizzo email del tuo team tramite una risorsa personalizzata ObservabilityPipeline. Se scegli di non configurare le notifiche via email, puoi comunque visualizzare gli avvisi nelle dashboard di Grafana per gli spazi dei nomi infra-obs e platform-obs.

Prima di iniziare

Configura il dispositivo e installa il software

Configura i canali di notifica

Segui questi passaggi per configurare i canali di notifica via email o Slack:

  1. Per creare un canale di notifica degli avvisi personalizzato, ospita il server SMTP nella tua rete e tieni pronti i dettagli di configurazione SMTP (IP, nome utente, password, email del destinatario) per creare la configurazione di alertmanager. Puoi convalidare la correttezza dell'IP dell'host SMTP eseguendo il ping da bm03.

  2. Crea un file cm.yml con i seguenti contenuti:

    smtp_smarthost deve avere l'indirizzo IP del server SMTP ospitato dal cliente.

      apiVersion: v1
      kind: ConfigMap
      metadata:
        # The name must match the ConfigMap name specified in the ObservabilityPipeline custom resource.
        name: appl-alert-notification
        # The namespace must match the project namespace
        namespace: PROJECT_NAMESPACE
      data:
        # The file name must be alertmanager.yml
        alertmanager.yml: |
          global:
            smtp_smarthost: SMTP HOST IP ADDRESS
            smtp_from: FROM_EMAIL_ADDRESS
            # Give empty string for unsecured smtp server in username and password and false in smtp_require_tls.
            smtp_auth_username: USERNAME
            smtp_auth_password: PASSWORD
            smtp_require_tls: true
          route:
            group_by: ['alertname', 'cluster', 'service']
            group_wait: 30s
            group_interval: 5m
            repeat_interval: 3h
            receiver: team-X-mails
          receivers:
            - name: 'team-X-mails'
              email_configs:
                - to: **RECIEVER_EMAIL_ID**
    
  3. Aggiorna i campi obbligatori con i contenuti corretti.

  4. Esegui kubectl apply -f cm.yaml.

  5. Crea una risorsa personalizzata ObservabilityPipeline con quanto segue:

        # 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
        ...
    

    Sostituisci quanto segue:

    • PROJECT_NAMESPACE: lo spazio dei nomi del progetto.
    • CUSTOMIZED_CONFIGMAP_NAME: il nome utilizzato per il file di configurazione nell'oggetto ConfigMap deve corrispondere esattamente al nome dell'oggetto ConfigMap. Ad esempio, nel passaggio 2, se hai utilizzato appl-alert-notification come nome di ConfigMap, utilizza lo stesso nome per il file di configurazione nell'oggetto ObservabilityPipeline.

  6. Aggiorna lo spazio dei nomi con il valore utilizzato nel passaggio precedente.

  7. Esegui kubectl apply -f ob.yaml.

  8. Tutti gli avvisi visibili nella dashboard di Grafana di GDC attivano un'email se sono in stato firing. Avvia Grafana per lo spazio dei nomi utilizzato nei passaggi precedenti e verifica la presenza di avvisi in stato firing. Gli avvisi vengono inviati al tuo indirizzo email.

Passaggi successivi