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 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 los 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:

Los registros de auditoría de acceso a los datos 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 listas de tareas en cola

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 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 Listas de aplicaciones en cola

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

  3. En la página Detalles de la fila, 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 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: Es el 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 como 1.0. Para no registrar operaciones, configúralo en 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 Listas de aplicaciones en cola

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

  3. En la página Detalles de la fila, 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 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.
  • Análisis de registros está diseñado para ejecutar consultas que permitan analizar tus registros y, luego, ver o graficar los resultados. Si quieres aprender a usar el Análisis de registros, sigue las instrucciones que se indican en Consulta y analiza registros con el Análisis de registros.

Para filtrar los registros de Cloud Tasks en el 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 Descripción general de consultas y registros.

Envía métricas a Cloud Monitoring

Cloud Tasks envía datos de métricas de los recursos supervisados a Google Cloud Observability. Un recurso supervisado en la supervisión representa una entidad física o lógica, 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 con el 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: El método de API al que se llama (p.ej., CreateTask).
response_code: Código de respuesta canónico en forma de 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)
Cantidad de intentos de la tarea
DELTA, INT64, 1
cloud_tasks_queue 		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 cadena (p. ej., "ok")
queue/task_attempt_delays GA  (proyecto)
Retrasos de intento de la tarea
DELTA, DISTRIBUTION, ms
cloud_tasks_queue 		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 24 de enero de 2025 a las 16:56:52 UTC.

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

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, como usar una biblioteca 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 Métricas, series temporales y recursos. Para aprender a leer los datos de tus 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.