Bermigrasi ke Observability Analytics

Jika Anda menggunakan sink trace untuk mengekspor data Cloud Trace ke BigQuery, migrasikan ke Observability Analytics. Tujuan rekaman aktivitas tidak digunakan lagi dan akan dihapus pada atau setelah 18 Februari 2027. Analytics Observabilitas memungkinkan Anda mengkueri data rekaman aktivitas secara langsung menggunakan bahasa kueri SQL yang sama dengan BigQuery tanpa mengelola tujuan ekspor.

Jika ingin menggunakan layanan BigQuery untuk menggabungkan set data, mengelola tabel, atau mengekspor data, Anda dapat membuat set data BigQuery tertaut. Anda dapat membuat set data BigQuery tertaut saat bermigrasi atau di lain waktu. Untuk mulai menggunakan Analisis Kemampuan Observasi, lihat Kueri dan analisis rekaman aktivitas.

Sebelum memulai

Login ke akun Google Cloud Anda. 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.

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, 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

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, 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

1. Untuk mendapatkan izin yang diperlukan guna memuat halaman Observability Analytics, menjalankan kueri, dan membuat set data BigQuery tertaut, minta administrator Anda untuk memberi Anda peran IAM berikut di project Anda:

   • Admin Cloud Trace (roles/cloudtrace.admin)
   • Editor Kemampuan Observasi (roles/observability.editor)
   • Pengguna BigQuery (roles/bigquery.user)

   Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

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

2. Di konsol Google Cloud , aktifkan Cloud Shell.

   Aktifkan Cloud Shell

   Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.

Bermigrasi ke Observability Analytics

1. Selesaikan tindakan yang tercantum di bagian Sebelum memulai dalam dokumen ini. Tindakan tersebut mencakup pengaktifan Observability API.

2. Pastikan Anda memiliki akses ke data rekaman aktivitas menggunakan Observability Analytics:

   1. Di konsol Google Cloud , buka halaman Observability Analytics:

      Buka Observability Analytics

      Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Logging.

   2. Di menu Tampilan, buka bagian Traces , lalu pilih _Trace.Spans._AllSpans.

      Panel Schema diperbarui dan menampilkan skema.

      Jika Anda tidak melihat tampilan bernama _Trace.Spans._AllSpans, berarti project Google Cloud Anda tidak berisi bucket kemampuan observasi bernama _Trace. Untuk mengetahui informasi tentang cara mengatasi situasi ini, lihat Inisialisasi penyimpanan pelacakan gagal.

   3. Di panel Schema, pilih Query.

      Kolom editor kueri diperbarui. Klausul FROM mencantumkan entri yang mirip dengan berikut ini:

      `PROJECT_ID.us._Trace.Spans._AllSpans`
      

   4. Di toolbar, pilih Run Query.

      Jika toolbar menampilkan Jalankan di BigQuery, klik Setelan, lalu pilih Analytics (default).

   Anda telah memverifikasi bahwa Anda dapat membuat kueri data rekaman aktivitas dengan menggunakan halaman Observability Analytics.

3. Opsional: Jika Anda ingin menggabungkan data rekaman aktivitas dengan data bisnis lain yang tersedia di BigQuery, buat set data BigQuery tertaut. Untuk mengetahui informasi selengkapnya, lihat artikel Membuat kueri set data BigQuery tertaut.

4. Hapus sink pelacakan dan set data yang tidak diperlukan:

   1. Untuk mencantumkan sink trace yang ada, jalankan perintah gcloud alpha trace sinks list:

      gcloud alpha trace sinks list
      

   2. Untuk setiap sink, jalankan perintah gcloud alpha trace sinks delete:

      gcloud alpha trace sinks delete SINK_NAME
      

   3. Opsional: Hapus set data BigQuery yang tidak diperlukan. Untuk mengetahui informasi tentang cara menghapus set data BigQuery, lihat Menghapus set data.

Perbandingan skema

Bagian ini memberikan informasi tentang perbedaan antara skema ekspor berbasis sink dan Observability Analytics.

Nama	Analytics	Lama
ID Trace	trace_id	extendedFields.traceId
ID Span	span_id	span.spanId
ID rentang induk	parent_span_id	span.parentSpanId
Nama rentang	name	span.displayName.value
Jenis rentang	kind Untuk nilai, lihat OpenTelemetry: SpanKind.	span.spanKind Untuk mengetahui nilainya, lihat halaman referensi Cloud Trace API SpanKind.
Waktu mulai rentang	start_time	span.startTime
Waktu berakhir rentang	end_time	span.endTime
Atribut	Setiap atribut rentang, resource, dan instrumentasi memiliki format unik. Kolom ini memiliki jenis data JSON BigQuery. Contoh: attributes["somekey"] resource.attributes["somekey"] instrumentation_scope.attributes["somekey"]	Semua atribut menggunakan format yang sama: span.attributes.attributeMap.ATTRIBUTE_KEY Contoh: span.attributes.attributeMap._http_method span.attributes.attributeMap.g_co_agent span.attributes.attributeMap.rpc_service span.attributes.attributeMap.rpc_method

Langkah berikutnya

• Membuat kueri dan menganalisis rekaman aktivitas
• Contoh kueri