• 简介
  • 配置
  • 变量
    • 请求日志变量
    • 会话日志变量
    • 通用日志变量

    简介

    mod_access模块以特定格式记录请求日志和会话日志。

    配置

    • 模块配置文件

      conf/mod_access/mod_access.conf

      1. [Log]
      2. # filename prefix for log
      3. LogPrefix = access
      5. # access log directory
      6. LogDir =  ./
      8. # log rotate interval: M/H/D/MIDNIGHT/NEXTHOUR
      9. RotateWhen = NEXTHOUR
      11. # max number of rotated log files
      12. BackupCount = 2
      14. [Template]
      15. # template of request log
      16. RequestTemplate = "REQUEST_LOG $time clientip: $remote_addr serverip: $server_addr host: $host product: $product user_agent: ${User-Agent}req_header status: $status_code error: $error"
      18. # template of session log
      19. SessionTemplate = "SESSION_LOG  $time clientip: $ses_clientip start_time: $ses_start_time end_time: $ses_end_time overhead: $ses_overhead read_total: $ses_read_total write_total: $ses_write_total keepalive_num: $ses_keepalive_num error: $ses_error"
      • 注：RequestTemplate/SessionTemplate 中 $开头的代表变量, 支持的变量列表详见”变量”章节说明

    变量

    请求日志变量

    变量名 含义
    log_id 请求日志ID
    error 请求处理错误
    product 产品线名称
    host 请求Host字段
    uri 请求URL信息
    vip 请求访问VIP
    is_trust_clientip 请求是否来自信任IP
    req_uri 请求行URI
    req_header 请求头部, 例$[User-Agent]req_header
    req_cookie 请求Cookie
    req_nth 请求序号（连接上第几个请求)
    body_len_in 请求内容长度
    status_code 响应状态码
    res_proto 响应HTTP协议版本
    res_header 响应头部, 例$[Server]req_header
    res_cookie 响应Set-Cookie
    redirect 重定向响应地址
    body_len_out 响应内容长度
    remote_addr 连接对端地址
    server_addr 连接本地地址
    backend 请求转发后端信息(集群、子集群、实例)
    cluster_name 请求转发集群名称
    subcluster 请求转发子集群名称
    retry_num 请求转发重试次数
    all_time 请求总处理时间
    read_req_duration 读请求头持续时间
    proxy_delay 从接收到请求头到开始转发请求延迟时间
    connect_time 连接后端时间
    write_serve_time 从请求后端到接收到后端响应头持续时间
    response_duration 从接收到响应头到完成响应转发持续时间
    cluster_duration 从请求后端到接收到响应头部持续时间（含重试）
    last_backend_duration 从请求后端到接收到响应头部持续时间
    readwrite_serve_time 从请求后端到完成响应转发持续时间
    since_ses_start_time 接收到请求时当前会话持续时间

    会话日志变量

    变量名 含义
    ses_clientip 会话用户IP
    ses_error 会话错误
    ses_is_secure 是否基于TLS协议
    ses_start_time 会话开始时间
    ses_end_time 会话结束时间
    ses_overhead 会话持续时长
    ses_read_total 会话读取字节总数
    ses_write_total 会话写出字节总数
    ses_tls_client_random TLS连接ClientHello Random
    ses_tls_server_random TLS连接ServerHello Random
    ses_use100 是否出现Expect: 100-continue请求
    ses_keepalive_num 会话总处理请求数

    通用日志变量

    变量名 含义
    time 日志记录时间