Membuat dan mengelola cakupan rekaman aktivitas

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

  1. 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.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. 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

  4. 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 init

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. Konfigurasi gcloud CLI agar menggunakan identitas gabungan Anda.

    Untuk mengetahui informasi selengkapnya, lihat Login ke gcloud CLI dengan identitas gabungan Anda.

  3. 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:

  1. Di konsol Google Cloud , buka halaman  Settings:

    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 Trace Scopes.

    Jendela akan menampilkan daftar cakupan trace Anda. Entri yang menyertakan ikon "Default", , adalah cakupan trace default.

  4. 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 _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

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:

  1. Di konsol Google Cloud , buka halaman  Settings:

    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 Trace Scopes, lalu klik Create trace scope.
  4. Klik Add projects dan lengkapi dialog.

  5. 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.

  6. 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 _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

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

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:

  1. Di konsol Google Cloud , buka halaman  Settings:

    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 Trace Scopes.
  4. Temukan cakupan trace yang ingin Anda ubah, klik  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:

  1. Di konsol Google Cloud , buka halaman  Settings:

    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 Trace Scopes.
  4. Temukan cakupan trace yang ingin Anda hapus, klik  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:

  1. Di konsol Google Cloud , buka halaman  Settings:

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

  4. Untuk mengubah cakupan trace default, temukan cakupan trace yang ingin Anda tetapkan sebagai cakupan trace default, klik  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:

  1. 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
    
  2. Untuk memperbarui cakupan kemampuan observasi, jalankan perintah gcloud observability scopes update. Dalam perintah update, 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 adalah my-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
    

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 objek Scope, 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 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 ditetapkan ke _Default. Objek Scope dengan 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:

  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 menyalin kolom sebelumnya, ganti PROJECT_ID dengan nama project Anda.

  3. Pilih Execute.
  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"
        }
        

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