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 de tareas y solucionar problemas de rendimiento con las métricas y los registros recopilados.

De forma predeterminada, Cloud Tasks envía métricas del sistema y de recursos a Cloud Monitoring y exporta registros de auditoría de 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, ya que estos registros de auditoría pueden ser bastante extensos.

Para obtener más información, consulta Registros 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 intentos:
    • AttemptDispatch
    • AttemptResponse

Habilitar registro

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

Console

  1. En la Google Cloud consola, ve a la página de 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 gcloud tasks queues create o el gcloud tasks queues update comando.

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: Es el ID de tu cola.
  • 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 en 0.0 (este es el valor predeterminado).

Inhabilita el registro

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

Console

  1. En la Google Cloud consola, ve a la página de 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, haz clic en Inhabilitar.

    captura de pantalla

gcloud

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

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

Reemplaza QUEUE_ID por el ID de tu cola.

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 en Visualiza registros con el Explorador de registros.
  • El Análisis de observabilidad está diseñado para ejecutar consultas para analizar tus registros y, luego, ver o graficar los resultados. Para obtener información sobre cómo usar las Estadísticas de observabilidad, sigue las instrucciones en Consulta y analiza registros con Estadísticas 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 Descripción general de consultas y registros.

Envía métricas a Monitoring

Cloud Tasks envía datos de métricas de 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 con 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 		Recuento 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: El método de la 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 		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 14 de octubre de 2026 a las 20:24:33 UTC.

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

Lee datos de métricas

Puedes leer 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, incluido el uso de una biblioteca cliente específica del lenguaje o la creación de 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 Recupera 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.