API Gateway：開啟網關日誌投遞

欄位名

類型

含義

__time__

long

日誌產生的時間。

cluster_id

string

購買的網關執行個體。

ai_log

json

針對Model API/Agent API/MCP API設計的日誌欄位，欄位格式為json。其他類型的API此欄位為空白。

• api: ai api的名稱。

• cache_status: Model API中開啟內容緩衝時該欄位會反映請求是否命中緩衝。

• consumer: 開啟消費者鑒權後，此欄位會記錄當前請求的消費者身份。

• fallback_from: Model API中開啟fallback策略時，此欄位記錄請求從哪一條路由fallback過來。

• input_token: LLM請求輸入token數。

• llm_first_token_duration: LLM請求首包RT。

• llm_service_duration: LLM請求整體RT。

• model: LLM請求的模型名稱。

• output_token: LLM請求輸出token數。

• response_type: LLM請求流式/非流式。

• safechack_status: LLM請求Alibaba Content Security Service檢測狀態。

• token_ratelimit_status: LLM請求是否被限流攔截。

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

請求的整體耗時。包含從網關收到來自下遊的第一個位元組開始，到發送出最後一個響應位元組為止的時間段。單位毫秒。

method

string

HTTP方法。

path

string

HTTP請求中的Path。

protocol

string

HTTP的協議版本。

request_duration

long

從網關收到來自下遊的第一個位元組開始，到收到來自下遊的最後一個位元組為止的時間段。單位毫秒。

request_id

string

網關會為每次請求產生一個ID，並放在Header的x-request-id中，後端可以根據這個欄位記錄並進行排查。

requested_server_name

string

SSL串連時使用的Server Name。

response_code_details

string

提供與響應碼相關的額外資訊。例如via_upstream表示響應碼是由後端服務返回的，route_not_found表示請求沒有匹配的路由。

response_tx_duration

long

從網關收到來自上遊的第一個位元組開始，到給下遊發送出最後一個位元組為止的時間段。單位毫秒。

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中的x-forwarded-for，通常用來表示HTTP請求端真實IP。