可直接用%{Header-Name}i语法提取请求头，需Header真实存在且未被中间层剥离；大小写不敏感但连字符须原样保留，不存在时输出“-”；配置需启用模块、定义LogFormat并引用CustomLog。

可以直接用 %{Header-Name}i 语法在 LogFormat 中提取请求头，前提是 Header 真实存在且未被中间层剥离。

基本写法和注意事项

Apache 的 mod_log_config 支持通过 %{X-Request-ID}i 这类格式符读取任意请求头（i 表示 input）。大小写不敏感，但连字符必须原样保留：

• %{X-Request-ID}i ✅ 正确（推荐）
• %{x-request-id}i ⚠️ 能识别，但可读性差，不建议
• %{XRequestID}i ❌ 不会匹配到 X-Request-ID

Header 不存在时，日志中对应位置显示为 -（破折号），不是空字符串或 null，这点对后续日志解析很重要。

配置步骤

需要三步：启用模块 → 定义格式 → 指定日志文件。

Apache Superset Dashboard and SQL Exploration Skill

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

• 确认 mod_log_config 已加载（通常默认启用）：
  apachectl -M | grep log_config
• 在配置中（如 httpd.conf 或虚拟主机内）添加：
  LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" \"%{X-Request-ID}i\"" combined_with_id
• 启用该格式记录日志：
  CustomLog /var/log/apache2/access.log combined_with_id

代理场景下常见问题

如果 Apache 前面有 Nginx、CDN 或负载均衡器，自定义请求头可能被丢弃或未透传。

• 先验证上游是否真发出了该 Header：
  curl -H "X-Request-ID: abc123" http://your-site/，再查日志是否出现 abc123
• Nginx 作为前端时，需显式透传：
  proxy_set_header X-Request-ID $http_x_request_id;
• 多层代理中，X-Forwarded-For 类 Header 更容易被重写；X-Request-ID 这类追踪头建议由最外层网关生成并全程透传

按条件只记录带特定 Header 的请求

若只想记录含某个 Header 的请求（比如调试用的 X-Debug: true），可用 SetEnvIf 配合 CustomLog 的条件参数：

• SetEnvIfNoCase X-Debug "^true$" debug_request
• CustomLog /var/log/apache2/debug.log combined_with_id env=debug_request

这样只有 Header 值匹配的请求才会写入该日志文件，避免污染主日志。