Administra las alertas para las políticas de alertas basadas en SQL

Las alertas de Cloud Monitoring te permiten hacer un seguimiento de los problemas y, también, investigarlos cuando los resultados de consulta en SQL de las entradas de registro agrupadas cumplen con la condición de una política de alertas basada en SQL. Para cada alerta, Monitoring envía una notificación y crea una página de detalles de la alerta para ayudarte a solucionar el error y administrar el ciclo de vida de la alerta.

En la página Detalles de la alerta, puedes ver resúmenes de los resultados de las consulta en SQL y vínculos a alertas relacionadas. Monitoring no crea una alerta si la política está pospuesta o inhabilitada, o si la cantidad de políticas de alertas o alertas supera los límites de alertas.

Esta función solo se admite para proyectos de Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.

Antes de comenzar

Para obtener los permisos que necesitas para ver y administrar alertas, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Para obtener más información sobre los roles de Cloud Monitoring, consulta Controla el acceso con Identity and Access Management.

Ver alertas

Para ver las alertas en tu proyecto, usa la consola de Google Cloud , gcloud CLI o la API de Monitoring.

Consola de Google Cloud

Para enumerar las alertas de tu proyecto de Google Cloud , haz lo siguiente:

  1. En la consola de Google Cloud , ve a la página Alertas :

    Ir a las Alertas

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

  2. En la barra de herramientas de la consola de Google Cloud , selecciona tu proyecto de Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.

    En la página Alertas, se muestra información sobre tus políticas de alertas, posposiciones y alertas:

    • En el panel Resumen, se muestra la cantidad de alertas abiertas.
    • En la tabla Alertas, se muestran las alertas abiertas más recientes. Para enumerar las alertas más recientes en la tabla, incluidas las cerradas, haz clic en Mostrar alertas cerradas.

  3. Para ver los detalles de una alerta específica, selecciónala en la lista.

    Se abrirá la página Detalles de la alerta. Para obtener más información sobre la página Detalles de la alerta, consulta la sección Investiga una alerta de este documento.

Cómo buscar alertas anteriores

En la tabla Alertas de la página Alertas, se muestran las alertas abiertas más recientes. Para ver las alertas más antiguas, realiza una de las siguientes acciones:

  • Para desplazarte por las entradas de la tabla Alertas, haz clic en  Más recientes o  Más antiguas.

  • Para abrir una página que te permita enumerar y filtrar tus alertas, haz clic en Ver todas las alertas. Se abrirá la página Alertas. En esa página, haz lo siguiente:

    • Muestra todas las alertas, incluidas las cerradas. Para mostrar todas las alertas, haz clic en Mostrar alertas cerradas.
    • Filtrar alertas Para obtener información sobre cómo agregar filtros, consulta Filtra alertas.
    • Confirmar o cerrar una alerta, o posponer su política de alertas Para acceder a estas opciones, haz clic en  Más opciones en la fila de la alerta y selecciona una opción del menú. Para obtener más información, consulta Administra alertas.

Filtrar alertas

Para restringir las alertas que muestra la tabla, agrega filtros. Si agregas varios filtros, la tabla mostrará solo las alertas que cumplan con todos los filtros.

Para filtrar la tabla de alertas, haz lo siguiente:

  1. En la página Alertas, haz clic en  Filtrar tabla y, luego, selecciona una propiedad de filtro. Las propiedades de filtro incluyen las siguientes:

    • Estado de la alerta
    • Nombre de la política de alertas
    • Cuándo se abrió o cerró la alerta

  2. Selecciona un valor del menú secundario o ingresa un valor en la barra de filtros.

    Luego, en la tabla Alertas, se muestra el filtro.

gcloud

Puedes usar gcloud para obtener alertas y enumerarlas.

Recibir alerta

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • ALERT_NAME: Es el nombre del recurso de la alerta. Por ejemplo, projects/my-project/alerts/my-alert-id

Ejecuta el comando gcloud alpha monitoring alerts describe:

Linux, macOS o Cloud Shell

gcloud alpha monitoring alerts describe ALERT_NAME

Windows (PowerShell)

gcloud alpha monitoring alerts describe ALERT_NAME

Windows (cmd.exe)

