Membuat dan mengelola cakupan rekaman aktivitas

Dokumen ini menjelaskan cara membuat dan mengelola cakupan rekaman aktivitas, yang memungkinkan halaman Trace Explorer menemukan rentang rekaman aktivitas yang ingin Anda lihat atau analisis. Jika hanya ingin melihat dan menganalisis rentang yang berasal dari project Google Cloud , Anda tidak perlu mengonfigurasi cakupan rekaman aktivitas. Namun, jika data rekaman aktivitas Anda disimpan di beberapa project, seperti yang mungkin terjadi saat Anda menggunakan arsitektur microservice, Anda perlu melakukan beberapa aktivitas konfigurasi untuk melihat semua rentang dari satu project. Google Cloud

Dokumen ini tidak menjelaskan cara melihat rekaman aktivitas dan rentang. Untuk mengetahui informasi tentang topik tersebut, lihat Menemukan dan menjelajahi rekaman aktivitas.

Fitur ini hanya didukung untuk Google Cloud project. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.

Tentang cakupan rekaman aktivitas

Cakupan rekaman aktivitas adalah resource tingkat project yang persisten yang mencantumkan tampilan, yang memberikan akses ke data rekaman aktivitas Anda. Anda dapat mengonfigurasi halaman Trace Explorer untuk menelusuri menurut cakupan rekaman aktivitas, yang berarti halaman tersebut menelusuri tampilan yang tercantum dalam cakupan yang dipilih. Peran Identity and Access Management (IAM) Anda di tampilan yang dicari dan setelan rentang waktu menentukan data yang diambil sistem dari penyimpanan, lalu ditampilkan.

Anda dapat membuat cakupan rekaman aktivitas, serta mengubah dan menghapus cakupan rekaman aktivitas yang Anda buat. Anda ingin membuat cakupan rekaman aktivitas saat memiliki layanan yang menulis data rentang ke beberapa project Google Cloud .

Cakupan rekaman aktivitas mencantumkan tampilan, bukan Google Cloud project. Meskipun Anda memilih project saat mengonfigurasi cakupan rekaman aktivitas, sistem akan menambahkan tampilan rekaman aktivitas default project tersebut ke cakupan. Tampilan rekaman aktivitas default project sesuai dengan tampilan dengan jalur _Trace/Spans/_AllSpans, dengan kolom _Trace, Spans, dan _AllSpans merujuk ke bucket, set data, dan tampilan kemampuan pengamatan. Set data Spans menyimpan data rekaman aktivitas Anda.

Kecuali jika Anda membuka halaman Trace Explorer dengan URL yang menyertakan cakupan rekaman aktivitas atau ID rekaman aktivitas dan rentang, halaman Trace Explorer akan menelusuri tampilan yang tercantum dalam cakupan rekaman aktivitas default untuk data rekaman aktivitas. Saat Anda membuat project, cakupan rekaman aktivitas bernama _Default akan ditetapkan sebagai cakupan rekaman aktivitas default. Namun, Anda dapat memilih cakupan rekaman aktivitas lain untuk digunakan sebagai cakupan rekaman aktivitas default.

Tentang cakupan kemampuan observasi

Cakupan kemampuan pengamatan menentukan cakupan rekaman aktivitas dan cakupan log mana yang akan digunakan saat halaman penjelajah yang sesuai dibuka. Jika Anda tidak mengonfigurasi cakupan kemampuan observasi untuk mencantumkan resource yang menyimpan data Anda, Anda mungkin tidak dapat mengorelasikan data log dan rekaman aktivitas. Untuk mempelajari lebih lanjut, lihat Mengonfigurasi cakupan kemampuan pengamatan untuk kueri multi-project.

Aplikasi App Hub dan cakupan rekaman aktivitas

Aplikasi App Hub Anda dapat menulis data rekaman aktivitas ke beberapa project. Untuk mendapatkan tampilan gabungan data ini, buat cakupan rekaman aktivitas, konfigurasikan untuk mencantumkan tampilan rekaman aktivitas default dari semua project yang menyimpan data rekaman aktivitas, lalu konfigurasikan sebagai cakupan rekaman aktivitas default. Setelah Anda menyelesaikan langkah-langkah tersebut, halaman Trace Explorer akan otomatis menampilkan data yang ditulis oleh aplikasi Anda, meskipun data tersebut disimpan di project yang berbeda.

