Gemini Enterprise menyediakan Cloud Logging bagi pelanggan untuk memantau error dan peringatan saat menghubungkan data mereka dengan Gemini Enterprise.
Dokumen ini menjelaskan cara mengakses log error konektor gabungan dan log error konektor penyerapan untuk Gemini Enterprise menggunakan Cloud Logging.
Konsep utama
Bagian ini memperkenalkan konsep utama terkait kemampuan observasi di Gemini Enterprise.
| Konsep | Deskripsi |
|---|---|
| Log error konektor Gemini Enterprise | Log error konektor Gemini Enterprise mencatat error dan kegagalan yang terjadi saat mengintegrasikan Gemini Enterprise dengan sumber data pihak ketiga seperti Jira dan Microsoft OneDrive. Log ini mencakup masalah koneksi, masalah transformasi data, dan error API. |
Sebelum memulai
Sebelum mengakses log error, pastikan Anda telah melakukan hal berikut:
Untuk mengaktifkan logging, Anda harus memiliki peran IAM Gemini Enterprise Admin (
roles/discoveryengine.agentspaceAdmin).Untuk mengakses Cloud Logging, Anda harus memiliki peran IAM Logs Viewer (
roles/logging.viewer).Membuat aplikasi Gemini Enterprise. Untuk membuatnya, lihat Membuat aplikasi.
Pastikan penyimpanan data Anda dikonfigurasi dengan benar dan aktif. Untuk mengetahui informasi selengkapnya tentang cara menyiapkan penyimpanan data, lihat Menghubungkan sumber data Google atau Menghubungkan sumber data pihak ketiga.
Mengaktifkan setelan kemampuan pengamatan untuk melihat log error konektor gabungan. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan setelan kemampuan pengamatan.
Mengakses log error konektor gabungan
Untuk melihat log error penyimpanan data yang terhubung ke Gemini Enterprise menggunakan federasi data, ikuti langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Gemini Enterprise.
Di menu navigasi, klik Data Stores.
Pilih penyimpanan data pilihan Anda.
Klik Lihat Log. Tindakan ini akan membuka halaman Logs Explorer.
Untuk hanya melihat log konektor Gemini Enterprise, masukkan kueri berikut di kolom editor kueri, lalu klik Jalankan Kueri:
logName="projects/PROJECT_ID/logs/discoveryengine.googleapis.com%2Fconnector_activity" jsonPayload.LogMetadata.name="projects/PROJECT_ID/locations/LOCATION/collections/COLLECTION_ID/dataConnector"Ganti kode berikut:
PROJECT_ID: ID project Anda.LOCATION: lokasi konektor Anda. Contoh,global.COLLECTION_ID: ID koleksi yang berisi konektor Anda, yang juga merupakan ID penyimpanan data di konsolGoogle Cloud .
Persempit cakupan kueri Anda menggunakan filter. Misalnya, klik Semua tingkat keparahan, lalu pilih Error dan yang lebih tinggi. Untuk mengetahui informasi selengkapnya tentang memperbaiki kueri, lihat Contoh kueri.
Mengakses log error konektor penyerapan
Untuk melihat log error penyimpanan data yang terhubung ke Gemini Enterprise menggunakan penyerapan data, ikuti langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Gemini Enterprise.
Di menu navigasi, klik Penyimpanan data.
Pilih penyimpanan data pilihan Anda.
Klik Lihat Log. Tindakan ini akan membuka halaman Logs Explorer.
Secara default, halaman Logs Explorer menelusuri entri log untuk resource yang tercantum dalam cakupan log default. Untuk memfilter log Gemini Enterprise, lakukan salah satu hal berikut:
- Pilih All Resources > Consumed API > Discovery Engine API, lalu klik Apply.
Masukkan perintah berikut ke kolom kueri, lalu klik Run Query:
resource.type="consumed_api" resource.labels.service="discoveryengine.googleapis.com"
Persempit cakupan kueri dengan memfilter metadata JSON. Misalnya, untuk membuat kueri log metode
ImportDocuments, lakukan salah satu hal berikut:Masukkan kode berikut ke dalam kolom kueri:
jsonPayload.context.reportLocation.functionName=~"ImportDocuments"Luaskan metadata JSON, lalu klik untuk memfilter:
Gambar 1. Memfilter dengan mengklik metadata JSON
Untuk sebagian besar peringatan dan error, temukan detailnya di
jsonPayload.messagedanjsonPayload.status.Untuk analisis log yang lebih mendalam, buang log ke sink log seperti BigQuery. Untuk mengetahui informasi, lihat Merutekan log ke tujuan yang didukung dalam dokumentasi Google Cloud Observability.