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-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 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-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 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.ioPara 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:
- Accede a 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 mostrar solo 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.
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-obsen la organizaciónorg-1eshttps://org-1/platform-obs/cortex/alertmanager/.
Autentica la solicitud de curl
- Descarga e instala la CLI de gdcloud.
Configura la propiedad
core/organization_console_urlde gdcloud:gdcloud config set core/organization_console_url https://GDC_URLAccede con el proveedor de identidad configurado:
gdcloud auth loginUsa 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:
- Autentica la solicitud
curl. Usa
curlpara 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.