Mengakses log error konektor Gemini Enterprise dengan Cloud Logging

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 observabilitas di Gemini Enterprise.

Konsep	Deskripsi
Log error konektor Gemini Enterprise	Log error konektor Gemini Enterprise menangkap error dan kegagalan 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 Admin Gemini Enterprise (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 observabilitas untuk melihat log error konektor gabungan. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan setelan observabilitas.

Mengakses log error konektor gabungan

Istilah Kunci: Di Gemini Enterprise, istilah aplikasi dapat digunakan secara bergantian dengan istilah mesin dalam konteks API. Mesin Gemini Enterprise adalah mesin penelusuran umum dengan kolom app_type yang ditetapkan ke APP_TYPE_INTRANET.

Untuk melihat log error penyimpanan data yang terhubung ke Gemini Enterprise menggunakan gabungan data, ikuti langkah-langkah berikut:

1. Di Google Cloud konsol, buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Di menu navigasi, klik Penyimpanan Data.

3. Pilih penyimpanan data yang Anda inginkan.

4. Klik Lihat Log. Tindakan ini akan membuka halaman Logs Explorer.

5. 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. Misalnya, global.
   • COLLECTION_ID: ID koleksi yang berisi konektor Anda, yang juga merupakan ID penyimpanan data di Google Cloud konsol.

6. Persempit cakupan kueri Anda menggunakan filter. Misalnya, klik Semua tingkat keparahan, lalu pilih Error dan lebih tinggi. Untuk mengetahui informasi selengkapnya tentang cara mempersempit kueri, lihat Contoh kueri.

Mengakses log error konektor penyerapan

Istilah Kunci: Di Gemini Enterprise, istilah aplikasi dapat digunakan secara bergantian dengan istilah mesin dalam konteks API. Mesin Gemini Enterprise adalah mesin penelusuran umum dengan kolom app_type yang ditetapkan ke APP_TYPE_INTRANET.

Untuk melihat log error penyimpanan data yang terhubung ke Gemini Enterprise menggunakan penyerapan data, ikuti langkah-langkah berikut:

1. Di Google Cloud konsol, buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Di menu navigasi, klik Penyimpanan data.

3. Pilih penyimpanan data yang Anda inginkan.

4. Klik Lihat Log. Tindakan ini akan membuka halaman Logs Explorer.

5. 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 Semua Resource > API yang Digunakan > Discovery Engine API, lalu klik Terapkan.

   • Masukkan hal berikut ke kolom kueri, lalu klik Jalankan Kueri:

     resource.type="consumed_api"
     resource.labels.service="discoveryengine.googleapis.com"
     

6. Persempit cakupan kueri Anda dengan memfilter metadata JSON. Misalnya, untuk membuat kueri log metode ImportDocuments, lakukan salah satu hal berikut:

   • Masukkan hal berikut ke kolom kueri:

     jsonPayload.context.reportLocation.functionName=~"ImportDocuments"
     

   • Luaskan metadata JSON, lalu klik untuk memfilter:

     

     Gambar 1. Filter dengan mengklik metadata JSON

7. Untuk sebagian besar peringatan dan error, temukan detailnya di jsonPayload.message dan jsonPayload.status.

8. Untuk analisis log yang lebih mendalam, buang log ke sink log seperti BigQuery. Untuk mengetahui informasi selengkapnya, lihat Merutekan log ke tujuan yang didukung dalam dokumentasi Google Cloud Observability.