Solucionar problemas de políticas de alertas

En esta página, se explica por qué algunas políticas de alertas pueden comportarse de manera diferente de lo previsto y se ofrecen posibles soluciones para esas situaciones.

Para obtener información sobre las variables que pueden afectar una política de alertas, según el período de duración, por ejemplo, consulta Comportamiento de las políticas de alertas basadas en métricas.

La política de uso de discos crea incidentes inesperados

Creaste una política de alertas para supervisar la capacidad “usada” de los discos en tu sistema. Esta política supervisa la métrica agent.googleapis.com/disk/percent_used. Esperas que se te notifique solo cuando el uso de cualquier disco físico supere el límite que configuraste en la condición. Sin embargo, esta política crea incidentes cuando el uso del disco de cada disco físico es menor que el umbral.

Una causa conocida de incidentes inesperados para estas políticas es que las condiciones no se restringen a la supervisión de discos físicos. En su lugar, estas políticas supervisan todos los discos, incluidos los discos virtuales, como los dispositivos de bucle invertido. Si se construye un disco virtual de tal manera que su uso es del 100%, eso provocaría la creación de un incidente para la política.

Por ejemplo, considera el siguiente resultado del comando df de Linux, que muestra el espacio en disco disponible en sistemas de archivos activados para un sistema:

$ df
/dev/root     9983232  2337708  7629140   24%  /
devtmpfs      2524080        0  2524080    0%  /dev
tmpfs         2528080        0  2528080    0%  /dev/shm
...
/dev/sda15     106858     3934   102924    4%  /boot/efi
/dev/loop0      56704    56704        0  100%  /snap/core18/1885
/dev/loop1     129536   129536        0  100%  /snap/google-cloud-sdk/150
...

En este sistema, se debe configurar una política de alertas de uso del disco para filtrar las series temporales de los dispositivos de bucle invertido /dev/loop0 y /dev/loop1. Por ejemplo, puedes agregar el filtro device !=~ ^/dev/loop.*, que excluye todas las series temporales cuya etiqueta device no coincide con la expresión regular ^/dev/loop.*.

La política de tiempo de actividad no crea las alertas esperadas

Si deseas recibir notificaciones si una máquina virtual (VM) se reinicia o se apaga, debes crear una política de alertas que supervise la métrica compute.googleapis.com/instance/uptime. Debes crear y configurar la condición para generar un incidente cuando no haya datos de métricas. No defines la condición mediante el Lenguaje de consulta de Monitoring (MQL)1. No se te notifica cuando la máquina virtual (VM) se reinicia o se apaga.

Esta política de alertas solo supervisa las series temporales de las instancias de VM de Compute Engine que tienen el estado RUNNING. Las series temporales de las VM que están en cualquier otro estado, como STOPPED o DELETED, se filtran antes de que se evalúe la condición. Debido a este comportamiento, no puedes usar una política de alertas con una condición de alerta de ausencia de métrica para determinar si una instancia de VM está en ejecución. Para obtener información sobre los estados de las instancias de VM, consulta el Ciclo de vida de la instancia de VM.

A fin de resolver este problema, crea una política de alertas para supervisar una verificación de tiempo de actividad. En el caso de los extremos privados, usa las verificaciones de tiempo de actividad privadas.

Una posible alternativa a las alertas de verificaciones de tiempo de actividad es usar políticas de alertas que supervisen la ausencia de datos. Recomendamos generar alertas sobre las verificaciones de tiempo de actividad en lugar de la ausencia de datos: las alertas de ausencia pueden generar falsos positivos si hay problemas transitorios con la disponibilidad de los datos de Monitoring.

Sin embargo, si no es posible usar verificaciones de tiempo de actividad, puedes crear una política de alertas con MQL que te notifique que la VM se cerró. Las condiciones definidas por MQL no filtran previamente los datos de series temporales en función del estado de la instancia de VM. Debido a que MQL no filtra los datos por estados de la VM, puedes usarlo para detectar la ausencia de datos de las VM que se cerraron.

Considera la siguiente condición de MQL que supervisa la métrica compute.googleapis.com/instance/cpu/utilization:

