Apache 日志详解

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

大致分类

Access Log 记录：

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

Error Log 记录：

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

生效条件

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

• 文件夹存在
• 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. request attribute 的能力。%{User-Agent}i 进站请求头，i 是 incoming header
3. %{ua_empty}e ua 这个环境变量
4. 按环境变量过滤的能力。env= 满足环境变量才记录

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

2 条件系统
   SetEnvIf
   RewriteRule
   mod_security

3 日志系统
   LogFormat
   CustomLog

4 日志过滤
   env=xxx

%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	超级详细调试