Configurar alertas con consultas programadas

En este documento se describe cómo configurar una alerta mediante una consulta programada de BigQuery. Este enfoque admite casos prácticos personalizados definidos por la lógica de las consultas.

Antes de empezar

Antes de usar Cloud Monitoring, asegúrate de que tienes lo siguiente:

  • Una cuenta de facturación de Cloud.
  • Un proyecto de BigQuery con la facturación habilitada.

Una forma de asegurarte de que tienes ambas es completar la guía de inicio rápido sobre la consola Google Cloud .

Crear una consulta de SQL

Crea y ejecuta una consulta de SQL en BigQuery que genere el resultado de la alerta. La consulta captura la lógica que quieres monitorizar. Para obtener más información, consulta el artículo Ejecutar una consulta.

Configurar una consulta programada

Puede programar consultas para que se ejecuten de forma periódica, desde cada 15 minutos hasta cada varios meses. Puedes escribir cualquier consulta sobre tus cubos de registro. Para obtener más información, consulta el artículo Programar consultas.

Información sobre la métrica de recuento de filas

Las consultas programadas crean automáticamente una métrica en Cloud Monitoring. Esta métrica registra el número de filas que ha devuelto la consulta SQL durante su última evaluación. Puedes crear una política de alertas que monitorice esta métrica de recuento de filas en Monitoring.

La siguiente métrica es un indicador que contiene el recuento de filas más reciente de una consulta programada:

bigquerydatatransfer.googleapis.com/transfer_config/last_execution_job_rows

Todas las consultas programadas escriben su recuento de filas en esta métrica, usando etiquetas diferentes. Necesitas la etiqueta config_id cuando defines una política de alertas. Para encontrar la etiqueta config_id, sigue estos pasos:

  1. En la consola, ve a la página Consultas programadas: Google Cloud

    Ir a Consultas programadas

  2. Haz clic en la consulta programada para la que quieras crear una alerta.

  3. Ve a la pestaña Detalles.

  4. Comprueba la última cadena de Nombre del recurso, como se muestra en la siguiente captura de pantalla:

    config_id en el nombre del recurso.

Si se produce un problema con la consulta programada, aparecerá un mensaje de error en la pestaña Historial de ejecuciones de la consulta programada.

Monitorizar consultas programadas

Monitoriza las consultas programadas para asegurarte de que se ejecutan correctamente:

Crear una política de alertas

Usa una alerta de umbral de métrica para detectar cuándo el número de filas devueltas por la consulta programada difiere de un umbral.

Para configurar una alerta sobre el número de filas que devuelve una consulta programada, sigue estos pasos:

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

    Ve a Alertas.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

  2. Haz clic en Crear política.

  3. Selecciona la métrica de recuento de filas de la consulta programada. En el menú Seleccionar una métrica, haga clic en Configuración de DTS de BigQuery > Transfer_config > Recuento de filas del último trabajo ejecutado.

  4. En Añadir filtros, haz clic en Añadir un filtro.

  5. En el menú Filtro, selecciona config_id.

  6. En el menú Valor, selecciona el config_id de la consulta programada para la que quieras crear una alerta:

    Defina el filtro config_id.

    Si no define ningún filtro, la alerta probará el resultado de todas las consultas programadas. Para encontrar el config_id de tu consulta programada, consulta Información sobre la métrica de recuento de filas.

  7. Mantenga la configuración predeterminada de Transformar datos y haga clic en Siguiente.

  8. En Tipos de condición, selecciona Umbral.

  9. Selecciona la condición que quieras. Por ejemplo, para que se active cuando la consulta devuelva alguna fila, define la siguiente condición:

    1. En Activador de alerta, selecciona Cualquier serie temporal infringe.
    2. En Posición del umbral, selecciona Por encima del umbral.
    3. En Valor de umbral, introduzca 0.

  10. Mantén las Opciones avanzadas predeterminadas y haz clic en Siguiente.

  11. Opcional: Para configurar las notificaciones de tu alerta, haz clic en el interruptor Usar canal de notificación y, a continuación, define los canales y el asunto de las notificaciones. También puedes configurar notificaciones para el cierre de incidentes.

    Si no quieres recibir notificaciones, desactiva el interruptor Usar canal de notificaciones.

  12. Opcional: Si tienes muchas políticas de alertas, puedes anotar etiquetas en ellas para indicar que se derivan de consultas programadas.

  13. Opcional: En el campo Documentación, puedes añadir enlaces que ayuden a interpretar la alerta. Por ejemplo, puedes añadir un enlace a la página Explorador de registros con una consulta similar para explorar los datos que han activado la alerta. También puedes crear un enlace a la página de detalles de una consulta de programación específica.

  14. En Dar nombre a la política de alertas, escribe el nombre de la alerta.

  15. Haz clic enCreate Policy (Crear política).

Limitaciones

Las políticas de alertas de consultas programadas están sujetas a las siguientes limitaciones:

  • La frecuencia de ejecución de las consultas programadas y el retraso de la ingestión influyen en el tiempo total que transcurre desde la emisión del registro hasta la alerta. Por ejemplo, si tu consulta se ejecuta cada 30 minutos y añades un desfase de 15 minutos para el retraso de la ingestión, la alerta se activará aproximadamente 15 minutos después de que se emita una entrada de registro infractora. En algunos casos, puede tardar hasta 45 minutos.
  • La configuración de una consulta programada y una política de alertas no está vinculada ni sincronizada. Si editas la configuración en un sitio, puede que se rompa la relación que permite que funcione la alerta.

Siguientes pasos