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 harus 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 App Hub atau project pengelolaan folder yang mendukung aplikasi.

Tentang cakupan rekaman aktivitas

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

Saat Anda membuat project Google Cloud , cakupan rekaman aktivitas bernama _Default dibuat. Cakupan ini hanya mencakup project Google Cloud . Anda tidak dapat menambahkan proyek ke cakupan ini atau menghapus cakupan ini.

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 .

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

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 semua project yang menyimpan data rekaman aktivitas Anda, 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 di project tempat Anda akan melihat data log. Project ini adalah project host App Hub Anda atau project pengelolaan folder yang mendukung aplikasi. Misalnya, jika nama tampilan folder adalah My Folder, maka nama tampilan project pengelolaan adalah My Folder-mp.

Sebelum memulai

Untuk mendapatkan izin yang diperlukan untuk membuat dan melihat cakupan rekaman aktivitas, minta administrator Anda untuk memberi Anda peran IAM Cloud Trace User (roles/cloudtrace.user) 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. 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:

  • Untuk membuat dan mengelola cakupan rekaman aktivitas: cloudtrace.traceScopes.{create, delete, get, list, update}

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Izin tambahan diperlukan untuk menyetel cakupan rekaman aktivitas default. Izin tersebut dijelaskan di bagian Mengonfigurasi cakupan rekaman aktivitas default dalam dokumen ini.

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 Google Cloud project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.

  3. Pilih tab Cakupan Pelacakan.

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

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 Google Cloud project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.
  3. Pilih tab Trace Scopes, lalu klik Create trace scope.

  4. Klik Tambahkan project dan selesaikan dialog.

    Saat Anda menambahkan project, rentang yang disimpan dalam project tersebut disertakan dalam cakupan rekaman aktivitas. Jika Anda tidak tahu project mana yang harus disertakan dalam cakupan, Anda dapat menggunakan halaman Trace Explorer lama untuk membantu Anda mengidentifikasinya. Untuk mengetahui informasi selengkapnya, lihat bagian Bermigrasi ke cakupan rekaman aktivitas dalam dokumen ini.

  5. Di bagian Cakupan rekaman aktivitas bernama, 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.

Bermigrasi ke cakupan rekaman aktivitas

Halaman Trace Explorer mengharuskan Anda menentukan Google Cloud project yang akan ditelusuri untuk menemukan 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 rentang yang ditampilkan oleh halaman Trace Explorer lama.

Anda dapat menggunakan bagian panel Detail rekaman aktivitas di halaman Trace Explorer lama untuk membantu Anda menyusun daftar projectGoogle Cloud yang menyimpan data rekaman aktivitas Anda:

  1. Buka halaman Trace Explorer lama:

    Buka Legacy Trace explorer

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

  3. Pilih rekaman aktivitas.

    Anda dapat mencoba hal berikut:

    • Melihat rekaman aktivitas dengan memasukkan ID-nya ke kolom ID Rekaman Aktivitas.
    • Menambahkan filter.

  4. Di panel Detail rekaman aktivitas, pilih rekaman aktivitas, lalu buka tab Project.

    Tab ini mencantumkan project yang menyimpan rentang untuk rekaman aktivitas.

  5. Untuk membuat cakupan rekaman aktivitas yang berisi project yang tercantum, buka toolbar tab Projects, pilih Create scope with these projects, lalu selesaikan dialog.

  6. Ulangi langkah-langkah sebelumnya hingga Anda menyusun daftar project.

Setelah Anda menyusun daftar project, buat cakupan rekaman aktivitas. Anda juga dapat menyetelnya sebagai cakupan rekaman aktivitas 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 rekaman aktivitas lainnya.

Konsol

Untuk mengubah atau menghapus 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 Google Cloud project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.
  3. Pilih tab Cakupan Pelacakan.

  4. Temukan cakupan rekaman aktivitas yang ingin Anda ubah atau hapus, klik  Lainnya, lalu lakukan salah satu hal berikut:

    • Untuk mengubahnya, pilih Edit cakupan, lalu lengkapi dialog.
    • Untuk menghapus, pilih Hapus cakupan, lalu lengkapi dialog.

Mengonfigurasi cakupan rekaman aktivitas default

Saat halaman Trace Explorer terbuka, halaman tersebut akan menelusuri project yang tercantum dalam cakupan rekaman aktivitas default untuk menemukan data rekaman aktivitas. Jika cakupan rekaman aktivitas tersebut tidak dapat diakses, project Anda akan ditelusuri untuk menemukan data rekaman aktivitas.

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.

Sebelum memulai

  1. Enable the Observability API.

    Enable the API

    Sebelum mengaktifkan API, pastikan project yang benar telah dipilih. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.

  2. Untuk mendapatkan izin yang Anda perlukan untuk membuat dan melihat cakupan rekaman aktivitas, serta menetapkan cakupan rekaman aktivitas default, minta administrator Anda untuk memberi Anda peran IAM berikut 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 untuk 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.

Menetapkan cakupan default

Konsol

Untuk menetapkan 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 Google Cloud project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.

  3. Pilih tab Cakupan Pelacakan.

    Tab ini menampilkan cakupan rekaman aktivitas Anda dan menyertakan tombol untuk membuat cakupan rekaman aktivitas kustom.

  4. 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", .

Batasan

Tidak ada dukungan Cloud Trace API atau Google Cloud CLI untuk membuat atau mengelola cakupan rekaman aktivitas.

Batas cakupan rekaman aktivitas

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

Langkah berikutnya