Buat cakupan rekaman aktivitas kustom dalam project tempat Anda akan melihat data rekaman aktivitas. Project ini adalah project host App Hub atau project pengelolaan Anda. Misalnya, jika nama tampilan folder adalah My Folder, maka nama tampilan project pengelolaan folder adalah My Folder-mp.

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 guna membuat dan melihat cakupan rekaman aktivitas, minta administrator untuk memberi Anda peran IAM Observability Scopes Editor (roles/observability.scopesEditor) 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.

   Peran Editor Cakupan Observabilitas mencakup izin pribadi yang memungkinkan Anda membuat dan melihat cakupan rekaman aktivitas. Izin ini tidak dapat disertakan dalam peran IAM khusus.

2. Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

   Konsol

   Saat menggunakan konsol Google Cloud untuk mengakses layanan Google Cloud dan API, Anda tidak perlu menyiapkan autentikasi.

   gcloud

   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.

   Terraform

   Untuk menggunakan contoh Terraform di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.

   1. Instal Google Cloud CLI.

   2. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

   3. Jika Anda menggunakan shell lokal, buat kredensial autentikasi lokal untuk akun pengguna Anda:

      gcloud auth application-default login

      Anda tidak perlu melakukan langkah ini jika menggunakan Cloud Shell.

      Jika error autentikasi ditampilkan, dan Anda menggunakan penyedia identitas (IdP) eksternal, konfirmasi bahwa Anda telah login ke gcloud CLI dengan identitas gabungan Anda.

   Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan pengembangan lokal dalam dokumentasi autentikasi Google Cloud .

   REST

   Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

   Instal Google Cloud CLI.

   Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

   Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

Mencantumkan cakupan rekaman aktivitas

Konsol

Untuk mencantumkan cakupan rekaman aktivitas, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman  Setelan:

   Buka Setelan

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

2. Di toolbar konsol Google Cloud , pilih project Google Cloud Anda. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.

3. Pilih tab Cakupan Pelacakan.

   Jendela ini menampilkan daftar cakupan rekaman aktivitas Anda. Entri yang menyertakan ikon "Default", , adalah cakupan rekaman aktivitas default.

4. Untuk melihat detail cakupan rekaman aktivitas, luaskan cakupan tersebut.

   Jika Anda memperluas cakupan rekaman aktivitas, Anda dapat melihat daftar tampilan yang disertakan dalam cakupan. Setiap baris mencantumkan project ID beserta entri seperti _Trace/Spans/_AllSpans, yang mengidentifikasi lokasi penyimpanan default untuk data rekaman aktivitas Anda. Kolom _Trace, Spans, dan _AllSpans merujuk ke bucket, set data, dan tampilan kemampuan observasi untuk data trace Anda. Tampilan _AllSpans sesuai dengan setiap entri dalam bucket:

   Nama	Deskripsi	Jenis	Resource
   _Default		Trace scope	1
   myscope	My description	Trace scope	2
   _Trace/Spans/_AllSpans	myproject	Trace view
   _Trace/Spans/_AllSpans	project-b	Trace view

gcloud

Catatan: Anda harus menggunakan gcloud CLI versi 563.0.0 atau yang lebih baru.

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

• LOCATION: Lokasi cakupan rekaman aktivitas. Kolom ini harus memiliki nilai global.
• PROJECT_ID: ID project.

Jalankan perintah gcloud observability trace-scopes list:

Linux, macOS, atau Cloud Shell

gcloud observability trace-scopes list \
 --location=LOCATION --project=PROJECT_ID

Windows (PowerShell)

