上一篇
光年日志分析使用说明
光年日志分析支持实时监控、数据检索及可视化分析，可多维度统计与智能告警，操作时先登录平台，选 日志源并设过滤条件，即可查看分析结果，界面友好，处理高效，还能自定义
安装前准备
- 操作系统要求：支持 Windows 7 及以上、Linux（如 Ubuntu 16.04+）、macOS 10.12+。
- 硬件要求：至少 4GB 内存，20GB 可用磁盘空间。
- 软件依赖：需提前安装 Python 3.6+（含 pip），MySQL 5.7+数据库。
安装步骤
| 步骤 | 操作说明 | 命令/路径 |
|---|---|---|
| 1 | 下载安装包 | 官网下载 .zip 或 .tar.gz 文件 |
| 2 | 解压文件 | Windows：右键解压 Linux/macOS： unzip /tar -xzf |
| 3 | 运行安装脚本 | 进入解压目录，执行 python setup.py install |
| 4 | 启动服务 | 终端输入 guangnian logserver start |
基础配置
- 配置文件路径：
/etc/guangnian/config.json（Linux）或C:ProgramDataguangnianconfig.json（Windows）。 - 核心参数：
log_path：日志存储目录（默认/var/log/guangnian）db_host：数据库地址（默认localhost）port：服务端口（默认8080）
- 修改后重启：执行
guangnian logserver restart使配置生效。
日志分析功能
- 查看日志：
- 访问 Web 界面：
http://<服务器IP>:8080 - 命令行：
guangnian log view --file <日志文件名>
- 访问 Web 界面：
- 搜索与过滤：
- 支持关键词搜索（如
error）、时间范围筛选（--start "2023-01-01" --end "2023-01-07"）。 - 正则表达式匹配（
--regex "^ERROR."）。
- 支持关键词搜索（如
- 统计报表：
- 生成日志级别分布图：
guangnian report level-dist - 导出 CSV：
guangnian export --type csv --output path/to/file
- 生成日志级别分布图：
常见问题与解决
| 问题 | 解决方案 |
|---|---|
| 服务启动失败 | 检查端口占用（netstat -tuln），确认配置文件无语法错误 |
| 日志无法写入 | 检查 log_path 目录权限（chmod 777 /var/log/guangnian） |
| 搜索无结果 | 确认时间范围覆盖日志生成时间，尝试移除过滤条件 |
相关问题与解答
问题1：如何处理大量日志数据导致的性能下降？
解答：
- 启用日志分片：在
config.json中设置shard_size = 500MB，自动分割大日志文件。 - 使用索引加速搜索：执行
guangnian index build --force生成关键词索引。 - 清理过期日志：通过 Web 界面或命令
guangnian clean --days 30删除 30 天前的数据。
问题2：如何实现日志的远程备份？
解答：
- 配置 rsync 同步：在
config.json中添加backup_path = "remote:/backup/logs"，并设置 SSH 密钥。 - 定时备份脚本：编写 crontab 任务（如
0 3 guangnian backup --target remote），每日凌晨 3 点备份。 - 验证完整性：使用
guangnian checksum --local和guangnian checksum --remote对比本地与远程哈希
