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, puede 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, debe 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.

  • Elemento 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 traza. 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 sumideros