日志投遞功能是云原生網關結合阿里云日志服務SLS提供的服務。開啟日志投遞后,您可以通過分析云原生網關的訪問日志了解客戶端用戶行為、客戶端用戶的地域分布,以便排查問題。本文介紹如何為MSE云原生網關開啟日志投遞。
前提條件
MSE產品不收取日志費用,但日志服務SLS將根據您的使用量收費。關于SLS的計費方式,請參見按量付費。
開啟日志投遞
登錄MSE網關管理控制臺,并在頂部菜單欄選擇地域。
在左側導航欄,選擇云原生網關 > 網關列表,單擊目標網關名稱。
在左側導航欄,單擊參數配置。在可觀測性參數區域,單擊日志投遞右側的編輯按鈕,在日志投遞配置對話框中打開啟用日志投遞(開啟后網關的訪問日志會投遞到日志服務)開關。
開啟日志投遞以后,在可觀測性參數區域,單擊Project右側的鏈接,系統會自動跳轉到該網關對應投遞的日志庫。更多內容,請參見查詢和分析日志。
日志投遞字段說明
網關日志投遞涉及到的字段說明如下。
字段名 | 類型 | 含義 |
__time__ | long | 日志產生的時間。 |
cluster_id | string | 購買的網關實例。 |
authority | string | 請求報文中的Host Header。 |
bytes_received | long | 請求的Body大小(不包含Header)。 |
bytes_sent | long | 響應的Body大小(不包含Header)。 |
downstream_local_address | string | 網關Pod地址。 |
downstream_remote_address | string | 連接到網關的Client端地址。 |
duration | long | 請求整體耗時。單位:ms。 |
method | string | HTTP方法。 |
path | string | HTTP請求中的Path。 |
protocol | string | HTTP的協議版本。 |
request_id | string | 網關會為每次請求產生一個ID,并放在Header的 |
requested_server_name | string | SSL連接時使用的Server Name。 |
response_code | long | HTTP響應的狀態碼。 |
response_flags | string | 響應失敗的原因。 |
route_name | string | 路由名。 |
start_time | string | 請求開始時間。格式:UTC。 |
trace_id | string | Trace ID。 |
upstream_cluster | string | 上游集群。 |
upstream_host | string | 上游IP。 |
upstream_local_address | string | 本地連接上游的地址。 |
upstream_service_time | long | 上游服務處理請求的耗時(毫秒),包括網關訪問上游服務的網絡耗時和上游服務自身處理耗時兩部分。 |
upstream_transport_failure_reason | string | 上游鏈接失敗的原因。 |
user_agent | string | HTTP Header中的UserAgent。 |
x_forwarded_for | string | HTTP Header中的 |
請求失敗原因說明
請求失敗的原因主要通過日志中Response_Flag
的值判斷。以下是關于Response_Flag
不同值的說明。
下游指客戶端,上游指后端服務。
UH:上游集群中,沒有健康的上游主機。
UF:上游連接失敗。
NR:給定請求未配置路由。
URX:請求被拒絕,因為達到了上游重試限制(HTTP)或最大連接嘗試次數(TCP)。
NC:無法找到上游集群。
DT:請求或連接超過了
max_connection_duration
或max_downstream_connection_duration
。DC:下游連接終止。
LH:本地服務未通過健康檢查請求。
UT:上游請求超時。
LR:連接本地重置。
UR:上游遠程重置。
UC:上游連接終止。
DI:請求處理被延遲一段時間,該延遲時間由故障注入指定。
FI:請求被故障注入指定的響應碼中止。
RL:請求在本地被HTTP速率限制過濾器限制,除了429響應碼之外。
UAEX:請求被外部授權服務拒絕。
RLSE:請求被拒絕,因為速率限制服務出現錯誤。
IH:請求被拒絕,因為在嚴格檢查的標頭中設置了無效值。
SI:Stream流空閑超時。
DPE:下游請求存在HTTP協議錯誤。
UPE:上游響應存在HTTP協議錯誤。
UMSDR:上游請求達到了最大流程持續時間。
OM:超負荷管理器終止了請求。
DF:請求因DNS解析失敗而終止。