Migra a Estadísticas de observabilidad

Vista previa

Este producto o función está sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Si usas receptores para exportar datos de seguimiento a BigQuery, este documento es para ti. Ya no se recomienda usar receptores para exportar datos de seguimiento. En su lugar, te recomendamos que uses Observability Analytics, que admite el mismo lenguaje de consultas SQL que BigQuery. En este documento, se describe cómo migrar de una solución basada en receptores a una que usa Observability Analytics. También incluye información sobre cómo consultar tus datos de seguimiento con los servicios de BigQuery.

BigQuery proporciona servicios que te permiten copiar tablas o exportar datos. Puedes copiar y exportar tus datos de seguimiento con estos servicios después de crear un conjunto de datos de BigQuery vinculado, un paso opcional que se detalla en este documento. Para obtener más información, consulta Administra tablas y Introducción a la exportación de datos.

Para comenzar a usar Observability Analytics, consulta Cómo consultar y analizar seguimientos.

Antes de comenzar

Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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

   • Administrador de Cloud Trace (roles/cloudtrace.admin)
   • Editor de Observability (roles/observability.editor)
   • Usuario de BigQuery (roles/bigquery.user)

   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.

2. En la consola de Google Cloud , activa Cloud Shell.

   Activa Cloud Shell

   En la parte inferior de la consola de Google Cloud , se inicia una sesión de Cloud Shell que muestra una ventana emergente con una línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.

Migra a Estadísticas de observabilidad

1. Completaste las acciones que se indican en la sección Antes de comenzar de este documento. Entre esas acciones, se incluye habilitar la API de Observability.

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

   1. En la consola de Google Cloud , ve a la página Observability Analytics:

      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 proyectoGoogle 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 la barra de herramientas 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 seguimiento 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 la 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?

• Consultar y analizar registros
• Consultas de muestra.