或者直接粘贴几行日志
状态码分布
次数 · 占当前筛选请求的比例
Top 客户端 IP
请求次数 · 占当前筛选请求的比例
Top 请求路径
请求次数 · 占当前筛选请求的比例
问题清单
导出会开始浏览器下载,请在浏览器「下载列表」查看。文件名:
nginx-access-report-时间戳.html / .md、nginx-access-时间戳.csv、
nginx-unparsed-时间戳.csv(只含无法解析行)。
格式识别结果
识别统计
支持的格式
内置两种预设;自定义格式按 $变量 顺序生成解析规则,不自动猜测。
combined:$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" main:$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent
网页版与桌面版
网页版(当前)· ≤ 5 MB
- 文件整体读进浏览器内存,适合按天或按小时截取的日志。
- 文件不离开浏览器,适合日常排查。
- 超过 5 MB 的文件不会被读取,请先切割再分析。
- 一次只能选一个文件。
桌面版 · 大文件流式读取
- 不再受 5 MB 限制,边读边解析,窗口保持可操作。
- 解析核心与网页版同一份,字段与统计口径一致。
- 大文件下内存只保留索引,查看明细时按需回读。
- 支持单文件选择,滚动日志请按时间合并后再打开。
支持什么、不支持什么
- combined(nginx 默认)与 main 两种格式,自动识别。
- 自定义
log_format:整行粘贴或只贴格式串。 - 可选字段:
$request_time、$upstream_response_time、$upstream_addr、$http_x_forwarded_for、$host、$scheme。 - 状态类、具体状态码、请求方法、IP、路径、UA、耗时阈值组合筛选。
- 状态分布、Top IP / 路径 / URI / UA、平均耗时与 P95。
- 明细 CSV 与含统计的 JSON 导出(当前筛选结果,跨页)。
escape=json的 JSON 日志:结构不同,本期不做。error.log:多行事件模型,用另一个独立工具(1.7.1 第二步)。- 非 UTF-8 编码的日志文件。
- 自定义格式里含 nginx 内置变量以外的复杂模板(如 if / map 拼接)。
- 解析不了的行不会进入统计,只计入「无法解析行」。
- 日志里混入 error.log:这些行会进入「无法解析行」,不会污染状态统计。
- 自定义格式漏写引号或字段顺序不一致:会导致整行不匹配;可用「自动识别」先确认,再切换自定义。
- UA 里含未转义的引号:nginx 默认会转义为
\";如果日志被二次处理后破坏了转义,该行会解析失败。 - 没有 $request_time:耗时相关统计自动隐藏,不会用 0 填充。
- 独立 IP 不等于真实访客:NAT、CDN 回源都会影响;需要真实客户端 IP 请配置
$http_x_forwarded_for或 real_ip。
常见问题
点问题查看答案支持哪些 nginx 日志格式?
内置 combined(nginx 默认)与 main 两种格式,打开文件后自动识别。自定义 log_format 可以把配置里的整行(例如 log_format main '$remote_addr ...';)直接粘贴进「自定义格式」,工具按 $变量顺序生成解析规则。含 $request_time、$upstream_response_time、$upstream_addr、$http_x_forwarded_for、$host、$scheme 时对应列与统计会自动出现。
日志会上传服务器吗?
不会。读取、解析、统计、筛选和导出全部在当前浏览器里完成,没有后端解析接口;刷新页面即清空。网页版单文件上限 5 MB。
超过 5 MB 的 access.log 怎么办?
选择文件时会先检查大小,超过 5 MB 直接提示,文件不会被读取。可以按时间段切割(例如用 sed / Select-String 取一小时)后再分析。桌面版支持大文件流式读取,上限更高。
为什么有的行没有进入统计?
解析不了的行会单独计入「无法解析行」,不会混进明细表;常见原因是日志里混入了 error.log 内容、上游自定义格式多了一层字段,或格式里少写了引号。可以在「格式与自检」里看无法解析行的示例,再对照 log_format 调整。
「独立 IP」是真实访客数吗?
不是。它只是按 remote_addr 去重后的 IP 数量,同一 NAT 后的多个用户会算成一个 IP,CDN 回源时看到的也常是 CDN 节点地址。如果要看真实客户端 IP,请确认日志里配置了 $http_x_forwarded_for 或 real_ip 模块。
状态码分布和 Top 榜按什么口径统计?
状态码按 2xx / 3xx / 4xx / 5xx 分组后再给出具体码的数量;Top URL 同时提供去掉 query 的路径口径和原始 URI 口径,排查接口问题通常看路径,排查参数问题看 URI。统计基于当前筛选结果,不是全量文件。
耗时统计从哪里来?
只有 log_format 里包含 $request_time 时才有平均耗时与 P95;P95 表示 95% 的请求耗时不超过该值,比平均值更能反映长尾。没有该字段时耗时卡会自动隐藏,不会用 0 填充。
能导出什么?
可以导出当前筛选结果的 CSV(Excel 可直接打开)和 JSON(含统计与逐行字段,便于二次分析)。导出范围是筛选后的全部结果,不是当前页。
桌面版和网页版结果一致吗?
一致。两端使用同一份解析核心、同一套字段名与统计口径;差别只在能处理多大的文件和是否支持本地文件搜索。