清冽之泉

Apache 日志详解

Apache 日志分三个层次，分别是访问日志、状态日志、自造日志。

大致分类

Access Log：

  1. 谁访问了
  2. 访问了什么
  3. 返回什么状态码

Error Log：

  1. 模块警告
  2. 配置错误
  3. 程序异常
  4. 权限错误
  5. SSL问题

四维能力

Apache 本身有以下四个不同维度的设计。 

1 请求信息
   ├─ header
   ├─ URI
   ├─ method
   └─ env variables

2 条件系统
   SetEnvIf
   RewriteRule
   mod_security

3 日志系统
   LogFormat
   CustomLog

4 日志过滤
   env=xxx

生效条件

日志在以下情况才会产生：

  • 文件夹存在
  • apache 有文件夹的读写权限
  • 先有 LogFormat 定义日志格式：LogFormat "%h %l %u %t \"%r\" %>s %b" miaomiaomiao
  • 后有 CustomLog 生成日志：CustomLog /var/log/apache2/sth_debug.log miaomiaomiao
  • 需 sudo systemctl reload apache2 重启一下

tail -f /var/log/apache2/sth_debug.log 可以查看新产生的日志。

自造日志

SetEnvIfNoCase User-Agent "^$" ua_empty

LogFormat "%h %l %u %t \"%r\" %>s %b ua=\"%{User-Agent}i\" empty=%{ua_empty}e" miaomiaomiao

CustomLog /var/log/apache2/anki_debug.log miaomiaomiao env=ua_empty
  1. 设置环境变量。SetEnvIfNoCase 设置环境变量。格式为 SetEnvIfNoCase 检查对象 正则匹配 设置变量。上述命令是把空请求头设置为 ua_empty
  2. 读取属性。%{User-Agent}i 进站请求头，i 是 incoming header。%{ua_empty}e ua 这个环境变量
  3. 按环境变量过滤。env= 满足环境变量才记录

%h %l %u %t \"%r\" %>s %b 是日志格式字符串，不用记，用时随手搜或照抄即可。那些 \ 是给引号转义用的。

指定格式
占位符 含义
%h 客户端 IP 地址（remote host）
%l RFC 1413 用户身份（通常返回 -，几乎没用）
%u 已认证的用户（如果用了 HTTP auth），没用就 -
%t 请求时间，格式 [08/Apr/2026:15:38:50 +0800]
"%r" 原始请求行，例如 "POST /hi/sync/meta HTTP/1.1"
%>s 响应状态码，例如 200 或 403
%b 响应体字节数（不包含头），如果是 0 则显示 -
ua=\"%{User-Agent}i\" 把请求头 User-Agent 的值打印出来，i 表示 incoming header
empty=%{ua_empty}e 打印环境变量 ua_empty 的值，e 表示 environment variable

LogLevel

日志等级越往下越详细。越详细越占用内存和网络，所以一般只开 warn，意思是比 warn 还严重的级别才显示。

日志等级可以分模块开放。如 LogLevel warn rewrite:trace2 proxy:debug proxy_http:trace3 ssl:warn。怀疑哪个模块有问题，就把那个模块的日志等级调详细一些。

日志级别
等级 含义
emerg 系统完全崩溃
alert 必须立刻处理
crit 严重错误
error 普通错误
warn 警告
notice 重要但正常
info 信息
debug 调试
trace1–trace8 超级详细调试
Retrieved from "https://qingliezhiquan.com/index.php?title=Apache_日志详解&oldid=10626"