Usage Logs
Buka di CMSSQL Database Reader mencatat setiap eksekusi query secara otomatis. Setiap entri log merekam pertanyaan asli user, SQL yang dihasilkan, status eksekusi, jumlah baris, dan pesan error jika ada. Gunakan log untuk mengaudit akses data, men-debug query yang gagal, dan memahami pola penggunaan dari waktu ke waktu.
Pencatatan bisa dimatikan per konfigurasi; lihat Query Logging. Selama pencatatan mati, tab ini tetap menampilkan apa yang sudah tercatat sebelumnya, menyatakannya lewat pemberitahuan di bagian atas, dan tidak mencatat apa pun yang baru.
Secara terpisah, jika organization mengaktifkan Mode Privasi, tidak ada query log yang ditulis untuk conversation yang sedang bersifat privat, meskipun Query Logging di atas dinyalakan untuk konfigurasi tersebut.
Buka Tools → Plugins → SQL Database Reader → Logs di sidebar agent.
Ringkasan Log
Tampilan ringkasan menunjukkan jumlah agregat harian untuk konfigurasi plugin.
| Kolom | Deskripsi |
|---|---|
| Date | Hari kalender dalam format yyyy-MM-dd. |
| Total | Jumlah total eksekusi query pada hari itu. |
| Success | Query yang berhasil dieksekusi dan mengembalikan hasil. |
| Failed | Query yang mengalami error saat penerjemahan atau eksekusi. |
Ringkasan memuat hari-hari terbaru terlebih dahulu. Klik Load More untuk melihat entri yang lebih lama.
Melihat Log Detail
Klik sebuah baris tanggal di ringkasan untuk membuka tampilan detail hari tersebut. Setiap baris mewakili satu eksekusi query.
| Field | Deskripsi |
|---|---|
| Time | Timestamp eksekusi query. |
| User ID | User yang mengajukan pertanyaan. |
| Question | Pertanyaan asli berbahasa alami yang dimasukkan user. |
| SQL Query | SQL yang dihasilkan dan dieksekusi oleh plugin, beserta model yang menulisnya ("Written by …"; Qlar default adalah model SQL bawaan Qlar). Entri dari sebelum model dicatat tidak menampilkannya. |
| Status | success atau failed. |
| Row Count | Jumlah baris yang dikembalikan query. |
| Error | Pesan error jika query gagal, kosong jika tidak. |
Gunakan kontrol halaman di bagian bawah untuk menelusuri entri dalam jumlah besar. Maksimal 100 baris dikembalikan per halaman.
Mengunduh Log sebagai CSV
Klik Download CSV pada tanggal mana pun di ringkasan untuk mengekspor semua entri log hari itu sebagai file CSV. Ekspor ini mencakup semua field: timestamp, user ID, pertanyaan, query SQL, status, jumlah baris, dan pesan error.
Ekspor CSV berguna untuk membagikan log ke tim tata kelola data atau memuatnya ke tool analitik eksternal.
Penyebab Status Failed
| Penyebab | Pesan error yang umum |
|---|---|
| SQL tidak valid yang dihasilkan AI | Syntax error near... |
| Nama tabel atau kolom tidak ditemukan | Invalid object name... |
| Timeout eksekusi query | Execution timeout exceeded 30 seconds |
| Koneksi database terputus saat eksekusi | Network error / Connection refused |
| Permission database tidak mencukupi | The SELECT permission was denied on object... |
Saat sebuah query gagal, pertanyaan asli dan SQL yang dicoba tetap dicatat. Tinjau field SQL Query untuk memahami apa yang dihasilkan AI. Jika SQL-nya benar secara sintaks tetapi salah secara logika, perbaiki deskripsi tabel dan kolom di konfigurasi skema. Jika SQL sama sekali tidak bisa dihasilkan, error-nya menunjukkan kegagalan penerjemahan.
Penyimpanan dan Retensi Log
Log disimpan di CosmosDB, dipartisi berdasarkan ID agent, ID konfigurasi, dan hari log. Setiap entri kedaluwarsa otomatis 30 hari setelah ditulis, sehingga tab ini selalu mencakup kurang lebih satu bulan terakhir, bukan seluruh riwayat plugin.
Jika Anda membutuhkan catatan yang bertahan lebih lama dari periode tersebut, unduh log hari itu sebagai CSV sebelum kedaluwarsa.
Halaman Terkait
- Testing Queries: reproduksi query yang gagal di lingkungan pengujian yang aman.
- Configure Tables and Columns: perbaiki deskripsi skema untuk mengurangi kegagalan penerjemahan.
- Overview SQL Database Reader