gcloud alpha monitoring alerts describe ALERT_NAME
 El comando devuelve una respuesta con detalles de la alerta, como el estado de la alerta, las etiquetas adjuntas y la política de alertas de origen. La respuesta es similar a la siguiente: 
{
  "name": "projects/my-project/alerts/my-alert-id",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "resource": {
    "type": "sql_alert"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
}

Enumera las alertas

Puedes enumerar las alertas de tu proyecto y filtrar los resultados con gcloud CLI.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • PROJECT_ID: Es el identificador del proyecto.

Ejecuta el comando gcloud alpha monitoring alerts list:

Linux, macOS o Cloud Shell

gcloud alpha monitoring alerts list

Windows (PowerShell)

gcloud alpha monitoring alerts list

Windows (cmd.exe)

gcloud alpha monitoring alerts list
 El comando devuelve una respuesta con detalles de la alerta, como el estado de la alerta, las etiquetas adjuntas y la política de alertas de origen. La respuesta es similar a la siguiente: 
{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "resource": {
        "type": "sql_alert"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
    }
  ]
}
También puedes usar las siguientes marcas opcionales para filtrar, ordenar o modificar el resultado:

  • --filter: Proporciona una expresión de filtro para filtrar las alertas por hora o por etiqueta. Por ejemplo, filtra por hora con --filter='close_time>="2025-09-10T00:00:00Z"' o por etiqueta con --filter='resource.labels.key="value"'.

  • --sort-by: Es una lista separada por comas de los campos por los que se ordenará el resultado. Por ejemplo: --sort-by=open_time

  • --uri: El comando genera una lista de URIs de recursos en lugar del resultado predeterminado.

  • --limit: Establece esta marca en 2 o un valor superior para limitar la cantidad de alertas que se devuelven. No uses esta marca junto con la marca --filter.

API de Monitoring

Puedes usar la API de Monitoring para obtener y enumerar alertas.

Recibir alerta

Para obtener detalles sobre una sola alerta con la API de Monitoring, usa el método alerts.get.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el identificador del proyecto.
  • ALERT_ID: Es el ID de la alerta.

Método HTTP y URL: 

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts/ALERT_ID

Para enviar tu solicitud, expande una de estas opciones:

El comando devuelve una respuesta con detalles de la alerta, como el estado de la alerta, las etiquetas adjuntas y la política de alertas de origen. La respuesta es similar a la siguiente: 
{
  "name": "projects/my-project/alerts/my-alert-id",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "resource": {
    "type": "sql_alert"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
}

Enumera las alertas

Para enumerar las alertas en tu proyecto y filtrar los resultados con la API de Monitoring, usa el método alerts.list.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el identificador del proyecto.

Método HTTP y URL: 

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts

Para enviar tu solicitud, expande una de estas opciones:

El comando devuelve una respuesta con detalles de la alerta, como el estado de la alerta, las etiquetas adjuntas y la política de alertas de origen. La respuesta es similar a la siguiente: 
{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "resource": {
        "type": "sql_alert"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
    }
  ]
}
Los usuarios de curl pueden agregar la marca --data-urlencode seguida de una expresión de filtro para filtrar las alertas por hora o etiqueta. Consulta los ejemplos siguientes:

Enumera las alertas que se abrieron en la última hora:

--data-urlencode "filter=(open_time>=\"`date -u -d "1 hour ago" +"%Y-%m-%dT%H:%M:%SZ"`\")"

Enumera y filtra las alertas que están abiertas desde el último día:

--data-urlencode "filter=(open_time>=\"`date -u -d "1 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\" AND state=open)"

Enumera y filtra las alertas que se abrieron entre dos períodos:

--data-urlencode "filter=(open_time>=\"`date -u -d "2 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\" AND open_time<=\"`date -u -d "1 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\")"

Enumera y filtra las alertas por etiqueta de usuario. En este ejemplo, se filtra por una etiqueta de usuario con el nombre app y el valor my-gke-app:

--data-urlencode "filter=(policy.user_labels.app=\"my-gke-app\")"
Los usuarios de PowerShell pueden usar el siguiente ejemplo para agregar un filtro basado en el tiempo a su URL de solicitud: 
$baseUrl = "https://monitoring.googleapis.com/v3/projects/my-project/alerts"
$filterValue = (Get-Date).AddHours(-1).ToString("yyyy-MM-ddTHH:mm:ssZ")
$filter = 'open_time >= "' + $filterValue + '"'
$encodedFilter = [System.Uri]::EscapeDataString($filter)
$url = $baseUrl + "?filter=" + $encodedFilter

Investigar una alerta

La página Detalles de la alerta contiene información que puede ayudarte a identificar la causa de una alerta.

Explora los resultados de la consulta

En el panel Información de la consulta, se muestra si las consultas de la política de alertas se ejecutan en ranuras de BigQuery a pedido o en una reserva. En este panel, también se muestran los bytes analizados estimados y el tiempo de ranura consumido por día, según las consultas que se ejecutaron en los últimos siete días.

