Consulta y visualiza las alertas abiertas

La supervisión de alertas en Google Distributed Cloud (GDC) aislado te permite hacer un seguimiento de las notificaciones activas en tu proyecto y solucionar problemas relacionados con ellas después de crear reglas de alerta. Puedes inspeccionar la gravedad, la duración, el estado y las etiquetas de las alertas en la consola de GDC. Para secuencias de comandos, trabajos cron y, también, integraciones personalizadas, consulta el extremo HTTP de Cortex Alertmanager de tu proyecto con curl.

Antes de comenzar

Para obtener los permisos que necesitas para consultar y visualizar alertas, pídele al administrador de proyectos de IAM que te otorgue uno de los roles de Alertmanager de Cortex del proyecto asociados en el espacio de nombres de tu proyecto. Según el nivel de acceso y los permisos que necesites, puedes obtener roles de editor o visualizador para este recurso en un proyecto.

En la siguiente tabla, se resumen los requisitos de Role para PA and AO persona.

Personificación Objeto Clúster Rol Espacio de nombres Grupo/usuario Configuración
PA grafana org-admin project-cortex-alertmanager-viewer platform-obs Grupo 1
PA grafana org-admin project-cortex-alertmanager-viewer platform-obs Usuario 2
AO alertmanager org-admin project-cortex-alertmanager-viewer PROJECT_NAMESPACE Grupo 1
AO alertmanager org-admin project-cortex-alertmanager-viewer PROJECT_NAMESPACE Usuario 2

Reemplaza las siguientes variables de forma adecuada:

Variable Descripción
KUBECONFIG Necesitarás el kubeconfig del clúster específico que contiene el NAMESPACE en el que se aplicará este RoleBinding.
RULE_NAME Es el nombre único de este recurso RoleBinding dentro del espacio de nombres. Por ejemplo, pa-cortex-alertmanager-viewer
NAMESPACE Es el espacio de nombres de Kubernetes en el que se creará y aplicará este RoleBinding. Busca la columna Namespace en la tabla anterior.
EMAIL_ADDRESS Es el identificador del usuario al que se le otorga el rol. Suele ser una dirección de correo electrónico. Por ejemplo, infrastructure-operator@example.com.
ROLE Es el nombre del Role que contiene los permisos que deseas otorgar al usuario. Busca los roles disponibles en la tabla anterior.
GROUP_NAME Es el nombre del Group al que pertenece el usuario de PA o AO. Por ejemplo, pa-group
ZONE Nombre de la zona

Config. 1

Esta configuración otorga permisos a un grupo de usuarios para acceder a las alertas de PA/AO en el clúster org. Después de establecer esta configuración, consulta la sección consola de este documento para ver las alertas en la consola de GDC.

  • Comando de kubectl

    Este es el formato genérico del comando:

    kubectl --kubeconfig `KUBECONFIG` create rolebinding `RULE_NAME` -n `NAMESPACE` --group=`GROUP_NAME` --role=project-cortex-alertmanager-viewer
    

    Ejemplo:

    kubectl --kubeconfig <path-to-kubeconfig> create rolebinding project-cortex-alertmanager-viewer-binding --role=project-cortex-alertmanager-viewer --group=my-team --namespace=platform-obs
    
  • Ruta de acceso del archivo IAC

    /infrastructure/zonal/zones/`ZONE`/org-admin/rolebindings/`GROUP_NAME`/<YAML_FILE>
    
  • Archivo YAML

    apiVersion: rbac.authorization.k8s.io/v1
    kind: RoleBinding
    metadata:
      name: RULE_NAME
      namespace: NAMESPACE
    subjects:
    - kind: Group
      name: GROUP_NAME
      apiGroup: rbac.authorization.k8s.io
    roleRef:
      kind: Role
      name: project-cortex-alertmanager-viewer
      apiGroup: rbac.authorization.k8s.io
    

Config. 2

