一、操作场景
·访问日志(accessLog)记录了用户的请求相关信息,可用于进行数据分析、审计、业务排障等。
·错误日志(errorLog)是网关内部错误日志,用于网关排障。
这里说明 AI 网关默认日志功能的使用说明。
二、前提条件
已创建 AI 网关实例,具体操作请参见 新建 AI 网关。
三、查看默认日志
1. 登录 微服务平台控制台 ,在左侧导航栏单击 AI 网关 > 实例列表。
2. 在实例列表页面,单击需要配置的网关实例的“ID”,进入该网关实例的基本信息页面。
3. 在左侧导航栏单击 数据观测 > 默认日志。
4. 设置好你要查看的日志,页面即可展示相关日志内容。 可以通过关键字查询相关日志。输入关键词查询,例如:“info”,注意日志检索区分大小写。
四、编辑默认日志规则
在默认日志页面,单击右上角的编辑日志规则,即可修改默认日志规则。你可以选择继续使用默认规则,也可以根据你的业务需求自定义日志规则。
注意:修改默认日志规则后,投递到 CLS 的日志规则也会同步修改,请谨慎操作。
五、日志字段
下表列出了 AI 网关支持的访问日志字段,你可以根据需要进行配置:
六、HTTP/HTTPS 日志字段
| 字段 | 说明 |
| $remote_addr | 客户端地址。 |
| $status | HTTP 状态码。 |
| $remote_user | Basic authentication 提供的用户名。 |
| $time_local | 请求时间。 |
| $request | 完整的请求行。 |
| $body_bytes_sent | 发送给客户端的文件主体内容的大小。 |
| $request_method | 请求方法。 |
| $host | 请求携带 Host 请求头时为“Host”字段的值,未携带时为主机虚拟域名。 |
| $upstream_addr | 后端服务的 IP 地址。 |
| $upstream_status | 上游服务返回响应中的 HTTP 响应码。 |
| $upstream_response_time | 上游服务响应耗时(毫秒精度),包括网关向后端服务开始建立连接、接收数据、关闭连接的时间。 |
| $scheme | HTTP 或 HTTPS 协议。 |
| $url | 请求 URL。 |
| $request_length | 请求数据大小 bytes,包含请求行、请求头、请求体。 |
| $bytes_sent | 响应字节数。 |
| $http_referer | 页面来源,header Referer 引用页面 URL。 |
| $http_user_agent | 客户端代理信息。 |
| $request_time | 请求耗时,从接收请求开始到发送完响应数据的时间,包含接收请求数据、处理请求、返回响应数据的时间。 |
七、Nginx 变量
不支持的 Nginx 变量如下:
1. 如下变量:
·$connection_time
·$http3
·$jwt_claim_
·$jwt_header_
·$jwt_payload
·$memcached_key
·$mqtt_preread_clientid
·$mqtt_preread_username
·$otel_parent_id
·$otel_parent_sampled
·$otel_span_id
·$otel_trace_id
·$proxy_protocol_tlv_
·$proxy_protocol_tlv_aws_vpce_id
·$proxy_protocol_tlv_azure_pel_id
·$proxy_protocol_tlv_gcp_conn_id
·$secure_link
·$secure_link_expires
·$session_log_binary_id
·$session_log_id
·$slice_range
·$ssl_alpn_protocol
·$ssl_curve
·$upstream_queue_time
2. geo 开头的变量。