審核日誌
審核日誌功能定義了結構化帳戶範圍的操作事件，用於執行歷史記錄和故障排除。 它為您提供可靠的線索，了解誰做了什麼以及接下來發生了什麼。
為什麼這很重要
此功能保留了跨憑證、任務、作業和電子郵件操作的可審核跟踪，因此事件審查基於具體的執行歷史記錄。它將帳戶範圍的存取與可搜尋日誌欄位和明確清理操作相結合，以保持診斷隨著時間的推移而可靠。
核心流程
操作操作發出帶有主題和操作欄位的結構化日誌事件，操作員在故障排除期間透過清單和搜尋路徑進行查詢。詳細的日誌讀取和範圍內的清理呼叫仍然是明確操作。
操作
| 營運 | 端點 | 目的 |
|---|---|---|
| 建立日誌 | POST /api/accounts/:account_id/logs | 編寫結構化操作事件 |
| 列出日誌 | GET /api/accounts/:account_id/logs | 檢索帳戶日誌流 |
| 搜尋日誌 | POST /api/accounts/:account_id/logs/search | 依事件條件查詢日誌 |
| 透過搜尋刪除日誌 | POST /api/accounts/:account_id/logs/search-delete | 批次清理比對日誌 |
| 取得日誌 | GET /api/logs/:log_id | 檢索一個日誌條目 |
| 刪除日誌 | DELETE /api/logs/:log_id | 刪除一個日誌條目 |
關鍵數據和狀態
{
id: "log_...",
account_id: "acc_...",
subject: "job",
action: "retry",
status: "failed",
data: { job_id: "job_...", error_code: "provider_timeout" }
}故障模式與控制
缺少帳戶範圍或授權會拒絕日誌讀取和寫入，並且搜尋刪除保持明確和帳戶範圍，以防止意外廣泛刪除。結構化欄位保留確定性調試的失敗詳細信息，而檢索端點保持只讀狀態並與突變路由分開。