Mengakses metrik

Dokumen ini menjelaskan cara mengakses metrik yang dihasilkan oleh aplikasi Gemini Enterprise Anda. Metrik ini memberikan insight tentang performa dan kondisi aplikasi Anda.

Anda dapat melihat telemetri metrik menggunakan Metrics Explorer atau langsung di dalam setiap agen menggunakan tab Metrics agen.

Konsep utama

Bagian ini memperkenalkan konsep utama terkait observabilitas di Gemini Enterprise.

Konsep Deskripsi
Metrik Metrik adalah pengukuran numerik yang dikumpulkan sistem dari waktu ke waktu. Pengukuran ini mewakili performa, penggunaan resource, atau perilaku sistem. Engineer menggunakan metrik untuk memantau kondisi sistem, mengidentifikasi tren, dan memicu pemberitahuan.

Sebelum memulai

Pastikan Anda memiliki hal berikut:

  • Peran Admin Gemini Enterprise atau Google Cloud peran Pengguna Gemini Enterprise konsol.

  • Aplikasi web Gemini Enterprise yang ada. Untuk mengetahui informasi tentang cara membuat aplikasi baru, lihat Membuat aplikasi.

  • Untuk mengakses Metrics Explorer, Anda harus memiliki peran Monitoring Viewer (roles/monitoring.viewer).

  • Aktifkan setelan observabilitas Enable instrumentation of OpenTelemetry traces and logs. Bergantung pada jenis agen, aktifkan setelan ini di konfigurasi tingkat aplikasi (untuk agen Core Assistant) atau di dalam tab Observability agen (untuk agen buatan karyawan Agent Designer dan agen Deep Research). Untuk mengetahui informasi selengkapnya, lihat Mengelola setelan observabilitas.

Retensi data

Metrik yang dihasilkan oleh aplikasi Gemini Enterprise Anda disimpan di Cloud Monitoring di Google Cloud project Anda, dan retensinya diatur oleh Cloud Monitoring. Metrik Gemini Enterprise dipublikasikan dengan awalan discoveryengine.googleapis.com/, yang berada di tingkat "semua metrik Google Cloud lainnya" dan dipertahankan selama 6 minggu secara default. Data yang lebih lama dari periode retensi akan otomatis dihapus. Untuk mengetahui nilai retensi yang resmi dan terbaru, lihat Retensi data dalam dokumentasi kuota dan batas Cloud Monitoring.

Mengakses metrik di Metrics Explorer

Untuk mengakses metrik, ikuti langkah-langkah berikut:

  1. Di Google Cloud konsol, buka halaman Metrics Explorer.

    Buka Metrics Explorer

  2. Pilih Google Cloud project tempat aplikasi Gemini Enterprise Anda dibuat.

  3. Klik Select a metric untuk membuka kotak penelusuran.

  4. Di kotak penelusuran, cari metrik berikut:

    Nama Metrik Deskripsi
    Gemini Enterprise Agent - Gemini Enterprise Agent Session Count Jumlah sesi yang ditangani oleh Agen Gemini Enterprise.
    Gemini Enterprise Agent - Gemini Enterprise Agent Tool Count Jumlah frekuensi alat dipanggil oleh Agen Gemini Enterprise.
    Gemini Enterprise Agent - Gemini Enterprise Agent Turn Count Jumlah giliran percakapan dalam sesi Agen Gemini Enterprise.
    Gemini Enterprise Agent - Gemini Enterprise Agent Total Latency Total latensi respons dari Agen Gemini Enterprise.
    Gemini Enterprise Agent - Gemini Enterprise Agent Tool Total Latency Total latensi yang terjadi akibat eksekusi alat dalam Agen Gemini Enterprise.
    Gemini Enterprise DataConnector - Gemini Enterprise DataConnector Request Count Jumlah total permintaan yang dibuat ke konektor data Gemini Enterprise (juga disebut sebagai penyimpanan data di konsol Google Cloud ).

  5. Pilih metrik yang ingin Anda jelajahi, lalu klik Apply.

  6. Secara opsional, tetapkan filter label tambahan, elemen agregasi, dan sesuaikan rentang waktu.

    Screenshot Metrics Explorer di konsol Google Cloud , yang menampilkan metrik Agen Gemini Enterprise.

Mengakses metrik untuk agen

Anda juga dapat melihat dasbor metrik operasional, khusus alat, dan sesi langsung untuk setiap agen di tab Metrics agen di Google Cloud konsol.

Untuk mengakses metrik untuk agen:

  1. Di Google Cloud konsol, buka aplikasi Anda, lalu klik Agents.
  2. Pilih agen yang ingin Anda periksa, lalu klik tab Metrics.

Tab Metrics menyediakan telemetri operasional utama yang dibagi menjadi dua tampilan: Overview dan Tools.

Metrik ringkasan

Tampilan ini menyediakan dasbor yang meringkas data kesehatan sesi dan agen standar, yang mencakup:

  • Sesi: Jumlah total sesi pengguna.
  • Avg. time per session: Waktu rata-rata yang berlalu selama sesi.
  • Agent invocations: Total frekuensi agen dipanggil.
  • Latensi agen: Latensi dari waktu ke waktu dan metrik tertentu.
  • Agent traffic: Volume permintaan masuk.
  • Agent error rate: Persentase frekuensi agen yang gagal.

Screenshot tab Ringkasan Metrik di konsol Google Cloud , yang menampilkan sesi, rata-rata giliran per sesi, dan pemanggilan agen, latensi, traffic, dan tingkat error

Metrik alat

Tampilan ini berfokus secara khusus pada penggunaan dan latensi alat yang terhubung ke agen Anda, yang mencakup:

  • Total calls: Jumlah permintaan eksekusi alat.
  • P95 duration by tool: Latensi persentil ke-95 dari eksekusi, yang dikategorikan menurut alat.
  • Jumlah panggilan berdasarkan alat: Jumlah total panggilan yang dibagi di antara berbagai alat.
  • Error rate by tool: Tingkat kegagalan eksekusi menurut alat.
  • "No tool called" rate: Tingkat interaksi yang tidak memicu eksekusi alat apa pun.

Langkah berikutnya