Observabilidad en Cloud Tasks

Google Cloud Observability te permite supervisar y analizar la actividad de Cloud Tasks, el crecimiento de la cola y el comportamiento de ejecución. Puedes evaluar el estado de la aplicación, diagnosticar fallas en las tareas y solucionar problemas de rendimiento con los registros y las métricas recopilados.

De forma predeterminada, Cloud Tasks envía métricas del sistema y de recursos a Cloud Monitoring, y exporta los registros de auditoría de la actividad del administrador a Cloud Logging. Los registros de auditoría de acceso a los datos están inhabilitados de forma predeterminada y requieren una configuración explícita.

Envía registros de auditoría a Cloud Logging

Cloud Tasks envía los siguientes tipos de datos de registros de auditoría a Cloud Logging:

Los registros de auditoría de acceso a los datos están inhabilitados de forma predeterminada porque pueden ser bastante extensos.

Para obtener más información, consulta Registro de auditoría de Cloud Tasks.

Usa Cloud Logging con colas

Puedes usar Cloud Logging con lista de tareas en cola de Cloud Tasks. Se registran las siguientes operaciones:

  • Operaciones de tareas:
    • CreateTask
    • DeleteTask
  • Operaciones de intento:
    • AttemptDispatch
    • AttemptResponse

Habilitar registro

Puedes habilitar el registro con la consola de Google Cloud o Google Cloud CLI.

Console

  1. En la consola de Google Cloud , ve a la página Cloud Tasks > Colas.

    Ir a Colas

  2. Haz clic en el nombre de la cola para la que deseas habilitar el registro.

  3. En la página Detalles de la cola, haz clic en la pestaña Registros.

  4. Haz clic en Habilitar registros y, para confirmar, haz clic en Habilitar.

    captura de pantalla

gcloud

Para habilitar el registro, puedes usar el comando gcloud tasks queues create o el comando gcloud tasks queues update.

gcloud tasks queues create QUEUE_ID \
    --log-sampling-ratio=LOG_SAMPLING_RATION

o

gcloud tasks queues update QUEUE_ID \
    --log-sampling-ratio=LOG_SAMPLING_RATIO

Reemplaza lo siguiente:

  • QUEUE_ID: ID de tu fila
  • LOG_SAMPLING_RATIO: Es la fracción de las operaciones registradas. Cualquier valor entre 1.0 y 0.0 registra esa fracción de operaciones. Para registrar todas las operaciones, configúralo en 1.0. Para no registrar ninguna operación, configúralo como 0.0 (este es el valor predeterminado).

Inhabilita el registro

Puedes inhabilitar el registro con la consola de Google Cloud o Google Cloud CLI.

Console

  1. En la consola de Google Cloud , ve a la página Cloud Tasks > Colas.

    Ir a Colas

  2. Haz clic en el nombre de la cola para la que deseas inhabilitar el registro.

  3. En la página Detalles de la cola, haz clic en la pestaña Registros.

  4. Haz clic en el ícono de puntos suspensivos > Inhabilitar registros. Para confirmar la acción, haz clic en Inhabilitar.

    captura de pantalla

gcloud

Para inhabilitar el registro, usa el comando gcloud tasks queues update y establece la marca log-sampling-ratio en 0.0.

gcloud tasks queues update QUEUE_ID \
    --log-sampling-ratio=0.0

Reemplaza QUEUE_ID por el ID de tu fila.

Consulta y visualización de registros

Puedes usar las siguientes herramientas para ver y analizar tus registros:

  • El Explorador de registros está diseñado para ayudarte a solucionar problemas y analizar el rendimiento de tus servicios y aplicaciones. Para obtener información sobre cómo ver registros en el Explorador de registros, sigue las instrucciones que se indican en Visualiza registros con el Explorador de registros.
  • Estadísticas de observabilidad está diseñado para ejecutar consultas que analicen tus registros y, luego, ver o graficar los resultados. Si quieres aprender a usar Análisis de observabilidad, sigue las instrucciones que se indican en Consulta y analiza registros con Análisis de observabilidad.

