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.
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 ymy-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 yDATASET_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, yGENERATED_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:
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.
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
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.