Dokumen ini menjelaskan cara mengakses dan melihat rekaman aktivitas dan rentang yang dihasilkan oleh aplikasi Gemini Enterprise Anda. Rekaman aktivitas dan rentang memberikan insight mendetail tentang performa dan alur eksekusi permintaan dalam aplikasi Anda, seperti saat menggunakan asisten atau agen.
Anda dapat melihat data rekaman aktivitas menggunakan Trace Explorer atau langsung di dalam setiap agen menggunakan tab Traces agen.
Konsep utama
Bagian ini memperkenalkan konsep utama terkait kemampuan observasi di Gemini Enterprise.
| Konsep | Deskripsi |
|---|---|
| Trace |
Trace adalah kumpulan rentang yang merepresentasikan satu permintaan atau
transaksi saat mengalir melalui berbagai layanan dan komponen.
Misalnya, rekaman aktivitas mewakili seluruh siklus proses permintaan. Hal ini mencakup pengguna yang mengajukan pertanyaan dari asisten Gemini Enterprise, respons asisten Gemini Enterprise, dan tindakan berikutnya yang dipicu oleh jawaban, seperti mengirim email. |
| Span | Rentang adalah satu unit kerja berwaktu dalam rekaman aktivitas. Objek ini merepresentasikan operasi tertentu, seperti panggilan fungsi, permintaan API, atau kueri database. Setiap rentang mencakup detail seperti waktu mulai dan berakhirnya, ID unik, dan hubungannya dengan rentang lainnya. Hubungan ini bersama-sama membentuk rekaman aktivitas. |
| Log rentang | Log rentang diberi stempel waktu, pesan atau peristiwa bentuk bebas yang terkait dengan rentang tertentu. URL ini memberikan informasi kontekstual yang mendetail tentang eksekusi rentang, membantu pengguna men-debug masalah dan memahami alur permintaan. |
Sebelum memulai
Pastikan Anda memiliki:
Peran Admin Gemini Enterprise atau peran Pengguna Gemini Enterprise di konsol Google Cloud .
Aplikasi web Gemini Enterprise yang sudah ada. Untuk mengetahui informasi tentang cara membuat aplikasi baru, lihat Membuat aplikasi.
Untuk mengakses rekaman aktivitas, Anda harus memiliki peran Pengguna Cloud Trace (
roles/cloudtrace.user).Aktifkan setelan kemampuan pengamatan Aktifkan instrumentasi log dan rekaman aktivitas OpenTelemetry. Bergantung pada jenis agen, Anda dapat mengaktifkannya di konfigurasi tingkat aplikasi (untuk agen Core Assistant) atau di dalam tab Konfigurasi agen (untuk agen buatan karyawan Agent Designer dan agen Deep Research). Untuk mengetahui informasi selengkapnya, lihat Mengelola setelan kemampuan pengamatan.
Retensi data
Trace dan rentang yang dihasilkan oleh aplikasi Gemini Enterprise Anda disimpan di Cloud Trace di Google Cloud project Anda, dan retensinya diatur oleh Cloud Trace. Secara default, Cloud Trace menyimpan data rentang selama 30 hari; data yang lebih lama dari periode retensi akan otomatis dihapus. Untuk mengetahui nilai retensi yang paling valid dan terbaru, lihat Periode retensi Cloud Trace dalam dokumentasi Kuota dan batas Cloud Trace.
Mengakses rekaman aktivitas di Trace Explorer
Untuk mengakses rekaman aktivitas dan rentang menggunakan Trace Explorer, ikuti langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Trace Explorer.
Pilih Google Cloud project tempat aplikasi Gemini Enterprise Anda dibuat. Anda melihat semua rentang untuk project Anda.
Di tabel, klik Span ID untuk melihat detail rekaman aktivitas, termasuk durasi rentang dan atribut lainnya.
Mengakses rekaman aktivitas untuk agen
Anda juga dapat melihat rentang rekaman aktivitas secara langsung untuk setiap agen di tab Traces agen, yang menampilkan ringkasan kronologis mendetail tentang rekaman aktivitas rentang dan struktur eksekusi induk-turunan.
Untuk mengakses rekaman aktivitas agen:
- Di konsol Google Cloud , buka aplikasi Anda, lalu klik Agen.
- Pilih agen yang ingin Anda periksa, lalu klik tab Traces.
Tabel ringkasan rekaman aktivitas
Tabel utama di tab Traces menampilkan informasi berikut untuk setiap rentang rekaman aktivitas:
- Status: Status rekaman aktivitas saat ini (saat ini menampilkan Belum ditetapkan).
- ID rentang rekaman aktivitas: ID unik untuk rentang rekaman aktivitas. Klik link ID rentang untuk melihat perincian detailnya.
- Nama Rentang: Deskripsi singkat tentang pekerjaan yang dilakukan rentang.
- Jenis Rentang: Jenis rentang. Opsinya mencakup:
Agent to Tool: Pemanggilan dari agen ke alat eksternal.Invoke Agent: Pemanggilan agen.Agent to Model: Permintaan dari agen ke model bahasa besar.
- Durasi: Waktu yang diperlukan untuk menyelesaikan rentang rekaman aktivitas (dalam menit).
- Input: Data atau pesan input yang dikirim ke rentang, jika ada.
- Output: Hasil output yang ditampilkan oleh rentang, jika ada.
- Waktu Mulai: Stempel waktu yang tepat saat rentang mulai dieksekusi.
Tampilan rekaman aktivitas mendetail
Mengklik ID rentang rekaman aktivitas akan membuka halaman detail yang menampilkan:
- Ringkasan: Lihat metadata dasar, termasuk Waktu mulai, Durasi, dan total jumlah Rentang. Anda dapat mengklik Lihat di Cloud Trace atau beralih di antara tombol tampilan Grafik dan Linimasa.
- Visualisasi: Beralih antara hierarki grafis atau tampilan linimasa yang menunjukkan hubungan induk-turunan dari semua rentang rekaman aktivitas.
- Detail rentang yang dipilih: Pilih satu rentang untuk menampilkan bagian yang mendetail, yang dapat mencakup:
- Ringkasan: Menampilkan nama rentang, layanan target, jumlah total rentang dengan tindakan ini, dan total durasi (dalam detik).
- Log: Lihat detail peristiwa yang relevan jika dikonfigurasi. Klik Lihat log untuk langsung membuka log standar.
- Evaluasi: Menampilkan hasil evaluasi, jika dikonfigurasi.
- Input & Output: Lengkapi payload permintaan dan respons.
- Log & Peristiwa: Daftar peristiwa yang terjadi selama eksekusi rentang ini.
- Stacktrace: Detail error jika eksekusi rentang gagal.
- Metadata & Link: Link yang mereferensikan entitas cloud explorer terkait.
- Atribut: Tag resource dan parameter pengamatan nilai kunci tambahan.