Puedes filtrar los registros de Cloud Tasks en el Explorador de registros buscando cloudtasks en el campo de búsqueda.

Para obtener más información sobre cómo consultar y analizar registros, consulta la Descripción general de consultas y visualización de registros.

Envía métricas a Monitoring

Cloud Tasks envía datos de métricas de los recursos supervisados a Google Cloud Observability. Un recurso supervisado en Monitoring representa una entidad lógica o física, como una máquina virtual, una base de datos o una aplicación. Los recursos supervisados contienen un conjunto único de métricas que se pueden explorar, informar a través de un panel o usar para crear alertas.

Cloud Tasks envía datos de métricas del siguiente recurso supervisado a Google Cloud Observability:

Cada recurso también tiene un conjunto de etiquetas de recursos, que son pares clave-valor que contienen información adicional sobre el recurso. Las etiquetas de recursos están disponibles para todas las métricas asociadas al recurso y se detallan en la siguiente tabla.

Métricas y etiquetas de recursos

Las strings de “tipo de métrica” de esta tabla deben tener el prefijo cloudtasks.googleapis.com/. Este prefijo se omitió en las entradas de la tabla. Cuando consultes una etiqueta, usa el prefijo metric.labels.. Por ejemplo, metric.labels.LABEL="VALUE".

Tipo de métrica Etapa de lanzamiento (niveles de jerarquía de recursos)
Nombre visible
Clase, tipo, unidad
Recursos supervisados		 Descripción
Etiquetas
api/request_count GA  (proyecto)
Solicitudes a la API
DELTA, INT64, 1
cloud_tasks_queue 		Cantidad de llamadas a la API de Cloud Tasks. Se hace un muestreo cada 60 segundos. Luego del muestreo, los datos no son visibles durante un máximo de 240 segundos.
api_method: Es el método de API llamado (p.ej., CreateTask).
response_code: Código de respuesta canónico como cadena (p.ej., "ok").
queue/depth GA  (proyecto)
Profundidad de la cola
GAUGE, INT64, 1
cloud_tasks_queue 		Es la cantidad de tareas en la cola. Se tomaron muestras cada 60 segundos. Luego del muestreo, los datos no son visibles durante un máximo de 120 segundos.
queue/task_attempt_count GA  (proyecto)
Recuento de intentos de tareas
DELTA, INT64, 1
cloud_tasks_queue 		Recuento de intentos de tareas desglosado por código de respuesta. Se hace un muestreo cada 60 segundos. Luego del muestreo, los datos no son visibles durante un máximo de 180 segundos.
response_code: Código de respuesta canónico como cadena (p.ej., "ok").
queue/task_attempt_delays GA  (proyecto)
Demoras en los intentos de tareas
DELTA, DISTRIBUTION, ms
cloud_tasks_queue 		Demora entre cada hora de intento programada y la hora de intento real. Se hace un muestreo cada 60 segundos. Luego del muestreo, los datos no son visibles durante un máximo de 120 segundos.

Tabla generada el 25 de septiembre de 2026 a las 02:24:56 UTC.

Para ver todos los tipos de recursos, consulta Tipos de recursos supervisados. Para ver todos los tipos de métricas, consulta Métricas deGoogle Cloud .

Lee datos de métricas

Puedes leer los datos de métricas, también llamados datos de series temporales, con el método timeSeries.list en la API de Cloud Monitoring. Existen varias formas de llamar al método, como usar una biblioteca cliente específica del lenguaje o crear un gráfico con el Explorador de métricas. Para obtener una introducción a las métricas y las series temporales, consulta Métricas, series temporales y recursos. Para obtener información sobre cómo leer tus datos de métricas, consulta Cómo recuperar datos de series temporales.

Usa los paneles y las alertas de Monitoring

Puedes usar los paneles de Monitoring y sus gráficos asociados para visualizar los datos de las métricas de Cloud Tasks.

Para supervisar estas métricas en Monitoring, puedes crear paneles personalizados. También puedes agregar alertas en función de estas métricas.