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-viewerEjemplo:
kubectl --kubeconfig <path-to-kubeconfig> create rolebinding project-cortex-alertmanager-viewer-binding --role=project-cortex-alertmanager-viewer --group=my-team --namespace=platform-obsRuta 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-viewerEjemplo:
kubectl --kubeconfig <path-to-kubeconfig> create rolebinding project-cortex-alertmanager-viewer-binding --role=project-cortex-alertmanager-viewer --user=my-email@example.com --namespace=platform-obsRuta 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.ioPara 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:
- Inicia sesión en la consola de GDC.
- En la consola de GDC, selecciona tu proyecto.
- En el menú de navegación, selecciona Operaciones > Alertas.
- Selecciona la pestaña Alertas.
- Consulta la lista de alertas.
- 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.
- 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-obsde la organizaciónorg-1eshttps://org-1/platform-obs/cortex/alertmanager/.
Autenticar la solicitud de curl
- Descarga e instala la CLI gdcloud.
Configura la propiedad gdcloud
core/organization_console_url:gdcloud config set core/organization_console_url https://GDC_URLInicia sesión con el proveedor de identidades configurado:
gdcloud auth loginUsa 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:
- Autentica la solicitud de
curl. Usa
curlpara 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.