Nginx 中使用 access_log 记录接口返回码的统计分析

Nginx的access_log不直接统计分析，但通过记录$statusCode为后续分析提供基础；需确保日志格式包含$status，可用awk快速统计状态码分布，或接入ELK、Prometheus等系统实现可视化监控与告警。

在 Nginx 中，access_log 本身不直接提供“统计分析”功能，但它能以结构化格式记录每次请求的响应状态码（$status），这是后续做返回码分布、异常率、趋势监控等分析的基础。关键在于：日志格式要包含状态码，日志内容要便于提取和聚合。

确保 access_log 格式包含 $status 变量

Nginx 默认日志格式通常已含 $status，但建议显式确认或自定义更清晰的格式，尤其当需要配合日志分析工具时：

示例（在 http 或 server 块中定义）：

log_format main '$remote_addr - $remote_user [$time_local] ' '"$request" $status $body_bytes_sent ' '"$http_referer" "$http_user_agent" ' '$request_time $upstream_response_time';

然后启用：

access_log /var/log/nginx/access.log main;

这样每行日志都会明确记录 HTTP 状态码（如 200、404、502），为后续分析提供原始依据。

用命令行快速统计返回码分布

对已有 access.log 文件，可借助 shell 工具快速查看状态码频次：

1. 统计所有状态码出现次数（按数字排序）：

   awk '{print $9}' /var/log/nginx/access.log | sort | uniq -c | sort -n

2. 聚焦错误码（4xx/5xx）并排序：

   awk '$9 ~ /^4|5/ {print $9}' /var/log/nginx/access.log | sort | uniq -c | sort -nr

3. 统计最近 1000 行中的 500 类错误：

   tail -1000 /var/log/nginx/access.log | awk '$9 == "500" {count++} END {print count+0}'

这些命令适合临时排查或写入监控脚本，响应快、无需额外依赖。

接入日志分析系统做持续监控

生产环境推荐将 access_log 接入专业工具，实现可视化与告警：

1. ELK Stack（Elasticsearch + Logstash + Kibana）：Logstash 解析日志（提取 $status、$request_time 等字段），Elasticsearch 存储，Kibana 做状态码占比饼图、5xx 趋势折线图、异常突增告警。
2. Prometheus + Grafana（需 exporter）：使用 nginx-lua-prometheus 或 nginxlog-exporter，将状态码按 code 和 path 维度暴露为指标，Grafana 中即可查 “5xx 占比 > 1%” 的实时看板。
3. 轻量替代：GoAccess 或 awstats：适合中小流量站点，支持 HTML 报表生成，内置状态码统计模块，一键生成响应码分布图表。

注意日志采样与性能平衡

高频接口全量记录可能带来磁盘 I/O 和存储压力，必要时可条件记录：

1. 只记录异常响应：

   access_log /var/log/nginx/error_access.log main if=$loggable;

   配合：map $status $loggable { ~^[45] 1; default 0; }

2. 限制日志频率（如每秒最多 1 条）：

   使用 limit_req 配合日志条件，或用 logrotate 定期切分+压缩。

避免因日志过度影响 Nginx 吞吐，尤其在高并发场景下。