Observabilidad en Cloud Tasks

Google Cloud Observability proporciona herramientas de supervisión, registro y diagnóstico. Estas herramientas pueden ayudarte a supervisar y analizar la actividad y el crecimiento de Cloud Tasks, y a comprender el comportamiento, el estado y el rendimiento de tus aplicaciones.

De forma predeterminada, Cloud Tasks está configurado para hacer lo siguiente:

  • Enviar datos y registros de auditoría del sistema a Cloud Logging. Puedes usar los registros recopilados para depurar y solucionar problemas de tus aplicaciones, y obtener estadísticas sobre ellas.
  • Enviar métricas del sistema y de recursos a Cloud Monitoring. Puedes usar las métricas recopiladas para supervisar el estado y el rendimiento, identificar tendencias y problemas, y notificar cambios de comportamiento.

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:

Estos registros están inhabilitados de forma predeterminada, ya que 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
  • Intento de operaciones:
    • 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 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: el ID de tu cola
  • LOG_SAMPLING_RATIO: 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 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 elipsis > 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 el Análisis de observabilidad, sigue las instrucciones en Consulta y analiza registros con el 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 Descripción general de consultas y registros.

Envía métricas a Cloud 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 de 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: El método de API al que se llama (p.ej., CreateTask).
response_code: Código de respuesta canónico en forma de string (p. ej., “ok”)
queue/depth GA  (proyecto)
Profundidad de la cola
GAUGE, INT64, 1
cloud_tasks_queue 		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)
Cantidad de intentos de la tarea
DELTA, INT64, 1
cloud_tasks_queue 		La cantidad de intentos de la tarea, desglosada 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 en forma de string (p. ej., “ok”)
queue/task_attempt_delays GA  (proyecto)
Retrasos en los intentos de la tarea
DELTA, DISTRIBUTION, ms
cloud_tasks_queue 		El retraso entre el momento programado para cada intento y el momento en el que realmente se llevó a cabo 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 2 de abril de 2026 a las 02:29:29 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.