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 deObservabilityPipeline. - Editor de canalizaciones de observabilidad (
observabilitypipeline-pa-editor): edita o modifica recursos personalizados deObservabilityPipeline. - Observability Pipeline Viewer (
observabilitypipeline-pa-viewer): permite ver recursos personalizados deObservabilityPipeline. - Editor de ConfigMap (
observabilitypipeline-configmap-editor): crea objetosConfigMapen 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 deObservabilityPipelineen el espacio de nombres del proyecto. - Lector de ObservabilityPipeline (
observabilitypipeline-viewer): consulta los recursos personalizados deObservabilityPipelineen 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:
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:Crea un objeto
ConfigMape incluye tu configuración personalizada del archivoalertmanager.ymlen el campodata.En el siguiente ejemplo se muestra cómo debe ser el objeto
ConfigMapcon el archivoalertmanager.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 deConfigMap. Usarás este nombre más adelante en el recurso personalizadoObservabilityPipeline.PROJECT_NAMESPACE: el espacio de nombres de tu proyecto.
Aplica el objeto
ConfigMapal servidor de la API Management en el mismo espacio de nombres que las alertas configuradas:kubectl --kubeconfig KUBECONFIG_PATH apply -f CONFIGMAP_NAME.yamlHaz 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 deConfigMap.
Edita la especificación de recurso personalizado
ObservabilityPipelinepara importar tu configuración al campoalertmanagerConfig:# 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 deObservabilityPipeline.CONFIGMAP_NAME: el nombre que has usado para el archivo de definición deConfigMap. El nombre debe coincidir exactamente.
Guarda el archivo.
Aplica los cambios del recurso personalizado
ObservabilityPipelineal servidor de la API Management en el mismo espacio de nombres que las alertas configuradas:kubectl --kubeconfig KUBECONFIG_PATH apply -f OBSERVABILITY_PIPELINE_NAME.yamlHaz 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 deObservabilityPipeline.