Bermigrasi ke Observability Analytics

Jika Anda menggunakan sink untuk mengekspor data trace ke BigQuery, maka dokumen ini berlaku untuk Anda. Penggunaan sink untuk mengekspor data trace tidak lagi direkomendasikan. Sebagai gantinya, sebaiknya gunakan 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 menyertakan informasi tentang cara membuat kueri data trace menggunakan layanan BigQuery.

BigQuery menyediakan layanan yang memungkinkan Anda menyalin tabel atau mengekspor data. Anda dapat menyalin dan mengekspor data trace menggunakan layanan ini setelah membuat set data BigQuery tertaut, langkah opsional yang dijelaskan dalam dokumen ini. Untuk mengetahui informasi selengkapnya, lihat Mengelola tabel dan Pengantar ekspor data.

Untuk mulai menggunakan Observability Analytics, lihat Membuat kueri dan menganalisis trace.

Sebelum memulai

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

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 untuk memuat halaman Observability Analytics, menjalankan kueri, dan membuat set data BigQuery tertaut, minta administrator Anda untuk memberi peran IAM berikut pada project Anda:

   • Admin Cloud Trace (roles/cloudtrace.admin)
   • Editor Observability (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, aktifkan Cloud Shell. Google Cloud

   Aktifkan Cloud Shell

   Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan prompt 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 mengaktifkan Observability API.

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

   1. Di Google Cloud konsol, 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 Views, buka bagian Traces , lalu pilih _Trace.Spans._AllSpans.

      Panel Schema akan diperbarui dan menampilkan skema.

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

   3. Di panel Schema, pilih Query.

      Kolom editor kueri akan 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 Run in BigQuery, klik Settings, lalu pilih Analytics (default).

   Anda telah memverifikasi bahwa Anda dapat membuat kueri data trace menggunakan halaman Observability Analytics.

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

4. Hapus sink trace 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 span	name	span.displayName.value
Jenis span	kind Untuk mengetahui nilai, lihat OpenTelemetry: SpanKind.	span.spanKind Untuk mengetahui nilai, lihat halaman SpanKind referensi Cloud Trace API.
Waktu mulai span	start_time	span.startTime
Waktu berakhir span	end_time	span.endTime
Atribut	Setiap atribut span, 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 trace.
• Kueri sampel.