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

## 訪問日志 ### 配置項 ``` { "access_log": [ { "path": "...", "format": "...", "filter": "{...}", }, ] } ``` - **path** (required, string) 寫入訪問日志的路徑。 - **format** (optional, string) 訪問日志格式。Envoy支持[自定義訪問日志格式](../Configurationreference/Accesslogging.md)以及[默認格式](../Configurationreference/Accesslogging.md)。 - **filter** (optional, object) 用于明確是否需要寫入的訪問日志過濾器。 ### 過濾器 Envoy支持以下訪問日志過濾器： - [Status code](#status-code) - [Duration](#duration) - [Not health check](#not-health-check) - [Traceable](#traceable) - [Runtime](#runtime) - [And](#and) - [Or](#or) ### Status code ``` { "filter": { "type": "status_code", "op": "...", "value": "...", "runtime_key": "..." } } ``` 基于HTTP響應/狀態代碼的過濾器。 - **op** (required, string) 比較運算符。目前僅支持`>=`和`=`運算符。 - **value** (required, integer) 如果運行時值不可用，則使用默認值進行比較。 - **runtime_key** (optional, string) 運行時的key，用于獲取比較值。如果定義，則使用此值。 ### Duration ``` { "filter": { "type": "duration", "op": "..", "value": "...", "runtime_key": "..." } } ``` 請求持續的總時間過濾器，以毫秒為單位。 - **op** (required, string) 比較運算符。目前僅支持`>=`和`=`運算符。 - **value** (required, integer) 如果運行時值不可用，則使用默認值進行比較。 - **runtime_key** (optional, string) 運行時的key，用于獲取比較值。如果定義，則使用此值。 ### Not health check ``` { "filter": { "type": "not_healthcheck" } } ``` 篩選健康檢查失敗的請求。健康檢查的請求由健康檢查過濾器進行標記。 ### Traceable ``` { "filter": { "type": "traceable_request" } } ``` 篩選可跟蹤的請求。請參閱[跟蹤概述](../Introduction/Architectureoverview/Tracing.md)，以獲取有關請求如何使能跟蹤的詳細信息。 ### Runtime ``` { "filter": { "type": "runtime", "key" : "..." } } ``` 使用隨機采樣請求。在`x-request-id`頭存在的情況下進行采樣。如果存在`x-request-id`，則過濾器將根據運行時鍵值和從`x-request-id`提取的值在多個主機上持續采樣。如果缺失，過濾器將根據運行時鍵值隨機采樣。 - **key** (required, string) 通過運行時key獲取要采樣的請求的百分比。此運行時值控制在`0-100`范圍內，默認為0。 ### And ``` { "filter": { "type": "logical_and", "filters": [] } } ``` 對過濾器中每個過濾器的結果執行邏輯"和"運算。過濾器將按順序進行評估，如果其中一個返回false，則過濾器立即返回false。 ### Or ``` { "filter": { "type": "logical_or", "filters": [] } } ``` 對每個單獨的過濾器的結果執行邏輯"或"操作。過濾器將按順序進行評估，如果其中一個返回true，則過濾器會立即返回true。 ## 返回 - [上一級](../v1APIreference.md) - [首頁目錄](../README.md)