Información general sobre las exportaciones de datos de Trace

En esta página se ofrece información conceptual sobre la exportación de datos de trazas con Cloud Trace. Puede que quiera exportar datos de seguimiento por los siguientes motivos:

  • Para almacenar datos de seguimiento durante un periodo superior al periodo de conservación predeterminado de 30 días.
  • Para que puedas usar las herramientas de BigQuery y analizar tus datos de traza. Por ejemplo, con BigQuery, puedes identificar recuentos de intervalos y cuantiles. Para obtener información sobre la consulta utilizada para generar la siguiente tabla, consulta Consulta de HipsterShop.

    Muestra la respuesta a la consulta anterior.

Cómo funcionan las exportaciones

Para exportar datos, debes crear un receptor para un Google Cloud proyecto. Un sumidero define un conjunto de datos de BigQuery como destino.

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

Propiedades y terminología de los receptores

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

  • Nombre: nombre del receptor. Por ejemplo, un nombre podría ser:

    "projects/PROJECT_NUMBER/traceSinks/my-sink"
    

    donde PROJECT_NUMBER es el Google Cloud número de proyecto del receptor y my-sink es el identificador del receptor.

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

    "projects/PROJECT_ID"
    

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

  • Destino: un único lugar al que enviar los intervalos de seguimiento. Trace permite exportar trazas a BigQuery. El destino puede ser el proyecto del receptor o cualquier otro proyecto de la misma organización. Google Cloud Google Cloud

    Por ejemplo, un destino válido es:

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

    donde DESTINATION_PROJECT_NUMBER es el Google Cloud número de proyecto del destino y DATASET_ID es el identificador del conjunto de datos de BigQuery.

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

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

    donde PROJECT_NUMBER es el número de tu proyecto Google Cloud en hexadecimal y GENERATED_VALUE es un valor generado aleatoriamente.

    No creas, posees ni gestionas la cuenta de servicio identificada por la identidad de escritura de un sumidero. Cuando creas un receptor, Trace crea la cuenta de servicio que necesita el receptor. Esta cuenta de servicio no se incluirá en la lista de cuentas de servicio de tu proyecto hasta que tenga al menos un enlace de gestión de identidades y accesos. Añade este enlace cuando configures un destino de receptor.

    Para obtener información sobre cómo usar la identidad del escritor, consulta los permisos de destino.

Cómo funcionan los receptores

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

Las trazas que Trace haya recibido antes de que se creara el receptor no se pueden exportar.

Control de acceso

Para crear o modificar un receptor, debes tener uno de los siguientes roles de Gestión de Identidades y Accesos:

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

Para obtener más información, consulta Control de acceso.

Para exportar trazas a un destino, la cuenta de servicio de escritura del sumidero debe tener permiso para escribir en el destino. Para obtener más información sobre las identidades de escritura, consulta la sección Propiedades de sink de esta página.

Cuotas y límites

Cloud Trace utiliza la API de streaming de BigQuery para enviar intervalos de traza al destino. Cloud Trace agrupa las llamadas a la API. Cloud Trace no implementa ningún mecanismo de reintento ni de limitación. Es posible que los intervalos de traza no se exporten correctamente si la cantidad de datos supera las cuotas de destino.

Para obtener más información sobre las cuotas y los límites de BigQuery, consulta Cuotas y límites.

Precios

La exportación de trazas no genera cargos de Cloud Trace. Sin embargo, es posible que se apliquen cargos de BigQuery. Consulta los precios de BigQuery para obtener más información.

Calcular los costes

BigQuery cobra por la ingesta y el almacenamiento de datos. Para calcular tus costes mensuales de BigQuery, haz lo siguiente:

  1. Estima el número total de intervalos de traza que se ingieren en un mes.

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

  2. Estima los requisitos de streaming en función del número de intervalos de traza ingeridos.

    Cada intervalo se escribe en una fila de la tabla. Cada fila de BigQuery requiere al menos 1024 bytes. Por lo tanto, el límite inferior de tus requisitos de streaming de BigQuery es asignar 1024 bytes a cada intervalo. Por ejemplo, si tu Google Cloud proyecto ha ingerido 200 intervalos, estos requieren al menos 20.400 bytes para la inserción de streaming.

  3. Usa la calculadora de precios para estimar los costes de BigQuery derivados del almacenamiento, las inserciones en tiempo real y las consultas.

Ver y gestionar 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 incluyen los ajustes para crear una política de alertas. Puede usar los ajustes de la tabla del panel de segmentación al crear un gráfico o al usar el explorador de métricas.

Para crear una política de alertas que se active cuando las métricas de BigQuery ingeridas superen el nivel que has definido, sigue los pasos que se indican más abajo.

Campo Nueva condición

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.
Seleccione una métrica en el menú Métricas. Entre las métricas específicas del uso se incluyen Stored bytes, Uploaded bytes y Uploaded bytes billed. Para ver una lista completa de las métricas disponibles, consulte Métricas de BigQuery.
Filtro project_id el ID de tu proyecto Google Cloud .
dataset_id: el ID de tu conjunto de datos.
En series temporales
Agrupación por serie temporal
dataset_id el ID de tu conjunto de datos.
Entre series temporales
Agregación de series temporales
sum
Ventana de tiempo 1 m
Función de ventana móvil mean
Configurar el activador de alertas
Campo

Valor
Tipo de condición Threshold
Activador de alerta Any time series violates
Posición del umbral Above threshold
Valor de umbral Tú eliges el valor aceptable.
Ventana de repetición de la prueba 1 minute

Siguientes pasos

Para configurar un receptor, consulta Exportar trazas.