Esta configuración es para el rol de PA y se orienta al objeto grafana en el clúster org-admin. Otorga el rol project-cortex-alertmanager-viewer dentro del espacio de nombres platform-obs a un User.

  • Comando de kubectl

    Este es el formato genérico del comando:

    kubectl --kubeconfig `KUBECONFIG` create rolebinding `RULE_NAME` -n platform-obs --user=`EMAIL_ADDRESS` --role=project-cortex-alertmanager-viewer
    

    Ejemplo:

    kubectl --kubeconfig <path-to-kubeconfig> create rolebinding project-cortex-alertmanager-viewer-binding --role=project-cortex-alertmanager-viewer --user=my-email@example.com --namespace=platform-obs
    
  • Ruta de acceso del archivo IAC

    /infrastructure/zonal/zones/`ZONE`/org-admin/rolebindings/`EMAIL_ADDRESS`/<YAML_FILE>
    
  • Archivo YAML

    apiVersion: rbac.authorization.k8s.io/v1
    kind: RoleBinding
    metadata:
      name: RULE_NAME
      namespace: platform-obs
    subjects:
    - kind: User
      name: EMAIL_ADDRESS
      apiGroup: rbac.authorization.k8s.io
    roleRef:
      kind: Role
      name: project-cortex-alertmanager-viewer
      apiGroup: rbac.authorization.k8s.io
    

    Para obtener más información sobre estos roles, consulta Prepara los permisos de IAM.

Visualiza y filtra alertas abiertas

Selecciona uno de los siguientes métodos para consultar y filtrar las alertas abiertas de tu espacio de nombres del proyecto:

Console

Consulta las alertas abiertas en un proyecto desde la consola de GDC:

  1. Accede a la consola de GDC.
  2. En la consola de GDC, selecciona tu proyecto.
  3. En el menú de navegación, selecciona Operaciones > Alertas.
  4. Selecciona la pestaña Alertas.
  5. Consulta la lista de alertas.
  6. En la sección Alertas abiertas, haz clic en Filtrar para mostrar solo las alertas abiertas. También puedes filtrar las alertas por otros nombres o valores de propiedades.
  7. Haz clic en el nombre de una alerta para ver sus detalles.

Extremo de Cortex

En esta sección, se describe cómo acceder a las alertas con tu extremo de Cortex Alertmanager.

Identifica tu extremo de Cortex

La siguiente URL es el extremo de la instancia de Cortex de tu proyecto:

  https://GDC_URL/PROJECT_NAMESPACE/cortex/alertmanager/

Reemplaza lo siguiente:

  • GDC_URL: Es la URL de tu organización en GDC.
  • PROJECT_NAMESPACE: Es el espacio de nombres de tu proyecto.

    Por ejemplo, el extremo de Cortex para el proyecto platform-obs en la organización org-1 es https://org-1/platform-obs/cortex/alertmanager/.

Autentica la solicitud de curl

  1. Descarga e instala la CLI de gdcloud.
  2. Configura la propiedad core/organization_console_url de gdcloud:

    gdcloud config set core/organization_console_url
    https://GDC_URL
    
  3. Accede con el proveedor de identidad configurado:

    gdcloud auth login
    
  4. Usa tu nombre de usuario y contraseña para autenticarte y acceder.

    Cuando el acceso se realice correctamente, podrás usar el encabezado de autorización en tu solicitud curl a través del comando gdcloud auth print-identity-token. Para obtener más información, consulta gdcloud auth.

Llama al extremo de Cortex

Completa los siguientes pasos para llegar al extremo de Cortex con la herramienta curl:

  1. Autentica la solicitud curl.
  2. Usa curl para llamar al extremo de Cortex y extender la URL con la especificación estándar de la API de Alertmanager (https://prometheus.io/docs/prometheus/latest/querying/api/#alertmanagers) para consultar alertas.

    El siguiente es un ejemplo de una solicitud curl:

      curl https://GDC_URL/PROJECT_NAME/cortex/alertmanager/api/v1/alertmanagers \
      -H "Authorization: Bearer $(gdcloud auth print-identity-token \
      --audiences=https://GDC_URL)"
    

    Obtendrás el resultado después del comando. La respuesta de la API está en formato JSON.