訪問日志 · ENVOY 智能代理中文參考文檔

## 訪問日志 ### 配置訪問日志是[HTTP連接管理器](../Configurationreference/HTTPconnectionmanager.md)或[TCP代理配置](../Configurationreference/Networkfilters/TCPproxy.md)的一部分。 - [v1 API 參考](../v1APIreference/Accesslogging.md) - [v2 API 參考](../v2APIreference/Filters/Commonaccesslogtypes.md) ### 格式規則訪問日志格式字符串包含命令操作符或解釋為普通字符串的其他字符。訪問日志格式化程序不會做任何換行分隔符（如：“\n”），因此必須將其指定為格式字符串的一部分。請參閱示例的[默認格式](#默認格式)。請注意，訪問日志行將為每個未設置/空值包含一個“-”字符。訪問日志的有些字段使用相同的格式字符串（如：HTTP和TCP）。有些字段的含義可能略有不同，具體取決于它是什么類型的日志。注意差異。支持以下命令操作符： - **%START_TIME%** **HTTP** 請求開始時間，包括毫秒 **TCP** 下游連接開始時間，包括毫秒 - **%BYTES_RECEIVED%** **HTTP** 收到主體字節 **TCP** 下行流連接時收到的字節 - **%PROTOCOL%** **HTTP** 協議，目前是HTTP/1.1或HTTP/2 **TCP** 未實現（”-”） - **%RESPONSE_CODE%** **HTTP** HTTP響應代碼。請注意，響應代碼“0”表示服務器從未發送響應的開始。這通常意味著（下游）客戶端連接斷開了。 **TCP** 未實現（”-”） - **%BYTES_SENT%** **HTTP** 正文發送的字節 **TCP** 在連接上發送到下行流字節 - **%DURATION%** **HTTP** 請求從開始時間到最后一個字節輸出的總持續時間（以毫秒為單位） **TCP** 下游連接的總持續時間（以毫秒為單位） - **%RESPONSE_FLAGS%** 有關響應或連接的其他詳細信息（如果有）。對于TCP連接，說明中提到的響應碼不適用。可能的值是： **HTTP and TCP** UH：除503響應碼外，上游群集中沒有健康的上游主機 UF：除503響應代碼外，上游連接失敗 UO：除503響應碼外，上行溢出（斷路） NR：除404響應碼外，沒有為的請求配置可用路由 **HTTP only** LH：除503響應碼之外，本地服務失敗的健康檢查請求 UT：除了504響應代碼之外，上游請求超時 LR：除503響應碼外，連接本地復位 UR：除503響應碼外，還有上行遠程復位 UC：除503響應碼之外的上游連接終止 DI：請求處理延遲了故障注入指定的時間 FI：請求被中止，并通過故障注入指定響應代碼 RL：該請求除了429響應代碼之外，還由HTTP速率限制過濾器進行本地速率限制 - **%UPSTREAM_HOST%** 上游主機URL（例如：TCP連接或者tcp://ip:port） - **%UPSTREAM_CLUSTER%** 上游主機所屬的上游集群 - **%UPSTREAM_LOCAL_ADDRESS%** 上游連接的本地地址 - **%DOWNSTREAM_ADDRESS%** 下游連接的遠端地址 - **%REQ(X?Y):Z%** **HTTP** 一個HTTP請求頭部，其中X是主HTTP頭部，Y是替代頭部，而Z是一個可選參數，表示截取長度為Z個字符的字符串。該值取自名為X的HTTP請求頭部，如果未設置，則使用請求頭部Y. 如果不存在，則使用“-”符號替代 **TCP** 未實現（”-”） - **%RESP(X?Y):Z%** **HTTP** 與`%REQ(X?Y):Z%`相同，但是來自HTTP響應頭 **TCP** 未實現（”-”） ### 默認格式如果未指定自定義格式，Envoy將使用以下默認格式： ``` [%START_TIME%] "%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%" %RESPONSE_CODE% %RESPONSE_FLAGS% %BYTES_RECEIVED% %BYTES_SENT% %DURATION% %RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)% "%REQ(X-FORWARDED-FOR)%" "%REQ(USER-AGENT)%" "%REQ(X-REQUEST-ID)%" "%REQ(:AUTHORITY)%" "%UPSTREAM_HOST%"\n ``` 默認訪問日志格式的示例： ``` [2016-04-15T20:17:00.310Z] "POST /api/v1/locations HTTP/2" 204 - 154 0 226 100 "10.0.35.28" "nsq2http" "cc21d9b0-cf5c-432b-8c7e-98aeb7988cd2" "locations" "tcp://10.0.2.1:80" ``` ## 返回 - [上一級](../Configurationreference.md) - [首頁目錄](../README.md)