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

Una alerta es un registro de cuándo se cumple la condición de una política de alertas. Por lo general, Cloud Monitoring abre una alerta y envía una notificación cuando se cumple la condición de la política de alertas. Sin embargo, no se crean alertas en las siguientes circunstancias:

Para cada alerta, Monitoring crea una página de Detalles de la alerta que te permite administrar la alerta y que informa sobre la información de la alerta que puede ayudarte a solucionar el problema. Por ejemplo, en la página Detalles de la alerta, se muestran listas de resúmenes de resultados de consulta en SQL y alertas relacionadas.

En este documento, se describe cómo encontrar tus alertas. También se describe cómo puedes usar la página Detalles de la alerta para administrar alertas de políticas de alertas basadas en SQL, que evalúan los resultados de una consulta en SQL que se ejecuta en los datos de grupos de entradas de registro.

Esta función solo es compatible con 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 Google Cloud consola, la 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, aplazamientos 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 aquellas que están 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 encontrar alertas anteriores

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

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

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

    • Mostrar todas las alertas, incluidas las alertas 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 solo mostrará las alertas que satisfagan 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 del filtro incluyen lo siguiente:

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

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

    Luego, en la tabla Alerts, se mostrará el filtro.

gcloud

Puedes usar gcloud para recibir y enumerar alertas.

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, las etiquetas adjuntas y la política de alertas fuente. La respuesta se verá de la siguiente manera: 
{
  "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, las etiquetas adjuntas y la política de alertas fuente. La respuesta se verá de la siguiente manera: 
{
  "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 tiempo 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 mayor para limitar la cantidad de alertas que se muestran. 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, las etiquetas adjuntas y la política de alertas fuente. La respuesta se verá de la siguiente manera: 
{
  "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, las etiquetas adjuntas y la política de alertas fuente. La respuesta se verá de la siguiente manera: 
{
  "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 día anterior:

--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 del usuario. En este ejemplo, se filtra por una etiqueta del 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 la URL de su 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 Tiempo total de ranuras consumido por día, se muestra la cantidad de tiempo que tus ranuras reservadas de BigQuery dedicaron a ejecutar las consultas en SQL para la política de alertas durante las últimas 24 horas.

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 Estadísticas de observabilidad ejecutó la consulta en SQL de la condición de la política de alertas. De forma predeterminada, la lista se filtra para mostrar solo las búsquedas que coincidieron con la condición de la política de alertas.

  • Para ver la consulta y la tabla de resultados de la consulta desde un momento específico en el que se ejecutó la consulta de Observability Analytics, haz clic en un valor de la columna Tiempo de ejecución de la consulta.
  • Para alternar entre mostrar solo los resultados de las consultas que coincidieron con la condición de la política de alertas y todas las consultas que ejecutó Observability Analytics a partir de 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 Cómo anotar notificaciones con documentación definida por el usuario.

Si no configuraste documentación para tu política de alertas, en el panel Documentación se mostrará el mensaje “No se configuró ninguna documentación”.

Para ayudarte a descubrir los 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 pueden tener uno de los siguientes estados:

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

  •  Confirmado: La alerta está abierta y se marcó de forma manual 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.

Confirmar alertas

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

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.

Cómo 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 crear un aplazamiento para 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 postergación. Después de seleccionar la duración de la función de posponer, esta comenzará de inmediato.

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

Cerrar alertas

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

La supervisión 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 de cierre automático especifica el tiempo que debe transcurrir, sin que se repita la causa de la alerta, antes de que se cierre la alerta. Por este motivo, cuando una alerta está abierta y se repite su causa, la alerta puede permanecer abierta durante 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 deseas 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 provocaron 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?