Observabilidad en Cloud Tasks

Google Cloud Observability ofrece herramientas de monitorización, registro y diagnóstico. Estas herramientas pueden ayudarte a monitorizar y analizar la actividad y el crecimiento de Cloud Tasks, así como a comprender el comportamiento, el estado y el rendimiento de tus aplicaciones.

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

  • Envía registros de auditoría de datos y del sistema a Cloud Logging. Puedes usar los registros recogidos para depurar, solucionar problemas y obtener información valiosa sobre tus aplicaciones.
  • Envía métricas del sistema y de los recursos a Cloud Monitoring. Puedes usar las métricas recogidas para monitorizar el estado y el rendimiento, identificar tendencias y problemas, y enviar notificaciones sobre los cambios en el comportamiento.

Enviar registros de auditoría a Cloud Logging

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

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

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

Usar Cloud Logging con colas

Puedes usar Cloud Logging con las colas de Cloud Tasks. Se registran las siguientes operaciones:

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

Activar el almacenamiento de registros

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

Consola

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

    Ir a Colas

  2. Haga clic en el nombre de la cola para la que quiera habilitar el registro.

  3. En la página Detalles de la cola, haga 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

Haz los cambios siguientes:

  • 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, asigna el valor 1.0. Para no registrar ninguna operación, defina el valor 0.0 (este es el valor predeterminado).

Inhabilitar el registro

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

Consola

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

    Ir a Colas

  2. Haga clic en el nombre de la cola para la que quiera inhabilitar el registro.

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

  4. Haz clic en el icono de elipsis > 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 asigna el valor 0.0 a la marca log-sampling-ratio.

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

Sustituye QUEUE_ID por el ID de tu cola.

Consultar y ver registros

Puede usar las siguientes herramientas para ver y analizar sus registros:

  • Explorador de registros se ha diseñado para ayudarte a solucionar problemas y analizar el rendimiento de tus servicios y aplicaciones. Para saber cómo ver registros en el Explorador de registros, sigue las instrucciones de Ver registros con el Explorador de registros.
  • Log Analytics se ha diseñado para ejecutar consultas con el fin de analizar los registros y, a continuación, ver o representar los resultados en un gráfico. Para saber cómo usar Analíticas de registros, sigue las instrucciones que se indican en el artículo Consultar y analizar registros con Analíticas de registros.

Para filtrar los registros de Cloud Tasks en Explorador de registros, busca cloudtasks en el campo de búsqueda.

Para obtener más información sobre cómo consultar y analizar registros, consulta el artículo Descripción general de las consultas y las vistas de registros.

Enviar métricas a Cloud Monitoring

Cloud Tasks envía datos de métricas de los recursos monitorizados a Google Cloud Observability. Un recurso monitorizado 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 monitorizados contienen un conjunto único de métricas que se pueden explorar, registrar en un panel o usar para crear alertas.

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

Cada recurso también tiene un conjunto de etiquetas de recurso, 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 cadenas "tipo de métrica" de esta tabla deben tener el prefijo cloudtasks.googleapis.com/. Ese prefijo se ha omitido 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 Fase de lanzamiento (Niveles de jerarquía de recursos)
Nombre visible
Tipo, unidad
Recursos monitorizados		 Descripción
Etiquetas
api/request_count GA  (proyecto)
Solicitudes de API
DELTA, INT64, 1
cloud_tasks_queue 		Número de llamadas a la API Cloud Tasks. Se muestrea cada 60 segundos. Después del muestreo, los datos no podrán verse durante un máximo de 240 segundos.
api_method: Método de la API llamado (por ejemplo, CreateTask).
response_code: Código de respuesta canónico como cadena (por ejemplo, "ok").
queue/depth GA  (proyecto)
Profundidad de la cola
GAUGE, INT64, 1
cloud_tasks_queue 		Número de tareas de la cola. Se muestrea cada 60 segundos. Después del muestreo, los datos no podrán verse durante un máximo de 120 segundos.
queue/task_attempt_count GA  (proyecto)
Número de intentos de tarea
DELTA, INT64, 1
cloud_tasks_queue 		Número de intentos de tareas desglosado por código de respuesta. Se muestrea cada 60 segundos. Después del muestreo, los datos no podrán verse durante un máximo de 180 segundos.
response_code: Código de respuesta canónico como cadena (por ejemplo, "ok").
queue/task_attempt_delays GA  (proyecto)
Retrasos en los intentos de tarea
DELTA, DISTRIBUTION, ms
cloud_tasks_queue 		Retraso entre cada hora programada de intento y la hora real del intento. Se muestrea cada 60 segundos. Después del muestreo, los datos no podrán verse durante un máximo de 120 segundos.

Tabla generada el 2025-08-20 a las 20:46:56 UTC.

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

Leer datos de métricas

Puedes leer datos de métricas, también llamados datos de series temporales, mediante el método timeSeries.list de la API Cloud Monitoring. Hay varias formas de llamar al método, como usar una biblioteca de cliente específica de un 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 el artículo Métricas, series temporales y recursos. Para saber cómo leer los datos de las métricas, consulta Recuperar datos de serie temporal.

Usar paneles de control y alertas de Monitoring

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

Para monitorizar estas métricas en Monitoring, puede crear paneles de control personalizados. También puede añadir alertas basadas en estas métricas.