Developer Hub 的 Request logs 索引標籤會顯示貴組織的 /v1 API 流量:上方為過去 24 小時的摘要統計資料(包含要求數量、錯誤率及受速率限制的要求),下方則為可搜尋的個別要求記錄。
每筆項目記錄的內容
記錄表格會顯示每次呼叫的時間、HTTP 方法、路徑、回應狀態、原則決策、延遲時間及要求 ID。開啟項目後可檢視完整詳細資料,包括發出該呼叫的服務帳戶與 API 金鑰、來源 IP,以及當時生效的權限。
原則決策會說明該要求的處理方式:
- Allowed:要求已通過驗證與授權。
- Denied:要求遭到拒絕,例如金鑰缺少必要權限、已過期或已遭撤銷。
- Rate limited:要求超出要求額度,並以
429 拒絕。請參閱速率限制。
篩選與搜尋
您可依服務帳戶、API 金鑰、HTTP 方法、狀態類別(2xx–5xx)、原則決策、時間範圍或路徑前置詞(例如 /v1/entities)縮小記錄範圍。
依要求 ID 追蹤錯誤
每個 API 回應都會帶有 Request-Id 標頭,而每個錯誤內文的 request_id 欄位也會帶有相同的值。將該值貼到要求記錄搜尋中,即可直接跳至相符的項目,並確切了解該要求是如何處理的。
當整合回報錯誤時,請向對方索取錯誤回應中的 request_id。這是從客戶端所見症狀追溯到實際處理紀錄最快的途徑,也是您聯絡 Living Security 支援團隊時應提供的值。
及早發現問題
- 錯誤率上升,通常表示金鑰已過期、遭撤銷,或失去所需的權限;請依決策篩選,找出發生失敗的憑證。
- 受速率限制的數量上升,表示某個工作負載執行過於頻繁;請參閱速率限制以了解平滑流量的策略。
- 若原本應處於閒置狀態的服務帳戶出現流量,請檢查其憑證是否存放在您預期的位置,並在調查期間停用該帳戶。