gcloud observability trace-scopes list `
 --location=LOCATION --project=PROJECT_ID

Windows (cmd.exe)

gcloud observability trace-scopes list ^
 --location=LOCATION --project=PROJECT_ID

Data respons adalah daftar cakupan rekaman aktivitas. Untuk setiap cakupan, nama dan informasi yang relevan ditampilkan. Misalnya, berikut ini mengilustrasikan hasil perintah list untuk project yang memiliki dua cakupan rekaman aktivitas:

name: projects/my-project/locations/global/traceScopes/_Default
resourceNames:
- projects/my-project
---
createTime: '2026-03-26T13:43:54.772326947Z'
description: a test
name: projects/my-project/locations/global/traceScopes/my-test-scope
resourceNames:
- projects/another-project
- projects/my-project
updateTime: '2026-03-26T13:43:54.772326947Z'

Terraform

Anda dapat menggunakan Terraform untuk membuat dan mengubah cakupan rekaman aktivitas. Namun, Anda tidak dapat menggunakan Terraform untuk mencantumkan cakupan rekaman aktivitas.

REST

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.

Untuk mencantumkan semua cakupan rekaman aktivitas dalam project Google Cloud , gunakan perintah projects.locations.traceScopes.list. Anda harus menentukan parameter jalur.

Parameter jalur untuk endpoint ini memiliki sintaksis berikut:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes

Kolom dalam ekspresi sebelumnya memiliki arti berikut:

• PROJECT_ID: ID project. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.
• LOCATION_ID harus disetel ke global.

Responsnya adalah array objek TraceScope. Setiap objek mencakup nama dan daftar resource.

Untuk mendapatkan informasi tentang cakupan rekaman aktivitas tertentu, gunakan perintah projects.locations.traceScopes.get.

Membuat cakupan rekaman aktivitas

Rentang yang ditampilkan oleh halaman Trace Explorer bergantung pada tampilan yang ditelusuri, peran IAM Anda pada tampilan tersebut, setelan rentang waktu, dan filter yang Anda terapkan.

Peringatan: Pastikan semua tampilan yang tercantum dalam cakupan rekaman aktivitas menyimpan data rekaman aktivitasnya di lokasi yang sama. Sistem menyimpan data rekaman aktivitas Anda dalam bucket kemampuan pengamatan bernama _Trace. Untuk mempelajari cara menampilkan lokasi tempat data trace Anda disimpan, lihat Mencantumkan bucket kemampuan observasi.

Anda dapat membuat 100 cakupan rekaman aktivitas per project. Cakupan rekaman aktivitas dapat mencakup total 20 tampilan.

Konsol

Untuk membuat cakupan rekaman aktivitas, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman  Setelan:

   Buka Setelan

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

2. Di toolbar konsol Google Cloud , pilih project Google Cloud Anda. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.
3. Pilih tab Cakupan Pelacakan, lalu klik Buat cakupan pelacakan.

4. Klik Tambahkan project dan selesaikan dialog.

   Catatan: Saat Anda memilih project, sistem akan menambahkan tampilan rekaman aktivitas default project ke cakupan.

5. Di bagian Cakupan rekaman aktivitas nama, masukkan nama dan deskripsi yang ingin Anda tampilkan di tab Cakupan Rekaman Aktivitas.

   Nama cakupan rekaman aktivitas tidak dapat diubah dan harus unik dalam project.

6. Klik Buat cakupan rekaman aktivitas.

   Secara default, tabel Cakupan rekaman aktivitas mencantumkan cakupan rekaman aktivitas Anda dalam bentuk diciutkan. Untuk setiap cakupan, tabel mencantumkan nama, deskripsi, jenis, dan jumlah resource.

   Jika Anda memperluas cakupan rekaman aktivitas, Anda dapat melihat daftar tampilan yang disertakan dalam cakupan. Setiap baris mencantumkan project ID beserta entri seperti _Trace/Spans/_AllSpans, yang mengidentifikasi lokasi penyimpanan default untuk data rekaman aktivitas Anda. Kolom _Trace, Spans, dan _AllSpans merujuk ke bucket, set data, dan tampilan kemampuan observasi untuk data trace Anda. Tampilan _AllSpans sesuai dengan setiap entri dalam bucket:

   Nama	Deskripsi	Jenis	Resource
   _Default		Trace scope	1
   myscope	My description	Trace scope	2
   _Trace/Spans/_AllSpans	myproject	Trace view
   _Trace/Spans/_AllSpans	project-b	Trace view

gcloud

Catatan: Anda harus menggunakan gcloud CLI versi 563.0.0 atau yang lebih baru.

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

• TRACE_SCOPE_NAME: Nama cakupan rekaman aktivitas. Contoh, my-trace-scope.
• DESCRIPTION: Opsional. Deskripsi cakupan rekaman aktivitas. Format deskripsi sebagai string.
• RESOURCE_NAMES: Daftar nama project yang sepenuhnya memenuhi syarat dan dipisahkan koma. Contoh, projects/my-project.
• LOCATION: Lokasi cakupan rekaman aktivitas. Kolom ini harus memiliki nilai global.
• PROJECT_ID: ID project.

Jalankan perintah gcloud observability trace-scopes create:

Linux, macOS, atau Cloud Shell

gcloud observability trace-scopes create TRACE_SCOPE_NAME \
 --description=DESCRIPTION \
 --resource-names=RESOURCE_NAMES \
 --location=LOCATION --project=PROJECT_ID

Windows (PowerShell)

gcloud observability trace-scopes create TRACE_SCOPE_NAME `
 --description=DESCRIPTION `
 --resource-names=RESOURCE_NAMES `
 --location=LOCATION --project=PROJECT_ID

