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

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

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

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


安装步骤

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

快速入门

  1. 查看帮助

    guangnian --help

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

  2. 解析Nginx日志

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

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

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


核心配置说明

参数作用示例值
--file指定日志文件路径/var/log/nginx/access.log
--format日志格式类型(如nginxapachenginx
--filter过滤条件(支持正则表达式)"^/api/"(仅分析API相关日志)
--output输出形式(tablecsvjsoncsv
--time-range时间范围(如2023-01-01:2023-01-072023-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"
  • 若日志含多种时间格式,需先预处理统一