Skip to content

Latest commit

 

History

History
52 lines (47 loc) · 2.44 KB

log_zh.md

File metadata and controls

52 lines (47 loc) · 2.44 KB
description
Pingap 请求日志格式化

Pingap格式化可以使用以下几种默认形式combinedcommonshort以及tiny。也可自定义完整的日志格式化输出,具体参数说明如下:

  • {host}: 请求的host属性
  • {method}: 请求的method
  • {path}: 请求的路径
  • {proto}: 协议类型,HTTP/1.1HTTP/2.0
  • {query}: 请求的querystring
  • {remote}: 请求的源ip
  • {client_ip}: 客户ip,获取的顺序为X-Forwarded-For --> X-Real-Ip --> remote
  • {scheme}: 协议类型,https或http
  • {uri}: 请求的完整地址
  • {referer}: 请求头中的referer
  • {user_agent}: 请求的user-agent
  • {when}: 日志的输出时间
  • {when_utc_iso}: 日志的输出的utc时间
  • {when_unix}: 日志的输出时间,格式为时间戳
  • {size}: 响应数据的字节数
  • {size_human}: 响应数据的大小,按数据大小格式化字符串
  • {status}: 响应状态码
  • {latency}: 响应时间的ms
  • {latency_human}: 响应时间,按时间格式化
  • {payload_size}: 请求数据的字节大小
  • {payload_size_human}: 请求数据的大小,按数据大小格式化字符串
  • {request_id}: 请求的id,需要添加了对应的中间件
  • {~name}: 从cookie中获取name对应的值,如获取cookie中的uid则是{~uid}
  • {>name}: 请求头中获取name对应的值,如获取请求头中的X-User-Id则是{>X-User-Id}
  • {<name}: 响应头中获取name对应的值,如获取响应头中的X-Server则是{<X-Server}
  • {:name}: 从context中获取对应的值,支持的属性可参考后面的说明
  • {$name}: 从环境变量中获取name对应的值,仅启动时获取对应的值后保存,非实时获取
  • {$hostname}: 获取当前服务器的hostname

context

现已支持获取context中记录的以下相关属性:

  • reused: 与upstream的连接是否为复用请求
  • upstream_addr: 连接的upstream地址
  • processing: 该服务当前正在处理的请求数
  • upstream_connect_time: 连upstream的连接耗时
  • upstream_connected: 当前location与upstream的连接数
  • upstream_processing_time: upstream处理请求的时长
  • location: 对应的location
  • established: 客户端的连接时间
  • tls_version: tls的版本(http连接则为空)
  • compression_time: 数据压缩的耗时
  • compression_ratio: 数据压缩比
  • cache_lookup_time: 缓存的查询耗时
  • cache_lock_time: 缓存的锁定耗时