Descripción general de las exportaciones de datos de seguimiento

Precaución: A partir del 18 de febrero de 2026, se inhabilitará la exportación de datos de intervalos a BigQuery mediante receptores de Cloud Trace . Los receptores que se usaban para exportar intervalos a BigQuery se quitarán el 18 de febrero de 2027 o después de esa fecha. Para obtener información sobre cómo ver tus datos de intervalos en BigQuery, consulta Migra a Observability Analytics.

Beta

Este producto o esta función se encuentra sujeto a las "Condiciones de la oferta de la fase previa a la DG" en la sección Condiciones del servicio generales de las Condiciones específicas del servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En esta página, se proporciona una descripción general conceptual de la exportación de datos de seguimiento con Cloud Trace. Recomendamos exportar datos de seguimiento por las siguientes razones:

• Para almacenar datos de seguimiento durante un período más largo que el período de retención predeterminado de 30 días.

• Para permitirte usar las herramientas de BigQuery para analizar tus datos de seguimiento. Por ejemplo, con BigQuery, puedes identificar recuentos de intervalos y cuantiles. Para obtener información sobre la consulta que se usó para generar la siguiente tabla, consulta Consulta de HipsterShop.

  

Nota: Solo los intervalos de seguimiento transferidos a través de la API de Cloud Trace son aptos para la exportación. No se admiten los intervalos de seguimiento emitidos por Google Cloud servicios o transferidos a través de la API de Telemetry.

Cómo funcionan las exportaciones

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

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

Propiedades y terminologías de los receptores

Los receptores se definen para un Google Cloud proyecto 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 del receptor y my-sink es el identificador del receptor. Google Cloud

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

  "projects/PROJECT_ID"
  

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

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

  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 Google Cloud número del proyecto 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 permiso a esta cuenta de servicio para escribir en el destino de exportación. Cuando exportas seguimientos, Trace adopta esta identidad para la autorización. Para mayor seguridad, los receptores nuevos obtienen una cuenta de servicio única:

  [e-mail]
  

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

  No creas, posees ni administras la cuenta de servicio que se identifica con la identidad del escritor de un receptor. Cuando creas un receptor, Trace crea la cuenta de servicio que requiere el receptor. 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 del receptor.

  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 Trace recibió antes de que se creara el receptor.

Control de acceso

Para crear o modificar un receptor, debes tener uno de los siguientes roles de Identity and Access Management:

• 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 utiliza la API de transmisión de BigQuery para enviar intervalos de seguimiento al destino. Cloud Trace procesa por lotes las llamadas a la API. Cloud Trace no implementa un mecanismo de reintento ni de limitación. Es posible que los intervalos de seguimiento no se exporten correctamente si la cantidad de datos supera las 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 que se generen 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 estimar tus 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 en función de la cantidad de intervalos de seguimiento transferidos.

   Cada intervalo se escribe en una fila de la tabla. Cada fila de BigQuery requiere al menos 1,024 bytes. Por lo tanto, un límite inferior para tus requisitos de transmisión de BigQuery es asignar 1,024 bytes a cada intervalo. Por ejemplo, si tu 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. También puedes crear una política de alertas que te notifique si tu uso de BigQuery supera los límites predefinidos. En la siguiente tabla, se incluye la configuración para crear una política de alertas. Puedes acceder a 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 transferidas superen un nivel definido por el usuario, usa la siguiente configuración.

Pasos para crear una política de alertas.

Para crear una política de alertas, sigue estos pasos:

1. En la Google Cloud consola de, ve a la  Alertas página:

   Ir a las Alertas

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

2. Si aún no creas canales de notificaciones y deseas recibir notificaciones, haz clic en Edit Notification Channels y agrega tus canales de notificaciones. Regresa a la página Alertas después de agregar tus canales.
3. En la página Alertas, selecciona Crear política.
4. Para seleccionar el recurso, la métrica y los filtros, expande el menú Seleccionar una métrica y, luego, usa los valores de la tabla Condición nueva:
   1. Opcional: Para limitar el menú a entradas relevantes, ingresa el nombre del recurso o la métrica en la barra de filtros.
   2. Selecciona un tipo de recurso. Por ejemplo, selecciona Instancia de VM.
   3. Selecciona una Categoría de métrica. Por ejemplo, selecciona instancia.
   4. Seleccionar una métrica. Por ejemplo, selecciona Uso de CPU.
   5. Selecciona Apply (Apply).
5. Haz clic en Siguiente y, luego, configura el activador de la política de alertas. Para completar estos campos, usa los valores de la tabla Configurar activador de alertas.
6. Haz clic en Siguiente.

7. Opcional: Para agregar notificaciones a tu política de alertas, haz clic en Canales de notificaciones. En el diálogo, selecciona uno o más canales de notificaciones del menú y, luego, haz clic en Aceptar.

   Si deseas recibir notificaciones cuando se abran y se cierren incidentes, marca Notificar el cierre de incidentes. De forma predeterminada, se envían notificaciones solo cuando los incidentes se abren.

8. Opcional: Actualiza la Duración del cierre automático de incidentes. Este campo determina cuándo Monitoring cierra los incidentes ante la ausencia de datos de métricas.
9. Opcional: Haz clic en Documentación y, luego, agrega la información que deseas incluir en un mensaje de notificación.
10. Haz clic en Nombre de la alerta y, luego, ingresa un nombre para la política de alertas.
11. Haga clic en Crear política.

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 tu Google Cloud ID del proyecto. 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.