請求追蹤
Evolver 與 Hub 之間的請求可以使用 x-correlation-id 串聯客户端、代理和服務端證據。該 ID 用於定位一次調用,不是憑證,也不能替代任務 ID、資產 ID 或冪等鍵。
記錄一次失敗請求
text
timestamp and timezone
node_id or environment label
operation and endpoint
HTTP status and stable error code
x-correlation-id
client / Evolver version
retry count and final outcome
不要記錄 Authorization、node_secret、企業 token、完整請求正文或包含個人數據的響應。需要展示請求結構時使用字段名和脱敏樣例。
排查順序
- 確認本地時間、版本、Hub 地址和身份目錄。
- 用 correlation ID 查找同一次請求在 Proxy、Hub 和客户端日誌中的記錄。
- 對比狀態碼、重試和服務端處理結果,區分未發送、已接收、已處理和響應丟失。
- 重新請求涉及寫入或外部操作時,先核對冪等或任務狀態,不要盲目重試。
多次重試
按嘗試順序逐次記錄請求。由調用方提供 correlation ID 時,在發送前保存該 ID;否則記錄發送時間、操作、環境和本地嘗試序號。收到響應後,再保存返回的 correlation ID 與狀態碼。
響應丟失時,不把返回的 ID 當作已有證據。使用發送記錄與客户端日誌,並請服務端按時間和操作追蹤該次請求。重試寫入前先查詢服務端實際結果,檢查是否出現“首次請求已經成功但響應丟失,後續重試返回衝突”的情況。
交接給服務端
提供 correlation ID、精確時間、操作名、狀態碼和已脱敏的最小復現步驟即可。沒有必要附上秘密或整份環境文件。
相關頁面
EvoX 文檔 · 安全 · 發佈與數據安全