apache用%{header_name}i记录自定义请求头，需在logformat中显式声明，如%{x-request-id}i；header不存在时输出“-”；代理场景下需确保上游正确传递且未被剥离。
Apache怎么用 %{HEADER_NAME}i 记录自定义请求头
Apache 默认日志格式（%r、%s 等）不包含任意 Request Header，必须显式用 %{Header-Name}i 语法提取。注意大小写不敏感，但连字符需原样写，比如 X-Forwarded-For 就得写成 %{X-Forwarded-For}i，不能写成 %{x-forwarded-for}i —— 虽然 Apache 会识别，但可读性和维护性差。
实操建议：
- 在
LogFormat中定义新格式，例如：LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" \"%{X-Request-ID}i\"" combined_with_xid - 确保该格式名（如
combined_with_xid）在CustomLog中被引用，否则不会生效 - 如果 Header 不存在，对应位置输出破折号
-，不是空字符串，这点影响日志解析逻辑
为什么 %{X-Real-IP}i 总是空？排查代理链干扰
常见现象：Nginx 做前端代理并设置了 X-Real-IP，但 Apache 日志里始终是 -。根本原因不是 Apache 配置错，而是 Apache 默认不信任上游传递的 Header —— 它只从 TCP 连接的真实客户端 IP 解析 %a 或 %h，而 %{X-Real-IP}i 是纯字符串提取，不校验来源。
关键点：
- 确认 Nginx 确实发出了该 Header：
curl -I -H "X-Real-IP: 192.168.1.100" http://your-apache-site/测试是否能捕获 - 检查 Apache 是否启用了
mod_headers（仅用于调试，非必需）；真正需要的是确保代理没被防火墙或中间设备剥离 Header - 若用 CDN 或多层代理，Header 可能被重写或丢弃，优先用
%{True-Client-IP}i（Cloudflare）或%{X-Forwarded-For}i并取最左 IP
SetEnvIf + LogFormat 联合过滤特定 Header 值
单纯记录所有值不够，常需只记满足条件的请求，比如只记录带 X-Debug: true 的请求。Apache 不支持日志行级 if 判断，但可用 SetEnvIf 先设环境变量，再在 CustomLog 中用条件日志。
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
示例配置：
SetEnvIfNoCase X-Debug "^true$" debug_request
LogFormat "%h %t \"%r\" %>s %{X-Request-ID}i" debuglog
CustomLog /var/log/apache2/debug.log debuglog env=debug_request
注意：
-
SetEnvIfNoCase的正则匹配末尾加$防止true-x也被误匹配 -
env=debug_request表示仅当环境变量存在时才写入该日志，不影响其他日志流 - 环境变量名（
debug_request）不能含短横线，否则 Apache 启动失败
性能和兼容性要注意的三个细节
高频 Header 提取（如每秒数千请求）对性能有轻微影响，尤其配合正则或复杂条件时。不是瓶颈，但上线前应验证。
- Apache 2.2 不支持
%{VAR}e（环境变量）与%{HEADER}i混用在同一个LogFormat字段中；2.4+ 支持，但字段顺序仍可能影响解析结果 - Header 名含下划线（如
X_API_Key）会被 Apache 自动转为短横线（X-API-Key），所以写%{X_API_Key}i会失败，必须写%{X-API-Key}i - 二进制或非 UTF-8 编码的 Header 值（少见）可能被截断或显示为乱码，Apache 日志本身不作编码转换
Header 名里的空格、括号、控制字符基本不可能合法出现在 HTTP 协议中，不用特殊处理；但别手误写成 %{Cookie}i 却期望拿到解码后的值 —— 它就是原始字符串，包括 %20 和分号。
