Usage Logs

Buka di CMS

SQL 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.

KolomDeskripsi
DateHari kalender dalam format yyyy-MM-dd.
TotalJumlah total eksekusi query pada hari itu.
SuccessQuery yang berhasil dieksekusi dan mengembalikan hasil.
FailedQuery 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.

FieldDeskripsi
TimeTimestamp eksekusi query.
User IDUser yang mengajukan pertanyaan.
QuestionPertanyaan asli berbahasa alami yang dimasukkan user.
SQL QuerySQL 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.
Statussuccess atau failed.
Row CountJumlah baris yang dikembalikan query.
ErrorPesan 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

PenyebabPesan error yang umum
SQL tidak valid yang dihasilkan AISyntax error near...
Nama tabel atau kolom tidak ditemukanInvalid object name...
Timeout eksekusi queryExecution timeout exceeded 30 seconds
Koneksi database terputus saat eksekusiNetwork error / Connection refused
Permission database tidak mencukupiThe 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