En el panel Resultados de la consulta en SQL, se muestra una lista de resúmenes de los resultados de la consulta de cada vez que las Estadísticas de observabilidad ejecutaron la consulta en SQL desde la condición de la política de alertas. De forma predeterminada, la lista se filtra para mostrar solo las consultas que coinciden con la condición de la política de alertas.

  • Para ver la consulta y la tabla de resultados de la consulta de un momento específico en el que las Estadísticas de observabilidad ejecutaron la consulta, haz clic en un valor de la columna Hora de ejecución de la consulta.
  • Para alternar entre mostrar solo los resultados de la consulta que coincidieron con la condición de la política de alertas y todas las consultas que las Estadísticas de observabilidad ejecutaron desde la política de alertas, haz clic en Mostrar solo las consultas que coinciden con las condiciones de alerta.

Ver información complementaria

En la sección Documentación, se muestra la plantilla de documentación para las notificaciones que proporcionaste cuando creaste la política de alertas. Esta información puede incluir una descripción de lo que supervisa la política de alertas, así como sugerencias para la mitigación. Para obtener más información, consulta Anota notificaciones con documentación definida por el usuario.

Si no configuraste la documentación para tu política de alertas, en el panel Documentación, se muestra el mensaje "No se configuró ninguna documentación".

Para ayudarte a descubrir problemas subyacentes en tu aplicación, puedes explorar las alertas relacionadas con otras condiciones de la política de alertas.

En la sección Alertas relacionadas, se muestra una lista de otras alertas que se crearon cuando se cumplió la condición de la política de alertas.

Administrar alertas

Las alertas se encuentran en uno de los siguientes estados:

  •  Abierta: Se cumplió la condición de la política de alertas basada en SQL y la alerta sigue abierta. Si se vuelve a cumplir la misma condición y ya hay una alerta abierta, no se abrirá una nueva.

  •  Confirmada: La alerta está abierta y se marcó manualmente como confirmada. Por lo general, este estado indica que se está investigando la alerta.

  •  Cerrada: Cerraste la alerta de forma manual o se cerró automáticamente después de que venció el período de cierre automático.

Confirma alertas

Te recomendamos que marques una alerta como confirmada cuando comiences a investigar su causa.

Para marcar una alerta como confirmada, haz lo siguiente:

  1. En la tabla Alertas de la página Alertas, haz clic en Ver todas las alertas.

  2. En la página Alertas, busca la alerta que deseas confirmar y, luego, realiza una de las siguientes acciones:

    • Haz clic en  Más opciones y, luego, selecciona Confirmar.
    • Abre la página de detalles de la alerta y, luego, haz clic en Confirmar alerta.

Posponer una política de alertas

Para evitar que Monitoring cree alertas y envíe notificaciones durante un período específico, pospón la política de alertas relacionada. Cuando pospones una política de alertas, las alertas relacionadas con ella permanecen abiertas, pero no generan más notificaciones. Las alertas se cierran según la duración del cierre automático de la política de alertas.

Para posponer una alerta que estás viendo, haz lo siguiente:

  1. En la página Detalles de la alerta, haz clic en Posponer política.

  2. Selecciona la duración de la posposición. Después de seleccionar la duración de la posposición, esta comienza de inmediato.

También puedes posponer una política de alertas desde la página Alertas. Para ello, busca la alerta que quieres posponer, haz clic en  Más opciones y, luego, selecciona Posponer. Puedes posponer las políticas de alertas durante las interrupciones para evitar que se envíen más notificaciones durante el proceso de solución de problemas.

Cierra alertas

Puedes permitir que Monitoring cierre una alerta por ti o puedes cerrarla tú.

Monitoring cierra automáticamente una alerta cuando vence la duración de cierre automático de la política de alertas. De forma predeterminada, la duración del cierre automático es de 7 días. La duración mínima del cierre automático es de 30 minutos.

La duración del cierre automático especifica el tiempo que debe transcurrir, sin que se repita la causa de la alerta, antes de que se cierre. Por este motivo, cuando una alerta está abierta y su causa vuelve a ocurrir, la alerta puede permanecer abierta más tiempo que la duración del cierre automático.

Para cerrar una alerta, haz lo siguiente:

  1. En la tabla Alertas de la página Alertas, haz clic en Ver todas las alertas.

  2. En la página Alertas, busca la alerta que quieres cerrar y, luego, realiza una de las siguientes acciones:

    • Haz clic en  Ver más y, luego, selecciona Cerrar alerta.
    • Abre la página Detalles de la alerta de esa alerta y, luego, haz clic en Cerrar alerta.

Si ves el mensaje Unable to close alert, vuelve a intentarlo en unos minutos. No puedes cerrar una alerta nueva de inmediato porque el sistema de alertas sigue considerando que las condiciones que la causaron están activas.

Retención y límites de datos

Para obtener información sobre los límites y el período de retención de las alertas, consulta Límites para las alertas.

¿Qué sigue?