当前位置:首页 > 行业动态 > 正文

光年日志分析工具使用方法

导入日志文件,设置过滤条件,点击分析,查看数据图表,导出报告

光年日志分析工具是一款用于快速解析、统计和可视化日志文件的命令行工具,支持多种日志格式(如Nginx、Apache、Tomcat等),可提取关键信息(如访问量、状态码、耗时等),并生成报表或导出数据。


安装步骤

操作系统 安装命令
Windows 下载 .exe 文件后添加到系统环境变量(如 C:WindowsSystem32
Linux/Mac sudo curl -sL https://guangnian.com/download/install.sh | sh 或通过包管理器安装(如 brew install guangnian

快速入门

  1. 查看帮助

    guangnian --help

    输出工具支持的参数,如 --file(指定日志文件)、--format(日志格式)、--output(输出格式)等。

  2. 解析Nginx日志

    光年日志分析工具使用方法

    guangnian --file /var/log/nginx/access.log --format nginx

    默认输出访问量、状态码分布、IP排名等统计信息。


核心配置说明

参数 作用 示例值
--file 指定日志文件路径 /var/log/nginx/access.log
--format 日志格式类型(如 nginxapache nginx
--filter 过滤条件(支持正则表达式) "^/api/"(仅分析API相关日志)
--output 输出形式(tablecsvjson csv
--time-range 时间范围(如 2023-01-01:2023-01-07 2023-01-01:2023-01-07

高级功能示例

  1. 提取特定字段并导出

    guangnian --file access.log --format custom --fields "ip,status,time" --output json

    按自定义格式提取字段,输出JSON数据。

    光年日志分析工具使用方法

  2. 统计Top 10耗时请求

    guangnian --file access.log --format nginx --sort time --limit 10

    按请求耗时排序并限制输出前10条。


常见问题与解答

问题1:如何处理超大日志文件(如几十GB)?

解答

光年日志分析工具使用方法

  • 使用 --split 参数将日志分片处理,
    guangnian --file large.log --split 100MB --format nginx
  • 或结合系统工具分割文件(如 split 命令):
    split -b 100M large.log part_ && guangnian --file part_ --format nginx

问题2:日志时间格式与工具不匹配怎么办?

解答

  • 通过 --time-format 参数自定义时间格式,
    guangnian --file access.log --time-format "%d/MMM/yyyy:HH:mm:ss"
  • 若日志含多种时间格式,需先预处理统一