fetch gce_instance::compute.googleapis.com/instance/cpu/utilization
|absent_for 3m

Si una VM supervisada por esta condición se apaga, luego de tres minutos, se genera un incidente y se envían notificaciones. El valor absent_for debe ser de al menos tres minutos.

Para obtener más información sobre MQL, consulta Políticas de alertas con MQL.

1: MQL es un lenguaje expresivo basado en texto que se puede usar con las llamadas a la API de Cloud Monitoring y en la consola de Google Cloud. Para configurar una condición con MQL cuando usas la consola de Google Cloud, debes usar el editor de código.

La política de recuento de solicitudes no crea las alertas esperadas

Deseas supervisar la cantidad de solicitudes completadas. Creaste una política de alertas que supervisa la métrica serviceruntime.googleapis.com/api/request_count, pero no recibes notificaciones cuando la cantidad de solicitudes supera el límite que configuraste.

El período de alineación máximo para la métrica de recuento de solicitudes es de 7 horas y 30 minutos.

Para resolver este problema, verifica el valor del período de alineación en tu política de alertas. Si el valor es más largo que el máximo para esta métrica, reduce el período de alineación para que no sea de más de 7 horas y 30 minutos.

Causas comunes de incidentes anómalos

Creaste una política de alertas y parece que la política crea incidentes de forma prematura o incorrecta.

Existen diferentes motivos por los que puedes recibir notificaciones de incidentes que parecen ser incorrectos:

  • Si hay un intervalo en los datos, en particular para esas políticas de alertas con condiciones de límite de ausencia de métrica o “inferior a”, se puede crear un incidente que parezca anómalo. Determinar si existe un déficit en los datos podría no ser fácil. En ocasiones, el intervalo está oculto y, a veces, se corrige automáticamente:

    • En los gráficos, por ejemplo, las brechas pueden estar ocultas porque los valores de los datos faltantes se interpolan. Incluso cuando faltan varios minutos de datos, el gráfico conecta los puntos faltantes para mantener una continuidad visual. Este intervalo en los datos subyacentes puede ser suficiente para que una política de alertas cree un incidente.

    • Los puntos de las métricas basadas en registros pueden llegar tarde y reabastecerse, por hasta 10 minutos antes. El comportamiento de reabastecimiento corrige de forma efectiva el intervalo; este se completa cuando los datos finalmente llegan. Por lo tanto, un déficit en una métrica basada en registros que ya no se puede ver podría haber provocado que una política de alertas creara un incidente.

  • Las condiciones de límite de ausencia de la métrica y las de "inferior a" se evalúan en tiempo real, con un pequeño retraso de consulta. El estado de la condición puede cambiar entre el momento en que se evalúa y el momento en que el incidente correspondiente es visible en Monitoring.

  • Las condiciones configuradas para crear un incidente en una sola medida pueden generar incidentes que parezcan ser prematuras o incorrectas. Para evitar esta situación, asegúrate de que se requieran varias mediciones antes de crear un incidente configurando el campo de duración de una condición para que sea más del doble de la tasa de muestreo de la métrica.

    Por ejemplo, si se muestrea una métrica cada 60 segundos, establece la duración en, al menos, 3 minutos. Si configuras el campo de duración en valor más reciente, o equivalente a 0 segundos, una sola medición puede causar la creación de un incidente.

  • Cuando se edita la condición de una política de alertas, el cambio puede tardar varios minutos en propagarse por la infraestructura de alertas. Durante este período, es posible que recibas notificaciones de incidentes que cumplen con las condiciones originales de la política de alertas.

  • Cuando llegan los datos de series temporales, puede tardar hasta un minuto en propagarse por toda la infraestructura de alertas. Cuando el período de alineación se establece en un minuto o en la muestra más reciente, la latencia de propagación puede hacer parecer que la política de alertas se activa de forma incorrecta. Para reducir la posibilidad de esta situación, usa un período de alineación de al menos cinco minutos.

El incidente no se cierra cuando dejan de llegar los datos

