Dengan cakupan trace, Anda dapat menelusuri dan menganalisis data Cloud Trace di beberapa project dari halaman Trace Explorer. Jika Anda hanya ingin melihat dan menganalisis span yang berasal dari satu project Google Cloud , Anda tidak perlu mengonfigurasi cakupan trace apa pun. Untuk mengetahui informasi tentang cara melihat trace dan span, lihat Menemukan dan menjelajahi trace.
Tentang cakupan trace
Cakupan trace memungkinkan Anda memiliki tampilan gabungan data trace yang disimpan di beberapa project. Cakupan ini adalah resource persisten level project yang mencantumkan tampilan; setiap tampilan memberikan akses ke data trace yang disimpan oleh project. Halaman seperti Trace Explorer menggunakan cakupan trace untuk menentukan tempat penelusuran data. Namun, halaman ini juga menggunakan peran Identity and Access Management (IAM) Anda pada resource tersebut untuk menentukan apakah Anda memiliki izin untuk melihat data yang ditemukan.
Saat membuat cakupan trace, Anda memberikan nama dan daftar project. Sistem secara otomatis menyertakan tampilan rekaman aktivitas default setiap project,
yang memiliki jalur _Trace/Spans/_AllSpans. Kolom jalur _Trace,
Spans, dan _AllSpans merujuk ke bucket kemampuan observasi, set data
yang menyimpan data, dan tampilan pada set data. Tampilan _AllSpans memberikan akses ke semua data trace yang disimpan project.
Halaman Trace Explorer menyertakan opsi yang memungkinkan Anda memilih cakupan rekaman aktivitas. Saat Anda membuat pilihan, halaman akan menelusuri tampilan yang tercantum dalam cakupan rekaman aktivitas dan memperbarui tampilan.
Anda juga dapat membagikan tampilan yang dikonfigurasi dengan menyalin URL browser. URL mengenkode cakupan trace yang Anda pilih dan setelan halaman lainnya, menggantikan pilihan cakupan default bagi siapa pun yang membuka link. Untuk mengetahui informasi selengkapnya, lihat Membagikan trace dan span.
Anda dapat menetapkan satu cakupan trace sebagai "default". Saat Anda membuat penetapan ini, hal berikut akan terjadi:
Sistem akan mengupdate cakupan kemampuan observasi. Cakupan ini berisi pointer ke cakupan log default dan cakupan trace default, yang membantu sistem menghubungkan data log dan trace saat data tersebut disimpan di beberapa project. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi cakupan kemampuan observasi untuk kueri multi-project.
Sistem akan memperbarui cakupan trace yang digunakan halaman Trace Explorer secara otomatis untuk menelusuri data trace. Jika halaman tidak dapat mengakses cakupan trace default, halaman tersebut akan menelusuri data trace di project Anda.
Anda dapat mengubah dan menghapus cakupan rekaman aktivitas yang Anda buat.
Aplikasi App Hub dan cakupan rekaman aktivitas
Aplikasi App Hub Anda mungkin menulis data trace ke beberapa project. Untuk mendapatkan tampilan gabungan data ini, buat cakupan trace, konfigurasikan untuk mencantumkan tampilan trace default dari semua project yang menyimpan data trace, lalu konfigurasikan sebagai cakupan trace 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 trace kustom di project tempat Anda melihat data trace. Project ini adalah project host atau project pengelolaan App Hub Anda. Misalnya, jika nama tampilan folder adalah
My Folder, nama tampilan project pengelolaan folder adalah
My Folder-mp.
Sebelum memulai
Konfigurasikan project, peran IAM, dan pilih antarmuka yang ingin Anda gunakan.
Mengonfigurasi project dan peran Anda
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
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.enablepermission. 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.-
Untuk mendapatkan izin yang diperlukan untuk membuat dan melihat cakupan trace, 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.Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk membuat dan melihat cakupan trace. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk membuat dan melihat cakupan trace:
-
observability.traceScopes.{create, delete, get, list, update} -
observability.scopes.{get, update}
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
-
Pilih antarmuka yang ingin Anda gunakan
Konsol
Saat menggunakan konsol Google Cloud untuk mengakses layanan dan API Google Cloud , Anda tidak perlu menyiapkan autentikasi.
gcloud
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud initTerraform
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.
-
Instal Google Cloud CLI.
-
Konfigurasi gcloud CLI agar menggunakan identitas gabungan Anda.
Untuk mengetahui informasi selengkapnya, lihat Login ke gcloud CLI dengan identitas gabungan Anda.
-
Buat kredensial autentikasi lokal untuk akun pengguna Anda:
gcloud auth application-default login
Jika error autentikasi ditampilkan, pastikan 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, lalu login ke gcloud CLI dengan identitas gabungan Anda.
Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .
Mencantumkan cakupan trace
Konsol
Untuk mencantumkan cakupan trace, lakukan tindakan berikut:
-
Di konsol Google Cloud , buka halaman settings Settings:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
- Di toolbar konsol Google Cloud , pilih project Google Cloud Anda. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.
Pilih tab Trace Scopes.
Jendela akan menampilkan daftar cakupan trace Anda. Entri yang menyertakan ikon "Default",
,
adalah cakupan trace default.Untuk melihat detail cakupan trace, luaskan cakupan tersebut.
Jika memperluas cakupan trace, 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 trace Anda. Kolom_Trace,Spans, dan_AllSpansmerujuk ke bucket, set data, dan tampilan kemampuan observasi untuk data trace Anda. Tampilan_AllSpanssesuai dengan setiap entri dalam bucket:Nama Deskripsi Jenis Resource arrow_right _DefaultTrace scope1arrow_drop_down myscopeMy descriptionTrace scope2_Trace/Spans/_AllSpansmyprojectTrace view_Trace/Spans/_AllSpansproject-bTrace view
gcloud
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
- LOCATION: Lokasi cakupan trace. 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 trace. Untuk setiap cakupan, nama dan informasi yang relevan akan ditampilkan. Misalnya, berikut ini mengilustrasikan hasil perintah list
untuk project yang memiliki dua cakupan trace:
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 trace. Namun, Anda tidak dapat menggunakan Terraform untuk mencantumkan cakupan trace.
REST
Untuk mencantumkan semua cakupan trace 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 ditetapkan ke
global.
Responsnya adalah array objek TraceScope.
Setiap objek menyertakan nama dan daftar resource.
Untuk mendapatkan informasi tentang cakupan trace tertentu, gunakan perintah
projects.locations.traceScopes.get.
Membuat cakupan trace
Span 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.
Anda dapat membuat 100 cakupan trace per project. Cakupan trace dapat mencakup total 200 tampilan. Jika Anda membuat cakupan trace yang mencantumkan lebih dari 10 tampilan, Anda mungkin mengalami masalah performa.
Konsol
Untuk membuat cakupan trace, lakukan hal berikut:
-
Di konsol Google Cloud , buka halaman settings Settings:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
- Di toolbar konsol Google Cloud , pilih project Google Cloud Anda. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.
- Pilih tab Trace Scopes, lalu klik Create trace scope.
Klik Add projects dan lengkapi dialog.
Di bagian Name trace scope, masukkan nama dan deskripsi yang ingin Anda tampilkan di tab Trace Scopes.
Nama cakupan trace tidak dapat diubah, dan harus unik dalam project.
Klik Create trace scope.
Secara default, tabel Trace scopes mencantumkan cakupan trace Anda dalam bentuk yang diciutkan. Untuk setiap cakupan, tabel mencantumkan nama, deskripsi, jenis, dan jumlah resource.
Jika memperluas cakupan trace, 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 trace Anda. Kolom_Trace,Spans, dan_AllSpansmerujuk ke bucket, set data, dan tampilan kemampuan observasi untuk data trace Anda. Tampilan_AllSpanssesuai dengan setiap entri dalam bucket:Nama Deskripsi Jenis Resource arrow_right _DefaultTrace scope1arrow_drop_down myscopeMy descriptionTrace scope2_Trace/Spans/_AllSpansmyprojectTrace view_Trace/Spans/_AllSpansproject-bTrace view
gcloud
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
- TRACE_SCOPE_NAME: Nama cakupan trace. Contoh,
my-trace-scope. - DESCRIPTION: Opsional. Deskripsi cakupan trace. Format deskripsi sebagai string.
- RESOURCE_NAMES: Daftar nama project yang sepenuhnya memenuhi syarat dan dipisahkan koma.
Contoh,
projects/my-project. - LOCATION: Lokasi cakupan trace. 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 trace baru:
Created traceScope [my-test-scope].
Terraform
Untuk mengetahui informasi tentang cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi penyedia Terraform.
Untuk membuat cakupan trace 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.trace_scope_id: Ditetapkan ke ID cakupan. Contoh,my-trace-scope.Tetapkan
locationke"global".resource_names: Array project, dengan setiap project ditentukan menggunakan nama yang sepenuhnya memenuhi syarat.description: Deskripsi singkat. Misalnya, "Cakupan untuk resource produksi".
REST
Untuk membuat cakupan trace, 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 ditetapkan ke
global.
Mengubah cakupan rekaman aktivitas
Anda tidak dapat mengubah cakupan trace bernama _Default. Anda dapat mengubah semua cakupan trace lainnya.
Konsol
Untuk mengubah cakupan trace, lakukan hal berikut:
-
Di konsol Google Cloud , buka halaman settings Settings:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
- Di toolbar konsol Google Cloud , pilih project Google Cloud Anda. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.
- Pilih tab Trace Scopes.
- Temukan cakupan trace yang ingin Anda ubah, klik more_vert More, pilih Edit scope, lalu lengkapi dialog.
gcloud
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
- TRACE_SCOPE_NAME: Nama cakupan trace. Contoh,
my-trace-scope. - DESCRIPTION: Opsional. Deskripsi cakupan trace. Format deskripsi sebagai string.
- RESOURCE_NAMES: Daftar nama project yang sepenuhnya memenuhi syarat dan dipisahkan koma.
Misalnya,
projects/my-project. - LOCATION: Lokasi cakupan trace. 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 trace 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 mengetahui informasi tentang cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi penyedia Terraform.
Untuk mengubah cakupan trace dalam project
menggunakan Terraform, gunakan resource Terraform
google_observability_trace_scope.
REST
Untuk mengubah cakupan trace, 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 ditetapkan ke
global. - TRACE_SCOPE_NAME: Nama cakupan trace. Contoh,
my-trace-scope.
Menghapus cakupan rekaman aktivitas
Anda tidak dapat menghapus
cakupan trace bernama _Default. Anda dapat menghapus semua cakupan trace lainnya.
Konsol
Untuk menghapus cakupan trace, lakukan langkah-langkah berikut:
-
Di konsol Google Cloud , buka halaman settings Settings:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
- Di toolbar konsol Google Cloud , pilih project Google Cloud Anda. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.
- Pilih tab Trace Scopes.
- Temukan cakupan trace yang ingin Anda hapus, klik more_vert More, pilih Delete scope, lalu selesaikan dialog.
gcloud
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
- TRACE_SCOPE_NAME: Nama cakupan trace. Contoh,
my-trace-scope. - LOCATION: Lokasi cakupan trace. 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 mengetahui informasi tentang cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi penyedia Terraform.
Untuk menghapus cakupan trace dalam project
menggunakan Terraform, gunakan resource Terraform
google_observability_trace_scope.
REST
Untuk menghapus cakupan trace, 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 ditetapkan ke
global. - TRACE_SCOPE_NAME: Nama cakupan trace. Contoh,
my-trace-scope.
Mengonfigurasi cakupan trace default
Saat halaman Trace Explorer terbuka, halaman tersebut akan menelusuri tampilan yang tercantum dalam cakupan trace default untuk data trace. Jika cakupan default tidak dapat diakses, halaman akan menelusuri data trace di project Anda. Penelusuran ini setara dengan membuat kueri tampilan _AllSpans project Anda di set data default.
Saat project dibuat, cakupan trace bernama _Default akan dibuat dan ditetapkan sebagai cakupan trace default. Namun, Anda dapat membuat
cakupan trace sendiri dan menetapkannya sebagai cakupan trace
default.
Konsol
Untuk menetapkan cakupan trace default, lakukan hal berikut:
-
Di konsol Google Cloud , buka halaman settings Settings:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
- Di toolbar konsol Google Cloud , pilih project Google Cloud Anda. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.
Pilih tab Trace Scopes.
Tab ini menampilkan cakupan trace Anda, dan menyertakan tombol untuk membuat cakupan trace kustom. Cakupan trace yang ditampilkan dengan ikon "Default",
, adalah cakupan trace default saat ini.Untuk mengubah cakupan trace default, temukan cakupan trace yang ingin Anda tetapkan sebagai cakupan trace default, klik more_vert More, lalu pilih Set as default.
Cakupan rekaman aktivitas yang Anda pilih ditampilkan dengan ikon "Default",
.
gcloud
Untuk melihat dan memperbarui cakupan kemampuan observasi, lakukan hal berikut:
Untuk melihat setelan cakupan kemampuan observasi, 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 tersebut 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
- OBSERVABILITY_SCOPE_ID: Nama objek
Untuk memperbarui cakupan kemampuan observasi, jalankan perintah
gcloud observability scopes update. Dalam perintahupdate, Anda dapat menyertakan flag--log-scope, flag--trace-scope, atau kedua flag tersebut.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 yang sepenuhnya memenuhi syarat dari cakupan log. 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 yang sepenuhnya memenuhi syarat dari cakupan trace. Kolom ini memiliki format berikut:
projects/PROJECT_ID/locations/LOCATION/traceScopes/TRACE_SCOPE_NAME
Dalam ekspresi sebelumnya, TRACE_SCOPE_NAME adalah nama cakupan trace. 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 adalahmy-trace-scope, maka responsnya akan 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
- OBSERVABILITY_SCOPE_ID: Nama objek
Terraform
Anda dapat menggunakan Terraform untuk membuat dan mengubah cakupan trace. Namun, Anda tidak dapat menggunakan Terraform untuk menetapkan cakupan trace default.
REST
Untuk mendapatkan dan menetapkan cakupan log default atau cakupan trace default menggunakan panggilan API, Anda harus mengonfigurasi cakupan kemampuan observasi. Cakupan kemampuan observasi mencantumkan cakupan log default dan cakupan trace default:
- Untuk mendapatkan cakupan kemampuan observasi default untuk sebuah project, kirim permintaan ke endpoint
projects.locations.scopes.get. Anda harus menentukan parameter jalur. Responsnya adalah objekScope, yang mencantumkan cakupan log default dan cakupan trace default. - Untuk memperbarui cakupan kemampuan observasi default untuk sebuah project, kirim permintaan ke endpoint
projects.locations.scopes.patch. Anda harus menentukan parameter jalur, parameter kueri, dan memberikan objekScope. Parameter kueri mengidentifikasi kolom mana yang diubah. Responsnya adalah objekScope.
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 ditetapkan ke_Default. ObjekScopedengan nama_Default, yang dibuat secara otomatis, menyimpan informasi tentang cakupan log default dan cakupan trace 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:
- Klik
projects.locations.scopes.get. - Di widget Try this method, masukkan perintah berikut di kolom name:
projects/PROJECT_ID/locations/global/scopes/_DefaultSebelum menyalin kolom sebelumnya, ganti PROJECT_ID dengan nama project Anda.
- Pilih Execute.
- 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" }
Batasan pada cakupan trace
| Batasan pada cakupan trace | Nilai |
|---|---|
| Jumlah maksimum cakupan trace per project | 100 |
| Jumlah maksimum tampilan per cakupan trace | 200 |
Untuk performa yang optimal, batasi jumlah tampilan dalam cakupan trace menjadi 10.
Langkah berikutnya
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: