Migra a Estadísticas de observabilidad

Si usas receptores de registros de seguimiento para exportar datos de Cloud Trace a BigQuery, migra a Observability Analytics. Los receptores de registros de seguimiento están obsoletos y se quitarán el 18 de febrero de 2027 o después de esa fecha. Observability Analytics te permite consultar tus datos de seguimiento directamente con el mismo lenguaje de consulta SQL que BigQuery sin administrar receptores de exportación.

Si quieres usar los servicios de BigQuery para unir conjuntos de datos, administrar tablas o exportar datos, puedes crear un conjunto de datos vinculado de BigQuery. Puedes crear el conjunto de datos de BigQuery vinculado cuando migres o en una fecha posterior. Para comenzar a usar Observability Analytics, consulta Cómo consultar y analizar registros.

Antes de comenzar

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. Enable the Observability API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  4. Para obtener los permisos que necesitas para cargar la página Observability Analytics, ejecutar consultas y crear un conjunto de datos vinculado de BigQuery, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

    Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

    También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

  5. Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI con el siguiente comando: 

    gcloud init

Migra a Estadísticas de observabilidad

  1. Completa las acciones que se indican en la sección Antes de comenzar de este documento. Entre esas acciones, se incluye la habilitación de la API de Observabilidad.

  2. Verifica que tengas acceso a tus datos de seguimiento con Observability Analytics:

    1. En la Google Cloud consola, ve a la página Estadísticas de observabilidad:

      Ir a Estadísticas de observabilidad

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

    2. En el menú Vistas, ve a la sección Registros y, luego, selecciona _Trace.Spans._AllSpans.

      Se actualiza el panel Esquema y se muestra el esquema.

      Si no ves una vista llamada _Trace.Spans._AllSpans, tu proyecto deGoogle Cloud no contiene un bucket de observabilidad llamado _Trace. Para obtener información sobre cómo resolver esta situación, consulta Falla la inicialización del almacenamiento de registros.

    3. En el panel Esquema, selecciona Consulta.

      Se actualiza el campo del editor de consultas. La cláusula FROM enumera una entrada similar a la siguiente:

      `PROJECT_ID.us._Trace.Spans._AllSpans`

    4. En la barra de herramientas, selecciona Ejecutar consulta.

      Si en la barra de herramientas se muestra Ejecutar en BigQuery, haz clic en Configuración y selecciona Analytics (predeterminado).

    Verificaste que puedes consultar tus datos de seguimiento con la página Observability Analytics.

  3. Opcional: Si deseas unir tus datos de seguimiento con otros datos de la empresa disponibles en BigQuery, crea un conjunto de datos de BigQuery vinculado. Para obtener más información, consulta Cómo consultar un conjunto de datos vinculado de BigQuery.

  4. Borra los receptores de registros y los conjuntos de datos innecesarios:

    1. Para enumerar los receptores de registros existentes, ejecuta el comando gcloud alpha trace sinks list:

      gcloud alpha trace sinks list

    2. Para cada receptor, ejecuta el comando gcloud alpha trace sinks delete:

      gcloud alpha trace sinks delete SINK_NAME

    3. Opcional: Borra los conjuntos de datos de BigQuery innecesarios. Para obtener información sobre cómo borrar un conjunto de datos de BigQuery, consulta Borra conjuntos de datos.

Comparación de esquemas

En esta sección, se proporciona información sobre las diferencias entre los esquemas de Observability Analytics y los de exportación basados en receptores.

Nombre Analytics Heredada
ID de seguimiento trace_id extendedFields.traceId
ID de intervalo span_id span.spanId
ID principal de intervalo parent_span_id span.parentSpanId
Nombre del intervalo name span.displayName.value
Tipo de intervalo kind
Para conocer los valores, consulta OpenTelemetry: SpanKind. 		span.spanKind
Para obtener los valores, consulta la página de referencia de la API de Cloud Trace SpanKind.
Hora de inicio del período start_time span.startTime
Hora de finalización del período end_time span.endTime
Atributos

Los atributos de tramo, recurso y de instrumentación tienen un formato único. Estos campos tienen el tipo de datos JSON de BigQuery. Ejemplos:

  • attributes["somekey"]
  • resource.attributes["somekey"]
  • instrumentation_scope.attributes["somekey"]

Todos los atributos usan el mismo formato: span.attributes.attributeMap.ATTRIBUTE_KEY

Ejemplos:

  • span.attributes.attributeMap._http_method
  • span.attributes.attributeMap.g_co_agent
  • span.attributes.attributeMap.rpc_service
  • span.attributes.attributeMap.rpc_method

¿Qué sigue?