Descripción general de las exportaciones de datos de seguimiento

En esta página, se proporciona una descripción general conceptual de la exportación de datos de seguimiento con Cloud Trace. Te recomendamos que exportes datos de seguimiento por los siguientes motivos:

  • Para almacenar datos de seguimiento durante un período más largo que el período de retención predeterminado de 30 días.
  • Te permiten usar las herramientas de BigQuery para analizar tus datos de seguimiento. Por ejemplo, con BigQuery, puedes identificar recuentos de intervalo y cuantiles. Si deseas obtener información sobre la consulta usada para generar los consulta la consulta de HipsterShop.

    Muestra la respuesta a la búsqueda anterior.

Cómo funcionan las exportaciones

La exportación implica crear un receptor para un proyecto de Google Cloud. Un receptor define un conjunto de datos de BigQuery como destino.

Puedes crear un receptor con la API de Cloud Trace o con la CLI de Google Cloud.

Propiedades y terminologías de los receptores

Los receptores se definen para un proyecto de Google Cloud y tienen las siguientes propiedades:

  • Nombre: un nombre para el receptor. Por ejemplo, el siguiente podría ser un nombre:

    "projects/PROJECT_NUMBER/traceSinks/my-sink"
    

    En el ejemplo anterior, PROJECT_NUMBER es el número del proyecto de Google Cloud del receptor y my-sink es el identificador del receptor.

  • Recurso superior: el recurso en el que se crea el receptor. El recurso superior debe ser un proyecto de Google Cloud:

    "projects/PROJECT_ID"
    

    PROJECT_ID puede ser un número o un identificador de proyecto de Google Cloud.

  • Destino: Un único lugar para enviar intervalos de seguimiento. Trace admite la exportación de seguimientos a BigQuery. El destino puede ser el proyecto de Google Cloud del receptor o cualquier otro proyecto de Google Cloud que esté en la misma organización.

    Por ejemplo, el siguiente es un destino válido:

    bigquery.googleapis.com/projects/DESTINATION_PROJECT_NUMBER/datasets/DATASET_ID
    

    En el ejemplo anterior, DESTINATION_PROJECT_NUMBER es el número del proyecto de Google Cloud del destino y DATASET_ID es el identificador del conjunto de datos de BigQuery.

  • Identidad del escritor: un nombre de cuenta de servicio. El propietario del destino de exportación debe darle permisos a esta cuenta de servicio para escribir en el destino de exportación. Cuando se exportan seguimientos, Trace adopta esta identidad para la autorización. Para mayor seguridad, los receptores nuevos obtienen una cuenta de servicio única:

    export-PROJECT_NUMBER-GENERATED_VALUE@gcp-sa-cloud-trace.iam.gserviceaccount.com
    

    En el ejemplo anterior, PROJECT_NUMBER es el número de tu proyecto de Google Cloud, en Hex, y GENERATED_VALUE es un valor generado aleatoriamente.

    No creas, posees ni administras la cuenta de servicio que identifica la identidad de escritor de un receptor. Cuando creas un receptor, Trace crea la cuenta de servicio que este requiere. Esta cuenta de servicio no se incluye en la lista de cuentas de servicio de tu proyecto hasta que tenga al menos una vinculación de Identity and Access Management. Agregas esta vinculación cuando configuras un destino de sink.

    Para obtener información sobre el uso de la identidad del escritor, consulta permisos de destino.

Cómo funcionan los receptores

Cada vez que llega un intervalo de seguimiento a un proyecto, Trace exporta una copia del intervalo.

No se pueden exportar los seguimientos que recibió Trace antes de que se creara el receptor.

Control de acceso

Para crear o modificar un receptor, debes tener una de las siguientes opciones de Identity and Access Management roles:

  • Administrador de Trace
  • Usuario de Trace
  • Propietario del proyecto
  • Editor de proyecto

Para obtener más información, consulta Guía de control de acceso.

Para exportar seguimientos a un destino, la cuenta de servicio del escritor del receptor debe tener permisos de escritura en el destino. Para obtener más información sobre las identidades de los escritores, consulta la sección Propiedades de los receptores en esta página.

Cuotas y límites

Cloud Trace usa la API de transmisión de BigQuery para enviar intervalos de seguimiento al destino. Cloud Trace agrupa en lotes las llamadas a la API. Cloud Trace no implementa un mecanismo de reintento o limitación. Intervalos de seguimiento podría no exportarse correctamente si la cantidad de datos supera el cuotas de destino.

Para obtener detalles sobre las cuotas y los límites de BigQuery, consulta Cuotas y límites

Precios

La exportación de seguimientos no genera cargos de Cloud Trace. Sin embargo, es posible generan cargos de BigQuery. Consulta la sección sobre precios de BigQuery para obtener más información.

Estima tus costos

BigQuery cobra por la transferencia y el almacenamiento de datos. Para calcular los costos mensuales de BigQuery, haz lo siguiente:

  1. Estima la cantidad total de intervalos de seguimiento que se transfieren en un mes.

    Para obtener información sobre cómo ver el uso, consulta Visualiza el uso por cuenta de facturación.

  2. Estima los requisitos de transmisión según la cantidad de intervalos de seguimiento transferidos.

    Cada intervalo se escribe en una fila de la tabla. Cada fila en BigQuery requiere al menos 1,024 bytes. Por lo tanto, un límite inferior en el Los requisitos de transmisión de BigQuery son asignar 1,024 bytes a cada intervalo. Por ejemplo, si tu cuenta de Google Cloud proyecto transfirió 200 intervalos, esos intervalos requieren al menos 20,400 bytes para la inserción de transmisión

  3. Usa la calculadora de precios para estimar los costos de BigQuery que generan las inserciones de transmisión, el almacenamiento y las consultas.

Visualiza y administra el uso de BigQuery

Puedes usar el Explorador de métricas para ver tu uso de BigQuery. Puedes una política de alertas que te notifique si tu si el uso de datos excede los límites predefinidos. La siguiente tabla contiene los parámetros de configuración para crear una política de alertas. Puedes usar la configuración de la tabla del panel de destino cuando crees un gráfico o uses el Explorador de métricas.

Para crear una política de alertas que se active cuando Las métricas de BigQuery superan un límite definido por el usuario usa la siguiente configuración.

Nueva condición
Campo

Valor
Recurso y métrica En el menú Recursos, selecciona Conjunto de datos de BigQuery.
En el menú Categorías de métricas, selecciona Almacenamiento.
Selecciona una métrica del menú Métricas. Las métricas específicas para el uso incluyen Stored bytes, Uploaded bytes y Uploaded bytes billed. Para obtener una lista completa de las métricas disponibles, consulta Métricas de BigQuery.
Filtro project-id: Es el ID de tu proyecto de Google Cloud.
dataset_id: Es el ID de tu conjunto de datos.
Series temporales
Grupo de series temporales por
dataset_id: Es el ID de tu conjunto de datos.
Series temporales
Agregación de series temporales
sum
Ventana progresiva 1 m
Función analítica progresiva mean
Configura el activador de alertas
Campo

Valor
Tipo de condición Threshold
Activador de alertas Any time series violates
Posición del umbral Above threshold
Valor del umbral Tú determinas el valor aceptable.
Período para volver a probar 1 minute

¿Qué sigue?

Para configurar un receptor, consulta Exporta seguimientos.