Nginx可通过map指令结合条件日志精准过滤健康检查请求：在http块定义$loggable（路径匹配）和$loggable_ua（User-Agent匹配），用"$loggable:$loggable_ua"合并为$loggable_final，再在server中配置access_log ... if=$loggable_final实现按需记录。
在 Nginx 中，可以通过 map 指令配合 access_log 的条件日志（conditional logging）功能，精准过滤掉健康检查请求（如 /health、/ping、HealthCheck User-Agent 等），避免污染访问日志。
定义用于过滤的 map 变量
在 http 块中使用 map 创建一个布尔型变量（如 $loggable），根据请求路径、User-Agent、Host 或其他字段判断是否应记录日志：
http {
# 匹配常见健康检查特征：路径或 UA
map $request_uri $loggable {
default 1; # 默认记录
~^/health 0; # /health 或 /healthz 等
~^/ping 0;
~^/readyz 0;
~^/livez 0;
}
<pre class="brush:php;toolbar:false;"># 可选：同时匹配 User-Agent（如 AWS ALB、k8s probe、Consul）
map $http_user_agent $loggable_ua {
default 1;
~*[Hh]ealth[Cc]heck 0;
~*[Kk]ubernetes 0;
~*[Aa][Ll][Bb] 0;
~*[Cc]onsul 0;
}
# 合并逻辑：仅当两个都为 1 才记录（AND 逻辑）
map "$loggable:$loggable_ua" $loggable_final {
default 0;
"1:1" 1;
}}
在 server 或 location 中启用条件日志
在 server 或具体 location 块中，将 access_log 指令的第三个参数设为刚才定义的变量名（Nginx 会将其视为布尔值）：
server {
listen 80;
server_name example.com;
<pre class="brush:php;toolbar:false;">access_log /var/log/nginx/access.log main if=$loggable_final;
location / {
proxy_pass http://backend;
}}
注意：if=$loggable_final 表示仅当该变量值为非空且非 "0"（即字符串 "1"）时才写入日志。Nginx 会自动忽略空值、"0"、"off" 等 falsy 字符串。
验证与调试技巧
- 先用
nginx -t检查语法是否正确，map必须在http块顶层，不能嵌套在server内 - 临时添加一条 debug 日志，输出变量值帮助排查：
log_format debug '$remote_addr – $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" $loggable $loggable_ua $loggable_final';
然后用access_log /var/log/nginx/debug.log debug if=$loggable_final;观察实际取值 - 健康检查路径建议统一归口（例如全走
location = /health），便于集中控制和复用
进阶：按 upstream 或服务名差异化过滤
如果多个后端服务共用同一台 Nginx，可结合 $upstream_http_x_service_name 或自定义 header 进行更细粒度控制：
map $upstream_http_x_service_name $skip_health_log {
default 0;
"auth-service" 1; # auth 服务的健康检查不记
}
<p>map "$loggable_final:$skip_health_log" $should_log {
default 0;
"1:0" 1; # 需记录 & 不属于跳过服务 → 记录
}</p>再将 access_log ... if=$should_log; 应用到对应 location 即可。
