Crea un conjunto de datos vinculado a BigQuery

En este documento, se describe cómo crear un conjunto de datos vinculado a BigQuery en tu conjunto de datos de observabilidad. Luego, puedes usar los servicios de BigQuery, como BigQuery Studio y la API de BigQuery, para consultar el conjunto de datos vinculado.

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

Cuándo necesitas un conjunto de datos vinculado

No necesitas un conjunto de datos vinculado a BigQuery cuando quieres consultar tus datos de seguimiento o tus datos de seguimiento y de registros. Para esas situaciones, puedes usar la página Observability Analytics. Para obtener información sobre cómo consultar datos de registros, consulta Cómo consultar y analizar registros con Observability Analytics.

Necesitas un conjunto de datos vinculado a BigQuery cuando quieres hacer cualquiera de las siguientes acciones:

• Unir datos de seguimiento con otros conjuntos de datos de BigQuery
• Consultar datos de seguimiento de otro servicio, como BigQuery Studio o Data Studio
• Ejecutar consultas desde la página Observability Analytics en el motor de BigQuery.
• Supervisar los resultados de tu consulta en SQL con una política de alertas.

Crea un conjunto de datos vinculado a BigQuery

En esta sección, se describe cómo crear un conjunto de datos vinculado a BigQuery, que permite que los servicios de BigQuery consulten tus datos de seguimiento. Puedes crear un conjunto de datos vinculado a BigQuery en un conjunto de datos de observabilidad.

Cuando creas un conjunto de datos vinculado, inicias una operación de larga duración. Se producen varias acciones como parte de esa operación:

• Los registros de auditoría registran la solicitud para crear un vínculo y la finalización de la operación.

• Cuando la cuenta de servicio de Monitoring no existe, Google Cloud Observability la crea.

  La API de Cloud Monitoring debe estar habilitada para que se cree esta cuenta de servicio.

• Google Cloud Observability requiere una cuenta de servicio antes de que pueda crear un conjunto de datos vinculado. Cuando es necesario, se crea una cuenta de servicio:

  • Cuenta de servicio de Cloud Observability: Es necesaria para un vínculo en un conjunto de datos de observabilidad.

  • Cuenta de servicio de Cloud Logging: Es necesaria para un vínculo en un bucket de registros.

• Un registro de auditoría registra la solicitud del administrador del agente de servicio para otorgar a la cuenta de servicio de Monitoring el rol de IAM de agente de servicio de Monitoring.

Antes de comenzar

Accede a tu Google Cloud cuenta de. 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 Cloud Monitoring and Observability APIs.

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 APIs

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 Cloud Monitoring and Observability APIs.

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 APIs

1. Para obtener los permisos que necesitas para crear un vínculo en un conjunto de datos de observabilidad, pídele a tu administrador que te otorgue el rol de IAM de editor de Observability (roles/observability.editor) 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 mediante roles personalizados o cualquier otro rol predefinido.

Crear conjunto de datos

gcloud

Nota: Debes usar la versión 563.0.0 de gcloud CLI o una posterior.

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

• LINK_ID: El nombre del conjunto de datos de BigQuery
• DATASET_ID: El ID del conjunto de datos Tus datos de seguimiento se almacenan en un conjunto de datos llamado Spans.
• BUCKET_ID: El ID del bucket de observabilidad Por ejemplo, este ID podría ser _Trace.
• LOCATION: La ubicación de los buckets de observabilidad
• PROJECT_ID: El identificador del proyecto

Ejecuta el gcloud beta observability buckets datasets links create comando:

Linux, macOS o Cloud Shell

gcloud beta observability buckets datasets links create \
  projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID \
 --dataset=DATASET_ID\
 --bucket=BUCKET_ID \
 --location=LOCATION \
 --project=PROJECT_ID

Windows (PowerShell)

gcloud beta observability buckets datasets links create `
  projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID `
 --dataset=DATASET_ID`
 --bucket=BUCKET_ID `
 --location=LOCATION `
 --project=PROJECT_ID

Windows (cmd.exe)

gcloud beta observability buckets datasets links create ^
  projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID ^
 --dataset=DATASET_ID^
 --bucket=BUCKET_ID ^
 --location=LOCATION ^
 --project=PROJECT_ID

El comando create inicia una operación de larga duración. El siguiente es un ejemplo de una respuesta cuando el comando se ejecuta correctamente:

Create request issued for: [mydataset]
Waiting for operation [projects/my-project/locations/us/operations/operation-1775164903749-64e80c9817833-9ff804b6-c3e9cbe7] to complete...done.
Created link [mydataset].

REST

Para crear un vínculo a un conjunto de datos de BigQuery, envía una solicitud al projects.locations.buckets.datasets.links.create extremo.

Debes especificar el parámetro superior, que tiene el siguiente formato:

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID

Los campos de la expresión anterior tienen el siguiente significado:

• PROJECT_ID: El identificador del proyecto
• LOCATION: La ubicación del bucket de observabilidad.
• BUCKET_ID: El ID del bucket de observabilidad Por ejemplo, este ID podría ser _Trace.
• DATASET_ID: El ID del conjunto de datos que se consulta Por ejemplo, este ID podría ser Spans.

Este comando requiere un parámetro de consulta y un cuerpo de solicitud:

• Se debe especificar el parámetro de consulta linkId y establecerlo en el nombre del conjunto de datos de BigQuery. Por ejemplo, linkId="my_link". El nombre del conjunto de datos de BigQuery debe ser único para tu Google Cloud proyecto, debe limitarse a 100 caracteres y solo puede incluir letras, dígitos y guiones bajos.

• El cuerpo de la solicitud es un Link objeto. El valor del campo name tiene el siguiente formato:

  projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/dataset/DATASET_ID/links/LINK_ID
  

  El valor que proporcionas para el campo name debe coincidir con el conjunto de datos vinculado a BigQuery al que hace referencia el parámetro de consulta.

  El campo LINK_ID es el nombre del conjunto de datos de BigQuery.

La respuesta es un Operation objeto. Este objeto contiene información sobre el progreso del método. Cuando se completa el método, el objeto Operation contiene datos de estado.

Para obtener una lista completa de los extremos de la API de Observability, consulta la documentación de referencia de la API de Observability.

Si encuentras errores de permisos cuando creas un conjunto de datos vinculado, consulta Soluciona errores de permisos.

¿Qué sigue?

• Consulta datos de seguimiento con BigQuery Studio.
• Ejecuta consultas en el motor de BigQuery.