API Gateway:Ativar entrega de logs para um gateway

Campo

Tipo

Descrição

__time__

long

Momento em que o log foi gerado.

cluster_id

string

ID da instância do AI Gateway.

ai_log

json

Objeto JSON contendo campos de log para Model API, Agent API e MCP API. Este campo fica vazio para outros tipos de API.

• api: Nome da AI API.

• cache_status: Indica se uma requisição atingiu o cache quando o cache de conteúdo está ativado para uma Model API.

• consumer: Identidade do consumidor. Preenchido quando a autenticação de consumidor está ativada.

• fallback_from: Rota de onde a requisição sofreu fallback. Preenchido quando uma política de fallback está ativada para uma Model API.

• input_token: Quantidade de tokens de entrada na requisição LLM.

• llm_first_token_duration: Tempo até o primeiro token (TTFT) da requisição LLM.

• llm_service_duration: Tempo de resposta ponta a ponta da requisição LLM.

• model: Nome do modelo utilizado na requisição LLM.

• output_token: Quantidade de tokens de saída na resposta LLM.

• response_type: Tipo de resposta da requisição LLM, como streaming ou não-streaming.

• safecheck_status: Resultado da Moderação de Conteúdo para a requisição LLM.

• token_ratelimit_status: Indica se a requisição foi bloqueada por limitação de taxa baseada em tokens.

authority

string

Valor do cabeçalho Host na requisição.

bytes_received

long

Tamanho do corpo da requisição em bytes, excluindo o cabeçalho.

bytes_sent

long

Tamanho do corpo da resposta em bytes, excluindo o cabeçalho.

downstream_local_address

string

Endereço do pod do gateway.

downstream_remote_address

string

Endereço do cliente conectado ao gateway.

duration

long

Tempo total de processamento da requisição em milissegundos, medido desde o recebimento do primeiro byte do cliente até o envio do último byte da resposta pelo gateway.

method

string

Método HTTP.

path

string

Caminho na requisição HTTP.

protocol

string

Versão do protocolo HTTP.

request_duration

long

Tempo em milissegundos desde o recebimento do primeiro byte da requisição do cliente até o recebimento do último byte pelo gateway.

request_id

string

ID exclusivo gerado pelo gateway para cada requisição. Incluído no cabeçalho x-request-id. Utilize este campo para registrar logs e solucionar problemas de requisições.

requested_server_name

string

Nome do servidor usado na conexão SSL.

response_code_details

string

Contexto adicional para o código de resposta. Por exemplo, via_upstream indica que o serviço de backend retornou o código, enquanto route_not_found sinaliza que o gateway não encontrou uma rota correspondente.

response_tx_duration

long

Tempo em milissegundos desde o recebimento do primeiro byte do serviço upstream até o envio do último byte ao cliente pelo gateway.

route_name

string

Nome da rota.

start_time

string

Horário de início da requisição, em UTC.

trace_id

string

ID de rastreamento.

upstream_cluster

string

Cluster upstream.

upstream_host

string

Endereço IP do host upstream.

upstream_local_address

string

Endereço local usado para conectar ao serviço upstream.

upstream_service_time

long

Tempo de processamento da requisição no serviço upstream, em milissegundos. Inclui latência de rede e tempo de processamento do próprio serviço.

upstream_transport_failure_reason

string

Motivo da falha na conexão upstream.

user_agent

string

Valor do cabeçalho User-Agent na requisição.

x_forwarded_for

string

Valor do cabeçalho x-forwarded-for, que geralmente contém o endereço IP real do cliente.