Configurar canales de notificación para las alertas

Google Distributed Cloud (GDC) aislado te permite configurar canales de notificación personalizados para dirigir las alertas activadas a personas, equipos o turnos de guardia específicos. Enviar alertas a través de canales como PagerDuty, SMS, webhooks o integraciones personalizadas ayuda a reducir la fatiga por alertas y permite la respuesta a incidentes a tiempo.

Como los canales de notificación predefinidos, como Slack o el correo electrónico, no están disponibles en GDC, debes configurar al menos un canal personalizado para recibir alertas. Debes definir el tipo de canal, el endpoint de destino y las credenciales de autenticación en un objeto ConfigMap de Alertmanager. A continuación, importa esa configuración a un recurso personalizado de ObservabilityPipeline en el espacio de nombres de tu proyecto.

Antes de empezar

Para gestionar recursos personalizados de ObservabilityPipeline, debes tener los permisos necesarios.

Solicitar roles de organización de gestión de identidades y accesos

Ponte en contacto con el admin. de la org. de gestión de identidades y accesos para solicitar los siguientes roles:

  • Creador de flujos de procesamiento de observabilidad (observabilitypipeline-pa-creator): crea recursos personalizados de ObservabilityPipeline.
  • Editor de canalizaciones de observabilidad (observabilitypipeline-pa-editor): edita o modifica recursos personalizados de ObservabilityPipeline.
  • Observability Pipeline Viewer (observabilitypipeline-pa-viewer): permite ver recursos personalizados de ObservabilityPipeline.
  • Editor de ConfigMap (observabilitypipeline-configmap-editor): crea objetos ConfigMap en el espacio de nombres de la plataforma.

Solicitar roles de proyecto de gestión de identidades y accesos

Ponte en contacto con el administrador de proyectos de gestión de identidades y accesos para solicitar los siguientes roles:

  • Editor de ObservabilityPipeline (observabilitypipeline-editor): edita o modifica los recursos personalizados de ObservabilityPipeline en el espacio de nombres del proyecto.
  • Lector de ObservabilityPipeline (observabilitypipeline-viewer): consulta los recursos personalizados de ObservabilityPipeline en el espacio de nombres del proyecto.

Configurar canales de notificación

Configura los canales de notificación de las alertas en el espacio de nombres de tu proyecto:

  1. Define tu configuración personalizada para los canales de notificación en un archivo YAML llamado alertmanager.yml. Debes seguir la misma sintaxis que la especificación de Alertmanager:

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

  2. Crea un objeto ConfigMap e incluye tu configuración personalizada del archivo alertmanager.yml en el campo data.

    En el siguiente ejemplo se muestra cómo debe ser el objeto ConfigMap con el archivo alertmanager.yml:

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

    Haz los cambios siguientes:

    • CONFIGMAP_NAME: el nombre del archivo de definición de ConfigMap. Usarás este nombre más adelante en el recurso personalizado ObservabilityPipeline.
    • PROJECT_NAMESPACE: el espacio de nombres de tu proyecto.
  3. Aplica el objeto ConfigMap al servidor de la API Management en el mismo espacio de nombres que las alertas configuradas:

    kubectl --kubeconfig KUBECONFIG_PATH apply -f CONFIGMAP_NAME.yaml
    

    Haz los cambios siguientes:

    • KUBECONFIG_PATH: la ruta al archivo kubeconfig del servidor de la API Management.
    • CONFIGMAP_NAME: el nombre del archivo de definición de ConfigMap.
  4. Edita la especificación de recurso personalizado ObservabilityPipeline para importar tu configuración al campo 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
    
      # [...]
    

    Haz los cambios siguientes:

    • PROJECT_NAMESPACE: el espacio de nombres de tu proyecto.
    • OBSERVABILITY_PIPELINE_NAME: el nombre del recurso personalizado de ObservabilityPipeline.
    • CONFIGMAP_NAME: el nombre que has usado para el archivo de definición de ConfigMap. El nombre debe coincidir exactamente.
  5. Guarda el archivo.

  6. Aplica los cambios del recurso personalizado ObservabilityPipeline al servidor de la API Management en el mismo espacio de nombres que las alertas configuradas:

    kubectl --kubeconfig KUBECONFIG_PATH apply -f OBSERVABILITY_PIPELINE_NAME.yaml
    

    Haz los cambios siguientes:

    • KUBECONFIG_PATH: la ruta al archivo kubeconfig del servidor de la API Management.
    • OBSERVABILITY_PIPELINE_NAME: el nombre del archivo de definición de ObservabilityPipeline.