Windows (cmd.exe)

gcloud observability trace-scopes create TRACE_SCOPE_NAME ^
 --description=DESCRIPTION ^
 --resource-names=RESOURCE_NAMES ^
 --location=LOCATION --project=PROJECT_ID

Jika berhasil, respons perintah create akan menyertakan nama cakupan rekaman aktivitas baru:

Created traceScope [my-test-scope].

Terraform

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi penyedia Terraform.

Untuk membuat cakupan rekaman aktivitas dalam project menggunakan Terraform, gunakan resource Terraform google_observability_trace_scope.

Dalam perintah, tetapkan kolom berikut:

• project: Nama project, folder, atau organisasi Anda. Contoh, my-project. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.

  Catatan: Sistem tidak menambahkan project ke cakupan. Sebagai gantinya, perintah ini akan menambahkan tampilan _AllSpans project pada set data Spans.

• trace_scope_id: Ditetapkan ke ID cakupan. Contoh, my-trace-scope.

• Tetapkan location ke "global".

• resource_names: Array project, dengan setiap project ditentukan menggunakan nama yang sepenuhnya memenuhi syarat.

• description: Deskripsi singkat. Misalnya, "Cakupan untuk resource produksi".

REST

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.

Untuk membuat cakupan rekaman aktivitas, gunakan perintah projects.locations.traceScopes.create. Anda harus menentukan parameter jalur dan memberikan objek TraceScope. Responsnya adalah objek TraceScope.

Parameter jalur untuk endpoint ini memiliki sintaksis berikut:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes

Kolom dalam ekspresi sebelumnya memiliki arti berikut:

• PROJECT_ID: ID project. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.
• LOCATION_ID harus disetel ke global.

Mengubah cakupan rekaman aktivitas

Anda tidak dapat mengubah cakupan rekaman aktivitas yang bernama _Default. Anda dapat mengubah semua cakupan rekaman aktivitas lainnya.

Konsol

Untuk mengubah cakupan rekaman aktivitas, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman  Setelan:

   Buka Setelan

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

2. Di toolbar konsol Google Cloud , pilih project Google Cloud Anda. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.
3. Pilih tab Cakupan Pelacakan.
4. Temukan cakupan rekaman aktivitas yang ingin Anda ubah, klik  Lainnya, pilih Edit cakupan, lalu selesaikan dialog.

gcloud

Catatan: Anda harus menggunakan gcloud CLI versi 563.0.0 atau yang lebih baru.

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

• TRACE_SCOPE_NAME: Nama cakupan rekaman aktivitas. Contoh, my-trace-scope.
• DESCRIPTION: Opsional. Deskripsi cakupan rekaman aktivitas. Format deskripsi sebagai string.
• RESOURCE_NAMES: Daftar nama project yang sepenuhnya memenuhi syarat dan dipisahkan koma. Misalnya, projects/my-project.
• LOCATION: Lokasi cakupan rekaman aktivitas. Kolom ini harus memiliki nilai global.
• PROJECT_ID: ID project.

Jalankan perintah gcloud observability trace-scopes update:

Linux, macOS, atau Cloud Shell

gcloud observability trace-scopes update TRACE_SCOPE_NAME \
 --description=DESCRIPTION \
 --resource-names=RESOURCE_NAMES \
 --location=LOCATION --project=PROJECT_ID

Windows (PowerShell)

