Descripción general del almacenamiento de registros

En este documento, se describe el modelo de almacenamiento de los datos de Cloud Trace. Se presentan los buckets de observabilidad, las vistas de observabilidad y los vínculos. Si creas un vínculo, puedes consultar tus datos de seguimiento desde BigQuery.

En este documento, no se describe el esquema, que especifica cómo se almacenan los intervalos individuales. Para obtener más información, consulta Esquema de Trace.

Modelo de almacenamiento de observabilidad

El modelo de almacenamiento de la API de Observabilidad se basa en la siguiente arquitectura:

Buckets de observabilidad
Un bucket de observabilidad es la entidad de administración de los conjuntos de datos, que almacenan datos. Un bucket de observabilidad se encuentra en una ubicación específica y tiene una política de retención de datos. Cuando un Google Cloud servicio usa la API de Observabilidad para almacenar sus datos, el sistema crea un bucket de observabilidad basado en el nombre del servicio, un conjunto de datos para almacenar datos y una vista para proporcionar acceso de lectura a los datos almacenados. Por ejemplo, para el servicio de Cloud Trace, el sistema nombra el bucket creado por el sistema como _Trace, el conjunto de datos como Spans y la vista _AllSpans. Para obtener información sobre la estructura de un bucket de observabilidad, consulta Bucket.
Conjuntos de datos
Un conjunto de datos almacena datos. El sistema crea automáticamente un conjunto de datos cuando lo crea un bucket de observabilidad, que administra el conjunto de datos. Por ejemplo, cuando el sistema crea el bucket _Trace, también crea un conjunto de datos llamado Spans, que almacena tus datos de seguimiento. Para obtener información sobre la estructura de un conjunto de datos, consulta Dataset.
Vistas de conjuntos de datos
Cada conjunto de datos aloja una o más vistas. Una vista proporciona acceso de lectura a un subconjunto de entradas del conjunto de datos. El sistema crea una vista cuando lo crea un conjunto de datos. Esa vista incluye todos los datos del conjunto de datos. El nombre de la vista depende del servicio. Por ejemplo, para el servicio de Cloud Trace, el sistema crea una vista llamada _AllSpans en el conjunto de datos Spans. Para obtener información sobre la estructura de una vista, consulta View.
Vínculos en conjuntos de datos

Cada conjunto de datos puede contener como máximo un vínculo. Cuando creas un vínculo para un conjunto de datos, el sistema crea un conjunto de datos vinculado de BigQuery. Luego, puedes consultar los datos de tu conjunto de datos con BigQuery o con otros servicios que usan la API de BigQuery. Para obtener información sobre la estructura de un vínculo, consulta Link.

El sistema no crea vínculos automáticamente en los conjuntos de datos.

Configuración de almacenamiento para datos de seguimiento

Tus datos de seguimiento se almacenan en un bucket de observabilidad llamado _Trace. El sistema crea un conjunto de datos llamado Spans en este bucket. En ese conjunto de datos, el sistema crea una vista llamada _AllSpans. Esta vista incluye todos los datos del conjunto de datos.

El sistema intenta crear el bucket de observabilidad llamado _Trace cuando el bucket no existe y se cumple alguna de las siguientes condiciones:

  • Una aplicación envía datos de seguimiento a tu Google Cloud proyecto con la API de Cloud Trace o la API de Telemetry.

  • Habilitas Cloud Trace para un Google Cloud servicio y, luego, ese servicio envía datos de seguimiento a tu Google Cloud proyecto. Por ejemplo, Cloud Service Mesh admite la recopilación de seguimientos; sin embargo, la recopilación de seguimientos está inhabilitada de forma predeterminada. Si habilitas el seguimiento para Cloud Service Mesh, los datos que envía ese servicio hacen que el sistema cree el bucket.

    Los datos de seguimiento generados por las funciones de Cloud Run, Cloud Run y App Engine no hacen que el sistema cree el bucket de observabilidad. Los intervalos de estos servicios se almacenan solo cuando existe el bucket de observabilidad.

Si puedes ver los datos de seguimiento con la página Explorador de seguimiento, entonces existe tu bucket de observabilidad llamado _Trace. Si no ves ningún dato o si ves un banner que indica que el almacenamiento no está inicializado, prueba una de las siguientes opciones:

Residencia de datos para buckets de observabilidad

Si tienes requisitos normativos o de cumplimiento para almacenar tus datos en ubicaciones específicas o usar CMEK, te recomendamos que configures los parámetros de configuración predeterminados para los buckets de observabilidad:

  • Para organizaciones, carpetas y proyectos, la configuración predeterminada de los buckets de observabilidad te permite configurar lo siguiente:

    • Una ubicación de almacenamiento predeterminada
    • Para cada ubicación, una clave predeterminada de Cloud Key Management Service

    Los descendientes en la jerarquía de recursos usan automáticamente estos parámetros de configuración, excepto aquellos en los que configuraste parámetros de configuración predeterminados.

    La configuración predeterminada de los buckets de observabilidad se aplica solo a los recursos nuevos, no a los existentes. Para obtener más información, consulta Establece valores predeterminados para los buckets de observabilidad.

La configuración predeterminada de los buckets de observabilidad no se aplica a los buckets de registros, que almacenan datos de registros. Para obtener información sobre cómo establecer la ubicación predeterminada o requerir CMEK para los buckets de registros, consulta Configura los parámetros de configuración predeterminados de los recursos para Cloud Logging.

Limitaciones

No puedes hacer lo siguiente:

  • Modificar o borrar buckets de observabilidad
  • Crear, borrar o modificar conjuntos de datos
  • Crear, borrar o modificar vistas
  • Usar la Google Cloud consola de para enumerar buckets, conjuntos de datos, vistas o vínculos

¿Qué sigue?