Log Audit
Fitur log audit menentukan peristiwa operasi terstruktur dalam cakupan akun untuk riwayat eksekusi dan pemecahan masalah. Ini memberi Anda jejak yang dapat diandalkan tentang siapa yang melakukan apa dan apa yang terjadi selanjutnya.
Mengapa Ini Penting
Fitur ini mempertahankan jejak yang dapat diaudit di seluruh operasi kredensial, tugas, pekerjaan, dan email sehingga tinjauan insiden didasarkan pada riwayat eksekusi yang konkret. Ini menggabungkan akses cakupan akun dengan kolom log yang dapat dicari dan operasi pembersihan eksplisit untuk menjaga keandalan diagnostik dari waktu ke waktu.
Aliran Inti
Tindakan operasional mengeluarkan peristiwa log terstruktur dengan bidang subjek dan tindakan, yang diminta oleh operator melalui daftar dan rute pencarian selama pemecahan masalah. Pembacaan log mendetail dan panggilan pembersihan terbatas tetap menjadi operasi eksplisit.
Operasi
| Operasi | Endpoint | Tujuan |
|---|---|---|
| Buat catatan | POST /api/accounts/:account_id/logs | Tulis acara operasi terstruktur |
| Daftar log | GET /api/accounts/:account_id/logs | Ambil aliran log akun |
| Log pencarian | POST /api/accounts/:account_id/logs/search | Log kueri berdasarkan kriteria peristiwa |
| Hapus log dengan pencarian | POST /api/accounts/:account_id/logs/search-delete | Pembersihan massal log yang cocok |
| Dapatkan catatan | GET /api/logs/:log_id | Ambil satu entri log |
| Hapus catatan | DELETE /api/logs/:log_id | Hapus satu entri log |
Data dan Status Utama
{
id: "log_...",
account_id: "acc_...",
subject: "job",
action: "retry",
status: "failed",
data: { job_id: "job_...", error_code: "provider_timeout" }
}Mode dan Kontrol Kegagalan
Cakupan atau otorisasi akun yang hilang menolak pembacaan dan penulisan log, dan penghapusan pencarian tetap eksplisit dan mencakup cakupan akun untuk mencegah penghapusan luas yang tidak disengaja. Bidang terstruktur mempertahankan detail kegagalan untuk proses debug deterministik, sementara endpoint pengambilan tetap hanya baca dan terpisah dari rute mutasi.