gcloud observability trace-scopes update TRACE_SCOPE_NAME `
 --description=DESCRIPTION `
 --resource-names=RESOURCE_NAMES `
 --location=LOCATION --project=PROJECT_ID

Windows (cmd.exe)

gcloud observability trace-scopes update TRACE_SCOPE_NAME ^
 --description=DESCRIPTION ^
 --resource-names=RESOURCE_NAMES ^
 --location=LOCATION --project=PROJECT_ID

Jika berhasil, data respons perintah update akan menampilkan cakupan rekaman aktivitas yang diperbarui:

Updated traceScope [my-test-scope].
createTime: '2026-03-26T13:43:54.772326947Z'
description: A scope for testing
name: projects/my-project/locations/global/traceScopes/my-test-scope
resourceNames:
- projects/another-project
- projects/my-project
updateTime: '2026-03-26T13:48:05.262142872Z'

Terraform

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi penyedia Terraform.

Untuk mengubah cakupan rekaman aktivitas dalam project menggunakan Terraform, gunakan resource Terraform google_observability_trace_scope.

REST

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.

Untuk mengubah cakupan rekaman aktivitas, gunakan perintah projects.locations.traceScopes.patch. Anda harus menentukan parameter jalur, parameter kueri, dan memberikan objek TraceScope. Parameter kueri mengidentifikasi kolom mana yang diubah. Responsnya adalah objek TraceScope.

Parameter jalur untuk endpoint ini memiliki sintaksis berikut:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes/TRACE_SCOPE_NAME

Kolom dalam ekspresi sebelumnya memiliki arti berikut:

• PROJECT_ID: ID project. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.
• LOCATION_ID harus disetel ke global.
• TRACE_SCOPE_NAME: Nama cakupan rekaman aktivitas. Contoh, my-trace-scope.

Menghapus cakupan rekaman aktivitas

Anda tidak dapat menghapus cakupan rekaman aktivitas yang bernama _Default. Anda dapat menghapus semua cakupan rekaman aktivitas lainnya.

Konsol

Untuk menghapus cakupan rekaman aktivitas, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman  Setelan:

   Buka Setelan

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

2. Di toolbar konsol Google Cloud , pilih project Google Cloud Anda. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.
3. Pilih tab Cakupan Pelacakan.
4. Temukan cakupan rekaman aktivitas yang ingin Anda hapus, klik  Lainnya, pilih Hapus cakupan, lalu selesaikan dialog.

gcloud

Catatan: Anda harus menggunakan gcloud CLI versi 563.0.0 atau yang lebih baru.

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

• TRACE_SCOPE_NAME: Nama cakupan rekaman aktivitas. Contoh, my-trace-scope.
• LOCATION: Lokasi cakupan rekaman aktivitas. Kolom ini harus memiliki nilai global.
• PROJECT_ID: ID project.

Jalankan perintah gcloud observability trace-scopes delete:

Linux, macOS, atau Cloud Shell

gcloud observability trace-scopes delete TRACE_SCOPE_NAME \
 --location=LOCATION --project=PROJECT_ID

Windows (PowerShell)

gcloud observability trace-scopes delete TRACE_SCOPE_NAME `
 --location=LOCATION --project=PROJECT_ID

Windows (cmd.exe)

gcloud observability trace-scopes delete TRACE_SCOPE_NAME ^
 --location=LOCATION --project=PROJECT_ID

Jika Anda mengeluarkan perintah delete, Anda akan diminta untuk mengonfirmasi tindakan tersebut. Berikut menunjukkan contoh eksekusi:

You are about to delete traceScope [my-test-scope]

Do you want to continue (Y/n)?  Y

Deleted traceScope [my-test-scope].

Terraform

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi penyedia Terraform.

Untuk menghapus cakupan rekaman aktivitas dalam project menggunakan Terraform, gunakan resource Terraform google_observability_trace_scope.

REST

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.

Untuk menghapus cakupan rekaman aktivitas, gunakan perintah projects.locations.traceScopes.delete. Anda harus menentukan parameter jalur.

Parameter jalur untuk endpoint ini memiliki sintaksis berikut:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes/TRACE_SCOPE_NAME

Kolom dalam ekspresi sebelumnya memiliki arti berikut:

• PROJECT_ID: ID project. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.
• LOCATION_ID harus disetel ke global.
• TRACE_SCOPE_NAME: Nama cakupan rekaman aktivitas. Contoh, my-trace-scope.

Mengonfigurasi cakupan rekaman aktivitas default

Saat halaman Trace Explorer terbuka, halaman tersebut akan menelusuri tampilan yang tercantum dalam cakupan rekaman aktivitas default untuk data rekaman aktivitas. Jika cakupan rekaman aktivitas tersebut tidak dapat diakses, halaman Trace Explorer akan mengkueri tampilan _AllSpans project Anda pada set data default.

Saat project dibuat, cakupan rekaman aktivitas bernama _Default akan dibuat dan ditetapkan sebagai cakupan rekaman aktivitas default. Namun, Anda dapat membuat cakupan rekaman aktivitas Anda sendiri dan menetapkannya sebagai cakupan rekaman aktivitas default.

