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: コンシューマー認証が有効になっている場合、このフィールドは現在のリクエストのコンシューマーの ID を記録します。

• fallback_from: Model API でフォールバックポリシーが有効になっている場合、このフィールドはリクエストがフォールバックしたルートを記録します。

• input_token: LLM リクエストの入力トークン数。

• llm_first_token_duration: LLM リクエストの最初のパケットの応答時間 (RT)。

• llm_service_duration: LLM リクエストの全体的な RT。

• model: LLM リクエストのモデル名。

• output_token: LLM リクエストの出力トークン数。

• response_type: ストリーミングや非ストリーミングなど、LLM リクエストの応答タイプ。

• safecheck_status: LLM リクエストの Content Moderation ステータス。

• token_ratelimit_status: LLM リクエストがトークンベースのレート制限によってブロックされたかどうかを示します。

authority

string

リクエストメッセージの Host ヘッダー。

bytes_received

long

ヘッダーを除くリクエストボディのサイズ。

bytes_sent

long

ヘッダーを除く応答ボディのサイズ。

downstream_local_address

string

ゲートウェイ Pod のアドレス。

downstream_remote_address

string

ゲートウェイに接続するクライアントのアドレス。

duration

long

リクエストの処理にかかった合計時間。これは、ゲートウェイがダウンストリームサービスから最初のバイトを受信してから、応答の最後のバイトを送信するまでの期間です。単位: ミリ秒。

method

string

HTTP メソッド。

path

string

HTTP リクエストのパス。

protocol

string

HTTP プロトコルのバージョン。

request_duration

long

ゲートウェイがダウンストリームサービスから最初のバイトを受信してから、ダウンストリームサービスから最後のバイトを受信するまでの期間。単位: ミリ秒。

request_id

string

ゲートウェイは各リクエストの ID を生成し、それを x-request-id ヘッダーに含めます。バックエンドはこのフィールドをログ記録やトラブルシューティングに使用できます。

requested_server_name

string

SSL 接続に使用されるサーバー名。

response_code_details

string

応答コードに関する追加情報を提供します。たとえば、`via_upstream` は応答コードがバックエンドサービスによって返されたことを示し、`route_not_found` はリクエストに一致するルートが見つからなかったことを示します。

response_tx_duration

long

ゲートウェイがアップストリームサービスから最初のバイトを受信してから、ダウンストリームサービスに最後のバイトを送信するまでの期間。単位: ミリ秒。

route_name

string

ルート名。

start_time

string

リクエストが開始された時間。フォーマット: UTC。

trace_id

string

トレース 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 リクエストの User-Agent ヘッダー。

x_forwarded_for

string

HTTP リクエストの x-forwarded-for ヘッダー。このヘッダーは通常、HTTP クライアントの送信元 IP アドレスを示します。