Sigue las instrucciones en Datos parciales de la métrica y configura una política de alertas para cerrar los incidentes cuando dejan de llegar los datos. En algunos casos, los datos dejan de llegar, pero un incidente abierto no se cierra automáticamente.

Si el recurso subyacente supervisado por una política de alertas contiene la etiqueta metadata.system_labels.state, y si esa política no está escrita con el lenguaje de consulta de Monitoring, Monitoring puede determinar el estado del recurso. Si se sabe que el estado de un recurso está inhabilitado, Monitoring no cierra los incidentes de forma automática cuando dejan de llegar los datos. Sin embargo, puedes cerrar estos incidentes de forma manual.

La política de varias condiciones crea varias notificaciones

Creaste una política de alertas que contiene varias condiciones y las uniste con un AND lógico. Esperas recibir una notificación y que se cree un incidente cuando se cumplan todas las condiciones. Sin embargo, recibirás varias notificaciones y verás que se crean varios incidentes.

Cuando una política de alertas contiene varias condiciones unidas por una AND lógica, si esa política se activa, entonces, para cada serie temporal que da como resultado que se cumpla una condición, la política envía una notificación y crea un incidente. Por ejemplo, si tienes una política con dos condiciones y cada condición supervisa una serie temporal, se abren dos incidentes y recibes dos notificaciones.

No puedes configurar Cloud Monitoring para crear un solo incidente y enviar una sola notificación.

Para obtener más información, consulta Notificaciones por incidente.

No se pueden ver los detalles del incidente debido a un error de permiso

Navega a la página de incidentes en Google Cloud Console y selecciona un incidente para ver. Esperas que se abra la página de detalles. Sin embargo, no se abre la página de detalles y se muestra el mensaje "Permiso denegado".

Para ver todos los detalles del incidente, excepto los datos de métricas, asegúrate de tener las funciones de Identity and Access Management (IAM) de Visualizador de incidentes de Cloud Console de Monitoring (roles/monitoring.cloudConsoleIncidentViewer) y Visualizador de cuentas de Stackdriver (roles/stackdriver.accounts.viewer).

Para ver todos los detalles de los incidentes, incluidos los datos de las métricas, y poder confirmar o cerrar los incidentes, asegúrate de tener las funciones de IAM de visualizador de Monitoring (roles/monitoring.viewer) y editor de incidentes de Cloud Console de Monitoring (roles/monitoring.cloudConsoleIncidentEditor).

Los roles personalizados no pueden otorgar el permiso necesario para ver los detalles de los incidentes.

El incidente no se crea cuando se cumple la condición

Creaste una política de alertas que tiene una condición. El gráfico de alertas muestra que los datos supervisados infringen la condición, pero no recibiste una notificación y no se creó un incidente.

Si alguno de los siguientes criterios se aplica después de que se activa la condición de la política de alertas, Cloud Monitoring no abrirá el incidente.

  • La política de alertas está pospuesta.
  • La política de alertas está inhabilitada.
  • La política de alertas alcanzó la cantidad máxima de incidentes que puede abrir de forma simultánea.
  • Se sabe que el estado del recurso que supervisa la política de alertas está inhabilitado. Monitoring puede determinar el estado de un recurso cuando este contiene la etiqueta metadata.system_labels.state y cuando la política de alertas no está escrita con el lenguaje de consulta de Monitoring.

Los detalles del incidente muestran un proyecto incorrecto

Recibirás una notificación de una alerta y el resumen de la condición mostrará el proyecto de Google Cloud en el que se creó la alerta, es decir, el proyecto de permisos. Sin embargo, esperas que el incidente indique el nombre del proyecto de Google Cloud que almacena la serie temporal que causa el incidente.

Las opciones de agregación especificadas en la condición de una política de alertas determinan el proyecto de Google Cloud al que se hace referencia en una notificación:

  • Cuando las opciones de agregación eliminan la etiqueta que almacena el ID del proyecto, la información del incidente muestra el proyecto de permisos. Por ejemplo, si agrupas los datos solo por zona, se quitará la etiqueta que almacena el ID del proyecto después de la agrupación.

  • Cuando las opciones de agregación conservan la etiqueta que almacena el ID del proyecto, las notificaciones de incidentes incluyen el nombre del proyecto de Google Cloud que almacena la serie temporal que causa el incidente. Para conservar la etiqueta del ID del proyecto, no agrupes las series temporales ni incluyas la etiqueta project_id en el campo de agrupación.

