Dokumen ini menjelaskan cara membuat dan mengelola cakupan rekaman aktivitas, yang memungkinkan halaman Trace Explorer menemukan span rekaman aktivitas yang ingin Anda lihat atau analisis. Jika hanya ingin melihat dan menganalisis span yang berasal dari project Google Cloud, Anda tidak perlu mengonfigurasi cakupan rekaman aktivitas apa pun. 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 span dari satu project Google Cloud.
Dokumen ini tidak menjelaskan cara melihat rekaman aktivitas dan span. Untuk informasi tentang topik tersebut, lihat Menemukan dan menjelajahi rekaman aktivitas.
Tentang cakupan rekaman aktivitas
Cakupan rekaman aktivitas adalah resource level project yang persisten dan mencantumkan kumpulan project Google Cloud. Anda dapat mengonfigurasi halaman Trace Explorer untuk menelusuri menurut cakupan rekaman aktivitas, yang berarti halaman akan menelusuri project yang tercantum dalam cakupan yang dipilih. Peran Identity and Access Management (IAM) Anda di project yang ditelusuri dan setelan rentang waktu menentukan data yang diambil dari penyimpanan, lalu ditampilkan.
Saat Anda membuat project Google Cloud, cakupan rekaman aktivitas bernama _Default akan dibuat. Cakupan ini hanya mencakup project Google Cloud. Anda tidak dapat menambahkan project ke cakupan ini atau menghapus cakupan ini.
Anda dapat membuat cakupan rekaman aktivitas, dan Anda dapat mengubah serta menghapus cakupan rekaman aktivitas yang Anda buat. Anda ingin membuat cakupan rekaman aktivitas saat memiliki layanan yang menulis data span ke beberapa project Google Cloud.
Kecuali jika Anda membuka halaman Trace Explorer dengan URL yang menyertakan cakupan trace atau ID trace dan span, halaman Trace Explorer akan menelusuri project Google Cloud yang tercantum dalam cakupan trace default untuk data trace.
Saat Anda membuat project, cakupan rekaman aktivitas bernama _Default akan
ditetapkan sebagai cakupan rekaman aktivitas default. Namun, Anda dapat memilih cakupan rekaman aktivitas yang berbeda untuk digunakan sebagai cakupan rekaman aktivitas default.
Sebelum memulai
Untuk mendapatkan izin yang diperlukan guna membuat dan melihat cakupan rekaman aktivitas, serta menetapkan cakupan rekaman aktivitas default, minta administrator untuk memberi Anda peran IAM berikut:
-
Untuk membuat dan melihat cakupan rekaman aktivitas serta mendapatkan cakupan rekaman aktivitas default:
Cloud Trace User (
roles/cloudtrace.user) di project Anda -
Untuk menetapkan cakupan rekaman aktivitas default:
Observability Editor (
roles/observability.editor) di project Anda
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin yang diperlukan untuk membuat dan melihat cakupan rekaman aktivitas, serta menetapkan cakupan rekaman aktivitas default. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk membuat dan melihat cakupan rekaman aktivitas, serta menetapkan cakupan rekaman aktivitas default:
-
Untuk membuat dan mengelola cakupan rekaman aktivitas:
cloudtrace.traceScopes.[create, delete, get, list, update] -
Untuk menetapkan cakupan rekaman aktivitas default:
observability.scopes.[get, update]
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Mencantumkan cakupan rekaman aktivitas
Untuk mencantumkan cakupan rekaman aktivitas, 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.
Pilih tab Cakupan Rekaman Aktivitas.
Tabel mencantumkan cakupan rekaman aktivitas Anda. Setelah Anda memilih project Google Cloud, satu entri akan ditampilkan dengan ikon "Default",
,
yang menunjukkan bahwa entri tersebut adalah cakupan rekaman aktivitas default.
Halaman Trace Explorer menelusuri project yang tercantum dalam cakupan rekaman aktivitas default untuk menemukan data rekaman aktivitas saat halaman terbuka.
Membuat cakupan rekaman aktivitas
Rentang yang ditampilkan oleh halaman Trace Explorer bergantung pada project yang ditelusuri, peran IAM Anda di project tersebut, setelan rentang waktu, dan filter yang Anda terapkan.
Anda dapat membuat 100 cakupan rekaman aktivitas per project. Cakupan rekaman aktivitas dapat mencakup total 20 project.
Untuk membuat cakupan rekaman aktivitas, 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.
- Pilih tab Trace Scopes, lalu klik Create trace scope.
Klik Tambahkan project dan selesaikan dialog.
Saat Anda menambahkan project, span yang disimpan dalam project tersebut akan disertakan dalam cakupan rekaman aktivitas. Jika tidak tahu project mana yang akan disertakan dalam cakupan, Anda dapat menggunakan halaman Trace Explorer lama untuk membantu mengidentifikasinya. Untuk informasi selengkapnya, lihat bagian Bermigrasi ke cakupan rekaman aktivitas dalam dokumen ini.
Di bagian Nama cakupan rekaman aktivitas, 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.
Klik Buat cakupan rekaman aktivitas.
Bermigrasi ke cakupan rekaman aktivitas
Halaman Trace Explorer mengharuskan Anda menentukan project Google Cloud untuk menelusuri data rekaman aktivitas, yang merupakan perubahan perilaku dari halaman Trace Explorer lama. Halaman Trace Explorer lama menelusuri semua project dalam organisasi. Karena perbedaan ini, halaman Trace Explorer mungkin tidak menampilkan span yang ditampilkan halaman Trace Explorer lama.
Anda dapat menggunakan bagian panel Detail rekaman aktivitas di halaman Trace Explorer lama untuk membantu Anda menyusun daftar project Google Cloud yang menyimpan data rekaman aktivitas:
Buka halaman Trace Explorer lama:
Pilih rekaman aktivitas.
Anda dapat mencoba hal berikut:
- Melihat rekaman aktivitas dengan memasukkan ID-nya ke kolom ID Rekaman Aktivitas.
- Menambahkan filter.
Di panel Trace details, pilih rekaman aktivitas, lalu buka tab Projects.
Tab ini mencantumkan project yang menyimpan span untuk rekaman aktivitas.
Untuk membuat cakupan rekaman aktivitas yang berisi project yang tercantum, buka toolbar tab Projects, lalu pilih Create scope with these projects, lalu selesaikan dialog.
Ulangi langkah sebelumnya hingga Anda menyusun daftar project.
Setelah Anda menyusun daftar project, buat cakupan rekaman aktivitas. Anda juga dapat menetapkannya sebagai cakupan rekaman aktivitas default.
Menetapkan cakupan rekaman aktivitas default
Saat dibuka, halaman Trace Explorer akan menelusuri project yang tercantum dalam cakupan rekaman aktivitas default untuk menemukan data rekaman aktivitas. Jika cakupan trace tersebut tidak dapat diakses, project Anda akan ditelusuri untuk menemukan data trace.
Saat project dibuat, cakupan rekaman aktivitas bernama _Default akan dibuat
dan ditetapkan sebagai cakupan rekaman aktivitas default. Namun, Anda dapat membuat
cakupan rekaman aktivitas sendiri dan menetapkannya sebagai cakupan
rekaman aktivitas default.
Untuk menetapkan cakupan rekaman aktivitas 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.
- Pilih tab Cakupan Rekaman Aktivitas.
Temukan cakupan rekaman aktivitas yang ingin Anda tetapkan sebagai cakupan rekaman aktivitas default, klik more_vert Lainnya, lalu pilih Tetapkan sebagai default.
Cakupan rekaman aktivitas yang Anda pilih ditampilkan dengan ikon "Default",
.
Mengubah atau menghapus cakupan rekaman aktivitas
Anda tidak dapat menghapus atau mengubah cakupan rekaman aktivitas yang bernama _Default. Anda dapat mengubah atau menghapus semua cakupan trace lainnya.
Untuk mengubah atau menghapus cakupan rekaman aktivitas, 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.
- Pilih tab Trace Scopes.
Temukan cakupan rekaman aktivitas yang ingin Anda ubah atau hapus, klik more_vert Lainnya, lalu lakukan salah satu tindakan berikut:
- Untuk mengubah, pilih Edit cakupan, lalu lengkapi dialog.
- Untuk menghapus, pilih Hapus cakupan, lalu selesaikan dialog.
Batasan
Tidak ada dukungan Cloud Trace API atau Google Cloud CLI untuk membuat atau mengelola cakupan rekaman aktivitas.
Langkah selanjutnya
Cloud Logging dan Cloud Monitoring berisi konstruksi serupa yang memungkinkan Anda mengontrol data log atau data metrik yang dapat Anda lihat atau pantau. Untuk informasi tentang cakupan tersebut, lihat dokumen berikut: