Consultar y ver alertas abiertas

La monitorización de alertas en Google Distributed Cloud (GDC) aislado te permite hacer un seguimiento de las notificaciones activas de 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 crear secuencias de comandos, tareas cron e integraciones personalizadas, consulta el endpoint HTTP de Cortex Alertmanager de tu proyecto con curl.

Antes de empezar

Para obtener los permisos que necesitas para consultar y visualizar alertas, pide a tu administrador de proyectos de gestión de identidades y accesos que te conceda uno de los roles de Alertmanager de Project Cortex asociados en el espacio de nombres de tu proyecto. En función del nivel de acceso y de los permisos que necesites, puedes obtener los roles de editor o de lector para este recurso en un proyecto.

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

Perfil ficticio Objeto Clúster Rol Espacio de nombres Grupo o 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

Sustituye las siguientes variables según corresponda:

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

Configuración 1

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

  • Comando kubectl

    Este es el formato de comando genérico:

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

Configuración 2

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

  • Comando kubectl

    Este es el formato de comando genérico:

    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 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 Preparar permisos de gestión de identidades y accesos.

Ver y filtrar alertas abiertas

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

Consola

Para ver las alertas abiertas de un proyecto desde la consola de GDC, sigue estos pasos:

  1. Inicia sesión en 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 que solo se muestren 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.

Endpoint de Cortex

En esta sección se describe cómo acceder a las alertas mediante el endpoint de Cortex Alertmanager.

Identificar tu endpoint de Cortex

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

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

Haz los cambios siguientes:

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

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

Autenticar la solicitud de curl

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

    gdcloud config set core/organization_console_url
    https://GDC_URL
    
  3. Inicia sesión con el proveedor de identidades configurado:

    gdcloud auth login
    
  4. Usa tu nombre de usuario y contraseña para autenticarte e iniciar sesión.

    Cuando el inicio de sesión se haya realizado correctamente, podrás usar el encabezado de autorización en tu solicitud curl mediante el comando gdcloud auth print-identity-token. Para obtener más información, consulta gdcloud auth.

Llamar al endpoint de Cortex

Sigue estos pasos para llegar al endpoint de Cortex con la herramienta curl:

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

    A continuación, se muestra 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.