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.
Memastikan 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 observasi untuk melihat log error konektor gabungan. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan setelan kemampuan observasi.
Mengakses log error konektor gabungan
Untuk melihat log error penyimpanan data Anda yang terhubung ke Gemini Enterprise menggunakan penggabungan 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 View Logs. Tindakan ini akan membuka halaman Logs Explorer.
Untuk hanya melihat log konektor Gemini Enterprise, masukkan kueri berikut di kolom editor kueri, lalu klik Run Query:
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 All severities, lalu pilih Error and higher. Untuk mengetahui informasi selengkapnya tentang cara menyaring kueri, lihat Contoh kueri.
Mengakses log error konektor penyerapan
Untuk melihat log error penyimpanan data Anda 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 View Logs. Tindakan ini akan membuka halaman Logs Explorer.
Secara default, halaman Logs Explorer menelusuri resource yang tercantum dalam cakupan log default untuk entri log. Untuk memfilter ke log Gemini Enterprise, lakukan salah satu hal berikut:
- Pilih All Resources > Consumed API > Discovery Engine API, lalu klik Apply.
Masukkan kode berikut ke dalam kotak kueri, lalu klik Run Query:
resource.type="consumed_api" resource.labels.service="discoveryengine.googleapis.com"
Persempit cakupan kueri Anda dengan memfilter metadata JSON. Misalnya, untuk membuat kueri log metode
ImportDocuments, lakukan salah satu hal berikut:Masukkan perintah berikut ke dalam kotak kueri:
jsonPayload.context.reportLocation.functionName=~"ImportDocuments"Luaskan metadata JSON, lalu klik untuk memfilter:
Gambar 1. Filter 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 informasinya, lihat Merutekan log ke tujuan yang didukung dalam dokumentasi Google Cloud Observability.