Descripción general del almacenamiento de registros

En este documento, se describe el modelo de almacenamiento de los datos de Cloud Trace. Se introducen los buckets, las vistas y los vínculos de observabilidad. 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 tramos individuales. Para obtener más información, consulta Esquema de Trace.

Modelo de almacenamiento de observabilidad

El modelo de almacenamiento de la API de Observability 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 servicio de Google Cloud usa la API de Observability para almacenar sus datos, el sistema crea un bucket de observabilidad basado en el nombre del servicio. Por ejemplo, para el servicio de Cloud Trace, el bucket creado por el sistema se llama _Trace. Para obtener información sobre la estructura de un bucket de observabilidad, consulta Bucket.
Conjuntos de datos
Un conjunto de datos es una entidad de almacenamiento. Cada conjunto de datos es secundario de un bucket de observabilidad. Cuando el sistema crea un bucket de observabilidad para un servicio Google Cloud , también crea un conjunto de datos. Por ejemplo, después de que el sistema crea el bucket _Trace, crea el conjunto de datos llamado Spans. Ese conjunto de datos almacena tus datos de seguimiento. Para obtener información sobre la estructura de un conjunto de datos, consulta Dataset.
Vistas de los 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. Cuando se crea un conjunto de datos, el sistema crea automáticamente una vista. 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 usen 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 los 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 llamado _Trace una sola vez cuando el bucket no existe y se cumple alguna de las siguientes condiciones:

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

  • Habilitas Cloud Trace para un servicio Google Cloud y, luego, ese servicio envía datos de seguimiento a tu proyecto Google Cloud . Por ejemplo, Cloud Service Mesh admite la recopilación de registros de seguimiento, pero esta función está inhabilitada de forma predeterminada. Si habilitas el registro de 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 tramos de estos servicios solo se almacenan cuando existe el bucket de observabilidad.

Para determinar si existe el bucket de observabilidad llamado _Trace o activar un flujo que cree este bucket, haz lo siguiente:

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

    Ve al Explorador de seguimiento

    También puedes usar la barra de búsqueda para encontrar esta página.

  2. Realiza una de las siguientes acciones:

    • Si la página muestra datos de seguimiento, no es necesario que realices ninguna acción. Tu proyectoGoogle Cloud contiene un bucket de observabilidad llamado _Trace.

    • Si la página muestra el siguiente banner, significa que tu proyecto no tiene datos de seguimiento o solo tiene datos de Cloud Run Functions, Cloud Run y App Engine.

      Trace storage is not initialized for this project. Enable trace storage to begin collecting trace data.

      Si deseas activar un flujo que cree un bucket de observabilidad llamado _Trace, ve al banner y haz clic en Habilitar.

    • Si la página muestra el siguiente banner, significa que falló la inicialización del bucket de observabilidad llamado _Trace. Si ves este mensaje, ve al banner y haz clic en Presenta un ticket.

      Initializing trace storage has failed for an unexpected reason. Please file a support ticket for assistance.

Limitaciones

No puedes hacer lo siguiente:

  • Modificar o borrar buckets de observabilidad
  • Crear, borrar o modificar conjuntos de datos
  • Crear, borrar o modificar vistas
  • Usa la consola de Google Cloud para enumerar buckets, conjuntos de datos, vistas o vínculos.
  • Crea buckets de observabilidad en ubicaciones que no sean us. Un bucket de observabilidad debe estar en la ubicación us.

¿Qué sigue?