> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 要求記錄

> 從 Developer Hub 追蹤、篩選並疑難排解貴組織的 Living Security Public API 流量。

[Developer Hub](/zh-Hant/developers/developer-hub/overview) 的 **Request logs** 索引標籤會顯示貴組織的 `/v1` API 流量：上方為過去 24 小時的摘要統計資料（包含要求數量、錯誤率及受速率限制的要求），下方則為可搜尋的個別要求記錄。

## 每筆項目記錄的內容

記錄表格會顯示每次呼叫的時間、HTTP 方法、路徑、回應狀態、原則決策、延遲時間及要求 ID。開啟項目後可檢視完整詳細資料，包括發出該呼叫的服務帳戶與 API 金鑰、來源 IP，以及當時生效的權限。

原則決策會說明該要求的處理方式：

* **Allowed**：要求已通過驗證與授權。
* **Denied**：要求遭到拒絕，例如金鑰缺少必要權限、已過期或已遭撤銷。
* **Rate limited**：要求超出要求額度，並以 `429` 拒絕。請參閱[速率限制](/zh-Hant/developers/v1/rate-limits)。

## 篩選與搜尋

您可依服務帳戶、API 金鑰、HTTP 方法、狀態類別（2xx–5xx）、原則決策、時間範圍或路徑前置詞（例如 `/v1/entities`）縮小記錄範圍。

## 依要求 ID 追蹤錯誤

每個 API 回應都會帶有 `Request-Id` 標頭，而每個錯誤內文的 `request_id` 欄位也會帶有相同的值。將該值貼到要求記錄搜尋中，即可直接跳至相符的項目，並確切了解該要求是如何處理的。

<Tip>
  當整合回報錯誤時，請向對方索取錯誤回應中的 `request_id`。這是從客戶端所見症狀追溯到實際處理紀錄最快的途徑，也是您聯絡 Living Security 支援團隊時應提供的值。
</Tip>

## 及早發現問題

* **錯誤率**上升，通常表示金鑰已過期、遭撤銷，或失去所需的權限；請依決策篩選，找出發生失敗的憑證。
* **受速率限制**的數量上升，表示某個工作負載執行過於頻繁；請參閱[速率限制](/zh-Hant/developers/v1/rate-limits)以了解平滑流量的策略。
* 若原本應處於閒置狀態的服務帳戶出現流量，請檢查其憑證是否存放在您預期的位置，並在調查期間[停用該帳戶](/zh-Hant/developers/developer-hub/service-accounts)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.