Membuat set data BigQuery tertaut

Anda dapat membuat set data BigQuery tertaut di set data observabilitas, yang memungkinkan Anda menggunakan layanan BigQuery untuk mengkueri data pelacakan. Kemudian, Anda dapat menggabungkan data pelacakan dengan set data bisnis dan menganalisis rentang menggunakan BigQuery Studio atau BigQuery API.

Anda tidak memerlukan set data BigQuery tertaut untuk menganalisis data pelacakan dengan SQL jika menggunakan Observability Analytics. Anda juga dapat menggabungkan data pelacakan dan log saat menggunakan Observability Analytics. Untuk mengetahui informasi selengkapnya, lihat Mengkueri dan menganalisis pelacakan dengan SQL dan Mengkueri dan menganalisis log dengan Observability Analytics.

Kapan Anda memerlukan set data tertaut

Anda memerlukan set data BigQuery tertaut jika ingin melakukan salah satu hal berikut:

  • Menggabungkan data pelacakan dengan set data BigQuery lainnya.
  • Mengkueri data pelacakan dari layanan lain seperti BigQuery Studio atau Data Studio.

  • Menjalankan kueri dari halaman Observability Analytics di mesin BigQuery.

    Halaman Observability Analytics otomatis menjalankan kueri di mesin kueri default, yang menggunakan slot gratis. Namun, Anda dapat mengonfigurasi halaman ini untuk menjalankan kueri di mesin BigQuery.

  • Memantau hasil kueri SQL dengan kebijakan pemberitahuan.

  • Menjalankan pipeline data otomatis, kueri analisis berkelanjutan, atau alur kerja agen AI yang membaca data pelacakan bervolume tinggi secara terprogram tanpa batas frekuensi Trace API.

Membuat set data BigQuery tertaut

Bagian ini menjelaskan cara membuat set data BigQuery tertaut di set data observabilitas, yang memungkinkan Anda menggunakan layanan BigQuery untuk mengkueri data pelacakan. Setiap set data observabilitas mendukung satu set data BigQuery tertaut.

Saat Anda membuat link di set data observabilitas, hal berikut akan terjadi:

  • Google Cloud Observability mungkin membuat akun layanan berikut atau mengubah pemberian peran IAM-nya:

  • Log audit mencatat permintaan untuk membuat link dan permintaan dari pengelola agen layanan untuk memberikan peran IAM Agen Layanan Monitoring kepada Akun Layanan Monitoring. Log ini juga mencatat penyelesaian operasi yang berjalan lama.

Sebelum memulai

  1. Sign in to your Google Cloud account. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

  2. 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

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

  4. Enable the Cloud Monitoring and Observability APIs.

    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 APIs

  5. 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

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

  7. Enable the Cloud Monitoring and Observability APIs.

    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 APIs

    8.

  8. Untuk mendapatkan izin yang diperlukan guna membuat link di set data observabilitas, minta administrator untuk memberi Anda peran IAM Observability Editor (roles/observability.editor) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

    Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Buat set data

gcloud

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • LINK_ID: Nama set data BigQuery.
  • DATASET_ID: ID set data. Data pelacakan Anda disimpan dalam set data bernama Spans.
  • BUCKET_ID: ID bucket observabilitas. Misalnya, ID ini mungkin _Trace.
  • LOCATION: Lokasi bucket observabilitas.
  • PROJECT_ID: ID project.

Jalankan perintah gcloud beta observability buckets datasets links create:

Linux, macOS, atau 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

Perintah buat akan memulai operasi yang berjalan lama. Berikut adalah contoh respons saat perintah berhasil: 

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

Untuk membuat link ke set data BigQuery, kirim permintaan ke projects.locations.buckets.datasets.links.create endpoint.

Anda harus menentukan parameter induk, yang memiliki bentuk berikut:

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

Kolom dalam ekspresi sebelumnya memiliki arti berikut:

  • PROJECT_ID: ID project.
  • LOCATION: Lokasi bucket observabilitas.
  • BUCKET_ID: ID bucket observabilitas. Misalnya, ID ini mungkin _Trace.
  • DATASET_ID: ID set data yang dikueri. Misalnya, ID ini mungkin Spans.

Perintah ini memerlukan parameter kueri dan isi permintaan:

  • Parameter kueri, linkId, harus ditentukan dan ditetapkan ke nama set data BigQuery. Misalnya, linkId="my_link". Nama set data BigQuery harus unik untuk Google Cloud project Anda, dan harus dibatasi hingga 100 karakter serta hanya dapat menyertakan huruf, digit, dan garis bawah.

  • Isi permintaan adalah Link objek. Nilai kolom name memiliki format berikut:

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

    Nilai yang Anda berikan untuk kolom name harus cocok dengan set data BigQuery tertaut yang direferensikan oleh parameter kueri.

    Kolom LINK_ID adalah nama set data BigQuery.

Responsnya adalah Operation objek. Objek ini berisi informasi tentang progres metode. Setelah metode selesai, objek Operation akan berisi data status.

Untuk mengetahui daftar lengkap endpoint Observability API, lihat dokumentasi referensi Observability API.

Jika Anda mengalami error izin saat membuat set data tertaut, lihat Memecahkan masalah error izin.

Langkah berikutnya