Konsol

Untuk menyetel cakupan rekaman aktivitas default, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman  Setelan:

   Buka Setelan

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

2. Di toolbar konsol Google Cloud , pilih project Google Cloud Anda. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.

3. Pilih tab Cakupan Pelacakan.

   Tab ini menampilkan cakupan rekaman aktivitas dan menyertakan tombol untuk membuat cakupan rekaman aktivitas kustom. Cakupan rekaman aktivitas yang ditampilkan dengan ikon "Default", , adalah cakupan rekaman aktivitas default saat ini.

4. Untuk mengubah cakupan rekaman aktivitas default, temukan cakupan rekaman aktivitas yang ingin Anda tetapkan sebagai cakupan rekaman aktivitas default, klik  Lainnya, lalu pilih Tetapkan sebagai default.

   Cakupan rekaman aktivitas yang Anda pilih ditampilkan dengan ikon "Default", .

gcloud

Catatan: Anda harus menggunakan gcloud CLI versi 563.0.0 atau yang lebih baru.

Untuk melihat dan memperbarui cakupan kemampuan pengamatan, lakukan hal berikut:

1. Untuk melihat setelan cakupan kemampuan pengamatan, jalankan perintah gcloud observability scopes describe.

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

   • OBSERVABILITY_SCOPE_ID: Nama objek Scope. Nilai ini harus ditetapkan ke _Default.
   • LOCATION: Kolom lokasi harus ditetapkan ke global.
   • PROJECT_ID: ID project.

   Jalankan perintah gcloud observability scopes describe:

   Linux, macOS, atau Cloud Shell

   gcloud observability scopes describe OBSERVABILITY_SCOPE_ID \
      --location=LOCATION\
      --project=PROJECT_ID

   Windows (PowerShell)

   gcloud observability scopes describe OBSERVABILITY_SCOPE_ID `
      --location=LOCATION`
      --project=PROJECT_ID

   Windows (cmd.exe)

   gcloud observability scopes describe OBSERVABILITY_SCOPE_ID ^
      --location=LOCATION^
      --project=PROJECT_ID

   Respons terhadap perintah ini akan mirip dengan berikut ini:

   logScope: logging.googleapis.com/projects/my-project/locations/global/logScopes/_Default
   traceScope: projects/my-project/locations/global/traceScopes/_Default
   name: projects/my-project/locations/global/scopes/_Default
   

2. Untuk memperbarui cakupan kemampuan pengamatan, jalankan perintah gcloud observability scopes update. Dalam perintah update, Anda dapat menyertakan flag --log-scope, flag --trace-scope, atau kedua flag.

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

   • OBSERVABILITY_SCOPE_ID: Nama objek Scope. Nilai ini harus ditetapkan ke _Default.
   • LOG_SCOPE_FQN_ID: Nama resource cakupan log yang sepenuhnya memenuhi syarat. Kolom ini memiliki format berikut:

     logging.googleapis.com/projects/PROJECT_ID/locations/LOCATION/logScopes/LOG_SCOPE_ID

     Dalam ekspresi sebelumnya, LOG_SCOPE_ID adalah ID cakupan log. Contoh, my-scope.

   • TRACE_SCOPE_FQN_ID: Nama resource cakupan rekaman aktivitas yang sepenuhnya memenuhi syarat. Kolom ini memiliki format berikut:

     projects/PROJECT_ID/locations/LOCATION/traceScopes/TRACE_SCOPE_NAME

     Dalam ekspresi sebelumnya, TRACE_SCOPE_NAME adalah nama cakupan rekaman aktivitas. Contoh, my-trace-scope.

   • LOCATION: Kolom lokasi harus ditetapkan ke global.
   • PROJECT_ID: ID project.

   Jalankan perintah gcloud observability scopes update:

   Linux, macOS, atau Cloud Shell

   gcloud observability scopes update OBSERVABILITY_SCOPE_ID \
      --log-scope=LOG_SCOPE_FQN_ID\
      --trace-scope=TRACE_SCOPE_FQN_ID\
      --location=LOCATION\
      --project=PROJECT_ID

   Windows (PowerShell)

   gcloud observability scopes update OBSERVABILITY_SCOPE_ID `
      --log-scope=LOG_SCOPE_FQN_ID`
      --trace-scope=TRACE_SCOPE_FQN_ID`
      --location=LOCATION`
      --project=PROJECT_ID

   Windows (cmd.exe)

   gcloud observability scopes update OBSERVABILITY_SCOPE_ID ^
      --log-scope=LOG_SCOPE_FQN_ID^
      --trace-scope=TRACE_SCOPE_FQN_ID^
      --location=LOCATION^
      --project=PROJECT_ID

   Misalnya, jika nilai LOG_SCOPE_ID adalah my-log-scope, dan nilai TRACE_SCOPE_NAME adalah my-trace-scope, maka responsnya mirip dengan berikut ini:

   Updated scope [_Default].
   logScope: logging.googleapis.com/projects/my-project/locations/global/logScopes/my-log-scope
   traceScope: projects/my-project/locations/global/traceScopes/my-trace-scope
   name: projects/my-project/locations/global/scopes/_Default
   