No se puede cerrar un incidente de forma manual

Recibiste una notificación de un incidente en tu sistema. Ve a la página de detalles del incidente y haz clic en Cerrar incidente. Esperas que se cierre el incidente; sin embargo, recibirás el siguiente mensaje de error:

Unable to close incident with active conditions.

Solo puedes cerrar un incidente cuando no llegaron observaciones en el período de alerta más reciente. El período de alerta, que suele tener un valor predeterminado de 5 minutos, se define como parte de la condición de la política de alertas y se puede configurar. El mensaje de error anterior indica que se recibieron datos dentro del período de alerta.

El siguiente error se produce cuando un incidente no se puede cerrar debido a un error interno:

Unable to close incident. Please try again in a few minutes.

Cuando veas el mensaje de error anterior, puedes volver a intentar la operación de cierre o permitir que Monitoring cierre automáticamente el incidente.

Para obtener más información, consulta Administra incidentes.

No se reciben las notificaciones

Si configuras los canales de notificación y esperas recibir notificaciones cuando se produzcan incidentes. No recibirás ninguna notificación.

Para obtener información sobre cómo resolver problemas con las notificaciones de webhook y Pub/Sub, consulta las siguientes secciones de este documento:

Para recopilar información sobre la causa de la falla, haz lo siguiente:

  1. En el panel de navegación de la consola de Google Cloud, selecciona Logging y, luego, Explorador de registros:

    Ir al Explorador de registros

  2. Selecciona el proyecto de Google Cloud adecuado.
  3. Consulta los registros para ver los eventos del canal de notificaciones:

    1. Expande el menú Nombre del registro y selecciona notification_channel_events.
    2. Expande el menú Gravedad y selecciona Error.
    3. Opcional: Para seleccionar un intervalo de tiempo personalizado, usa el selector de intervalo de tiempo.
    4. Haz clic en Ejecutar consulta.

    Con los pasos anteriores, se crea la siguiente consulta:

    logName="projects/PROJECT_ID/logs/monitoring.googleapis.com%2Fnotification_channel_events"
    severity=ERROR
    

    Por lo general, la información de fallas se incluye en la línea de resumen y en el campo jsonPayload.

    La línea de resumen y el campo jsonPayload suelen contener información sobre fallas. Por ejemplo, cuando se produce un error de puerta de enlace, la línea de resumen incluye el error “Falló con 502 Bad Gateway”.

No hay datos nuevos después de cambiar las definiciones de las métricas

Cambias la definición de una métrica definida por el usuario, por ejemplo, si modificas el filtro que usaste en una métrica basada en registros, y la política de alertas no refleja el cambio que hiciste en la definición de la métrica.

Para resolver este problema, edita el nombre visible de la política de alertas para que se actualice.

No se reciben las notificaciones de webhook que se envían a Google Chat

Configura un canal de notificaciones de webhook en Cloud Monitoring y, luego, configura el webhook para que se envíe a Google Chat. Sin embargo, no recibes notificaciones o recibes errores 400 Bad Request.

Para resolver este problema, configura un canal de notificaciones de Pub/Sub en Cloud Monitoring y, luego, configura un servicio de Cloud Run para convertir los mensajes de Pub/Sub en el formato que espera Chat y, luego, envía la notificación a Google Chat. Para ver un ejemplo de esta configuración, consulta Crea notificaciones personalizadas con Cloud Monitoring y Cloud Run.

No se reciben las notificaciones de webhook

Configuras un canal de notificaciones de webhook y esperas recibir notificaciones cuando se produzcan incidentes. No recibirás ninguna notificación.

Extremo privado

No puedes usar webhooks para notificaciones, a menos que el extremo sea público.

Para resolver esta situación, usa las notificaciones de Pub/Sub combinadas con una suscripción de extracción a ese tema de notificación.

