Cloudflare AI Gateway 日誌設定應從團隊需要的證據和不應保留的內容開始。儀表板讓請求可見的同時，也可能建立新的提示詞、回應和後設資料儲存。正確設定取決於維運用途，以及帳戶目前適用的日誌契約。
先確定閘道器使用目前 Workers Logs 安排還是 Legacy Logs，再有意識地設定收集與載荷儲存。透過帶合成標記的真實請求路徑測試，檢查產生的記錄。在適當時保留有用維運後設資料，但不要假設關閉載荷儲存就能從所有其他系統刪除資料。
設想客服助手的提示詞包含客戶往來。工程師需要診斷供應商故障並歸因用量，卻未必需要將全部往來複製到通用診斷儲存。這是設定和證據問題，並不意味著需要放棄可觀察性。
本文關注建議的維運設定，不提供法律合規認證，也不假定每個帳戶具有相同價格、保留和匯出安排。
Cloudflare AI Gateway 日誌設定取決於資格
目前 AI Gateway 日誌文件 根據客戶建立首個閘道器的時間進行區分。首個閘道器在 2026 年 9 月 24 日或之後建立的客戶，採用 Workers Logs 價格與保留安排；更早的客戶使用 Legacy Logs。應核實正在設定的帳戶適用哪種資格。
不要從舊文章抄取保留期或日誌額度，再應用到所有部署。記錄適用服務安排、選定設定與檢查日期。帳戶或日誌架構變化時應重新核實。
同一文件將完整日誌條目的收集，與請求和回應載荷的儲存分開。這種區別比簡單詢問日誌開啟或關閉更精確。
| 決策 | 需要確定的問題 |
|---|---|
| 日誌安排 | 此帳戶適用哪種目前或舊契約？ |
| 完整條目收集 | 此類請求是否應存在診斷記錄？ |
| 載荷儲存 | 是否必須保留提示詞和回應內容？ |
| 存取 | 誰可以檢查或匯出記錄？ |
| 保留 | 主要副本和匯出副本何時過期？ |
先定義事故問題
寫下維運人員必須回答的問題：哪個負載失敗？使用了哪條供應商和模型路徑？應用是否重試？使用者停止等待前是否返回回應？目標任務是否仍未解決？
許多問題可透過有限後設資料和應用操作編號回答，不一定需要完整提示詞。反過來，內容品質調查可能需要經過明確控制的樣本，通用請求後設資料無法解釋這種問題。
將這些用途分開。客服應用常規診斷可以遵循一種收集策略，獲准調查則使用另一種經過複核的證據流程。不要僅因某天可能有助重現缺陷，就永久保留每位客戶的文字。
我們已有的 AI Gateway 指南 介紹更廣泛的代理與成本控制角色。本文設定工作的重點，是確定實際存在什麼證據，並證明選定收集行為。
分別設定完整條目與載荷控制
Cloudflare 文件以 cf-aig-collect-log 控制完整條目收集，以 cf-aig-collect-log-payload 控制請求和回應載荷儲存。將載荷控制設為 false，可以保留後設資料而不儲存原始正文；關閉完整條目則會抑制包括後設資料在內的整個條目。應用前應閱讀目前標頭語義。
以下只是示意性標頭策略，並非完整請求，也不能證明部署結果：
1cf-aig-collect-log-payload: false
在可信應用元件中實施策略。不可信呼叫者不應透過注入任意閘道器控制標頭，改變組織證據策略。確定哪些標頭由伺服器轉發、設定或移除。
不要根據單次成功請求推斷預設值。分別驗證閘道器級設定與逐請求覆蓋路徑。適用於主模型路徑的設定，經過回退或另一用戶端時仍可能表現不同。
記錄實際生效策略
對應用側設定進行版本管理，並記錄相關閘道器設定。說明哪些請求類別保留載荷，哪些只保留後設資料，哪些完全抑制收集。
開發者新增另一模型整合時，複核應包含其日誌路徑。否則，應用會積累多條保留行為不同的路徑，而團隊仍以為只有一種全域策略。
不要讓後設資料變成另一種載荷
不透明任務和請求編號可以將閘道器證據與應用記錄連線起來。客服案例識別碼可能足以按現有存取模型定位來源。把訊息主題或客戶郵箱複製到後設資料欄位，會破壞排除提示詞正文的初衷。
定義允許的後設資料模式。除了欄位名，也檢查值。如果應用用使用者文字填充，名為 label 的欄位仍會包含個人或機密內容。
| 後設資料選擇 | 維運用途 | 複核關注點 |
|---|---|---|
| 不透明負載識別碼 | 將用量歸因到應用功能 | 避免嵌入客戶內容 |
| 操作編號 | 將事故關聯到任務狀態 | 關聯記錄仍受存取控制 |
| 設定版本 | 重現實際生效路徑 | 值中不能包含機密資訊 |
| 故障類別 | 對可處理問題分組 | 避免含來源內容的原始異常載荷 |
保持應用與閘道器編號足夠一致，以支援調查。維運人員應無需在工具間複製整個提示詞，也無需給所有工程師客戶系統存取權，就能追蹤故障。
用合成標記驗證收集
傳送包含獨特標記的非敏感測試請求。檢查適用日誌目標，確認在預期策略下，標記是否出現在載荷儲存、後設資料、匯出或相關應用日誌中。
測試正常回應、上游錯誤，以及應用使用的回退路徑。錯誤處理經常會在正常收集路徑之外，將請求正文複製到診斷欄位。
| 測試 | 僅後設資料策略下的預期證據 |
|---|---|
| 正常推理 | 有用請求後設資料，不含合成正文標記 |
| 供應商錯誤 | 故障類別和關聯編號，不複製載荷 |
| 應用重試 | 可以關聯各次嘗試，不在標籤中重複內容 |
| 未授權閘道器請求 | 按閘道器存取策略拒絕 |
| 匯出或下游日誌目標 | 仍遵循商定內容與保留策略 |
Cloudflare 的認證閘道器文件 是該存取控制的依據。檢查部署中的實際憑據與路徑，不要假設日誌設定同時保護端點。
複核匯出和其他儲存
閘道器抑制載荷，並不能證明應用、模型供應商或外部可觀察性服務完全不保留內容。繪製真實資料路徑，按各儲存自己的契約複核。
如果匯出日誌，記錄誰能讀取目標、這些副本何時過期。從某項服務刪除記錄，不能證明更早匯出也已移除。維運手冊應說明哪個系統負責哪種證據。
也複核追蹤、異常追蹤器和客服截圖。團隊可能正確設定閘道器，卻仍將客戶提示詞貼上到更廣泛群體可見的工單中。
常規迴歸測試使用合成案例。確需真實內容調查缺陷時，應確立具體收集目的與受控存取，而不是不留記錄地改變通用策略。
為有用證據及其維護編制預算
實施成本包括資料路徑複核、請求策略接線、後設資料模式、權限設定與驗證。持續成本取決於適用日誌安排、數量及下游儲存，因此估算前應核實帳戶目前費率。
要求 GBP 方案報價，標識閘道器安排與交付測試。只設定設定，與重建跨多條模型路徑和匯出目標的應用日誌，是不同任務。
交接應包含實際策略、責任歸屬、合成測試結果，以及調查證據缺失的流程。列出觸發重新驗證的設定變化，尤其是新用戶端、路徑或日誌目標。
我們可以透過範圍明確的 AI 整合試點 複核這一邊界。請提供帳戶資格、模型路徑、目前日誌目標和事故問題，索取閘道器日誌評估 。讓可觀察性真正有用，而不是僅因預設允許就收集內容。
常見問題
所有 AI Gateway 帳戶採用相同日誌安排嗎？ 不是。目前文件區分首個閘道器在 2026 年 9 月 24 日或之後建立的客戶與更早客戶。依賴價格或保留假設前，核實適用 Workers Logs 還是 Legacy Logs。
可以保留後設資料而不保留提示詞和回應正文嗎？ 適當設定時，文件規定的載荷收集控制支援僅後設資料條目。應驗證實際閘道器和逐請求策略，並檢查真實日誌目標中的測試結果。
兩個收集標頭有什麼區別？ 完整條目控制決定是否收集日誌條目，載荷控制決定是否儲存原始請求和回應正文，同時可以保留後設資料。關閉完整條目也會刪除其後設資料，因此應根據所需證據選擇。
抑制載荷意味著沒有服務儲存資料嗎？ 不是。其他應用日誌、供應商、匯出和可觀察性工具有自己的行為與契約。應複核完整資料路徑，不要將單個閘道器設定視為普遍保留保證。
不使用客戶資料，如何測試日誌？ 在非敏感請求中使用合成標記，檢查相關記錄與匯出。包含正常結果、錯誤、重試和回退路徑，並確認後設資料沒有間接包含標記。
應該允許用戶端選擇日誌策略嗎？ 只有有意授予這種權限時才可以。在可信伺服器元件中實施組織策略，明確接受或覆蓋哪些控制標頭。普通呼叫者不應悄悄改變證據策略。
評估應該交付什麼？ 識別適用契約、資料儲存、實際收集策略、存取負責人和保留決策。包含合成驗證結果，以及檢查新模型路徑或日誌目標的可重複流程。