Terraform

Anda dapat menggunakan Terraform untuk membuat dan mengubah cakupan rekaman aktivitas. Namun, Anda tidak dapat menggunakan Terraform untuk menetapkan cakupan rekaman aktivitas default.

REST

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.

Untuk mendapatkan dan menyetel cakupan log default atau cakupan rekaman aktivitas default menggunakan panggilan API, Anda mengonfigurasi cakupan kemampuan pengamatan. Cakupan kemampuan observasi mencantumkan cakupan log default dan cakupan rekaman aktivitas default:

• Untuk mendapatkan cakupan kemampuan pengamatan default untuk project, kirim permintaan ke endpoint projects.locations.scopes.get. Anda harus menentukan parameter jalur. Respons adalah objek Scope, yang mencantumkan cakupan log default dan cakupan rekaman aktivitas default.

• Untuk memperbarui cakupan kemampuan pengamatan default untuk project, kirim permintaan ke endpoint projects.locations.scopes.patch. Anda harus menentukan parameter jalur, parameter kueri, dan memberikan objek Scope. Parameter kueri mengidentifikasi kolom mana yang diubah. Responsnya adalah objek Scope.

Parameter jalur untuk kedua endpoint memiliki format berikut:

projects/PROJECT_ID/locations/LOCATION/scopes/OBSERVABILITY_SCOPE_ID

Kolom dalam ekspresi sebelumnya memiliki arti berikut:

• PROJECT_ID: ID project. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.
• LOCATION: Kolom lokasi harus ditetapkan ke global.
• OBSERVABILITY_SCOPE_ID: Nama objek Scope. Kolom ini harus disetel ke _Default. Objek Scope dengan nama _Default, yang dibuat secara otomatis, menyimpan informasi tentang cakupan log default dan cakupan rekaman aktivitas default.

Untuk mengirim perintah ke endpoint API, Anda dapat menggunakan APIs Explorer, yang memungkinkan Anda mengeluarkan perintah dari halaman referensi. Misalnya, untuk mendapatkan cakupan default saat ini, Anda dapat melakukan hal berikut:

1. Klik projects.locations.scopes.get.

2. Di widget Try this method, masukkan perintah berikut di kolom name:

   projects/PROJECT_ID/locations/global/scopes/_Default
   

   Sebelum Anda menyalin kolom sebelumnya, ganti PROJECT_ID dengan nama project Anda.

3. Pilih Jalankan.

4. Dalam dialog otorisasi, selesaikan langkah-langkah yang diperlukan.

   Responsnya mirip dengan hal berikut ini:

   {
   "name": "projects/my-project/locations/global/scopes/_Default",
   "logScope": "logging.googleapis.com/projects/my-project/locations/global/logScopes/_Default"
   "traceScope": "projects/my-project/locations/global/traceScopes/_Default"
   }
   

Batas cakupan rekaman aktivitas

Batas cakupan rekaman aktivitas	Nilai
Jumlah maksimum cakupan rekaman aktivitas per project	100
Jumlah maksimum tampilan per cakupan rekaman aktivitas	20

Langkah berikutnya

• Menemukan dan menjelajahi rekaman aktivitas

• Cloud Logging dan Cloud Monitoring berisi konstruksi serupa yang memungkinkan Anda mengontrol data log atau data metrik yang dapat Anda lihat atau pantau. Untuk mengetahui informasi tentang cakupan tersebut, lihat dokumen berikut:

  • Ringkasan cakupan kemampuan observasi
  • Membuat dan mengelola cakupan log
  • Ringkasan cakupan metrik