Cuando configuras un canal de notificaciones de Pub/Sub, las notificaciones de incidentes se envían a una cola de Pub/Sub que tiene controles de Identity and Access Management. Cualquier servicio que pueda consultar o escuchar un tema de Pub/Sub puede consumir estas notificaciones. Por ejemplo, las aplicaciones que se ejecutan en máquinas virtuales de App Engine, Cloud Run o Compute Engine pueden consumir estas notificaciones.

Si usas una suscripción de extracción, se envía una solicitud a Google que espera a que llegue un mensaje. Estas suscripciones requieren acceso a Google, pero no requieren reglas de firewall ni de acceso entrante.

Extremo público

Para identificar el motivo del error en la entrega, examina las entradas de registro de Cloud Logging en busca de información de la falla.

Por ejemplo, puedes buscar entradas de registro para el recurso del canal de notificaciones mediante el Explorador de registros, con un filtro como el siguiente:

resource.type="stackdriver_notification_channel"

No se reciben las notificaciones de Pub/Sub

Configuras un canal de notificaciones de Pub/Sub, pero no recibes ninguna notificación de alerta.

Para resolver esta condición, prueba lo siguiente:

  • Asegúrate de que la cuenta de servicio de notificaciones exista. No se envían notificaciones cuando se borra la cuenta de servicio.

    Para verificar que la cuenta de servicio exista, haz lo siguiente:

    1. En el panel de navegación de la consola de Google Cloud, selecciona IAM:

      Ir a IAM

    2. Busca una cuenta de servicio que tenga la siguiente convención de nombres:

      service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com

      Si esta cuenta de servicio no aparece en la lista, selecciona Incluir asignaciones de funciones proporcionadas por Google, como se muestra en la siguiente captura de pantalla:

      Selecciona la opción Incluir asignaciones de roles proporcionadas por Google.

    Para crear una cuenta de servicio de notificaciones, haz lo siguiente:

    1. En el panel de navegación de la consola de Google Cloud, selecciona Monitoring y, luego,  Alertas:

      Ir a Alertas

    2. Haz clic en Editar canales de notificaciones.
    3. En la sección Pub/Sub, haz clic en Agregar nuevo.

      En el cuadro de diálogo Created Pub/Sub Channel, se muestra el nombre de la cuenta de servicio que creó Monitoring.

    4. Haz clic en Cancelar.

    5. Otorga permisos a la cuenta de servicio para publicar tus temas de Pub/Sub como se describe en Autoriza la cuenta de servicio.

  • Asegúrate de que la cuenta de servicio de notificaciones esté autorizada para enviar notificaciones sobre los temas de Pub/Sub de interés.

    Para ver los permisos de una cuenta de servicio, puedes usar la consola de Google Cloud o el comando de Google Cloud CLI:

    • En la página IAM de la consola de Google Cloud, se enumeran las funciones para cada cuenta de servicio.
    • En la página Temas de Pub/Sub en la consola de Google Cloud, se muestra cada tema. Cuando seleccionas un tema, en la pestaña Permisos, se enumeran las funciones otorgadas a las cuentas de servicio.
    • Para enumerar todas las cuentas de servicio y sus funciones, ejecuta el siguiente comando de Google Cloud CLI:

      gcloud projects get-iam-policy PROJECT_ID
      

      La siguiente es una respuesta parcial para este comando:

          serviceAccount:service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
             role: roles/monitoring.notificationServiceAgent
           - members:
             [...]
             role: roles/owner
           - members:
             - serviceAccount:service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
             role: roles/pubsub.publisher
      

      La respuesta del comando solo incluye funciones, no incluye la autorización por tema.

    • A fin de enumerar las vinculaciones de IAM para un tema específico, ejecuta el siguiente comando:

      gcloud pubsub topics get-iam-policy TOPIC
      

      La siguiente es una respuesta de ejemplo para este comando:

          bindings:
          - members:
            - serviceAccount:service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
            role: roles/pubsub.publisher
          etag: BwXPRb5WDPI=
          version: 1
      

    Para obtener información sobre cómo autorizar la cuenta de servicio de notificaciones, consulta Autoriza la cuenta de servicio.