Bermigrasi ke Observability Analytics

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Jika Anda menggunakan sink untuk mengekspor data rekaman aktivitas ke BigQuery, maka dokumen ini berlaku untuk Anda. Penggunaan sink untuk mengekspor data rekaman aktivitas tidak lagi direkomendasikan. Sebagai gantinya, sebaiknya Anda menggunakan Observability Analytics, yang mendukung bahasa kueri SQL yang sama dengan BigQuery. Dokumen ini menjelaskan cara bermigrasi dari solusi berbasis sink ke solusi yang menggunakan Observability Analytics. Dokumen ini juga mencakup informasi tentang cara membuat kueri data rekaman aktivitas menggunakan layanan BigQuery.

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.

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. Untuk mendapatkan izin yang diperlukan untuk memuat halaman Observability Analytics, menjalankan kueri, dan membuat set data tertaut, minta administrator 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. Menyelesaikan 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 Log Analytics:

      Buka Log 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 pengamatan 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 span 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 yang 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.