1. 概述
1.1 版本
| 运维平台版本 | 功能变更 |
|---|---|
| V1.5.5 | - |
| V1.5.7 | 1）支持单次下载集群多节点日志 2）支持选择指定服务类型的日志 |
| V1.5.9 | 1）「运维日志」支持查看「日志基础信息」 2）「运维日志」下载时，支持选择下载日志类型 |
| V1.13.0 | 支持下载更多运维组件相关日志 |
| V2.0.0 | 交互优化，功能入口位置调整 |
| V2.1.0 | 项目不可用情况下仍支持下载运维日志 |
| V2.3.0 | 新增支持导出 exporter.log（指标采集日志）、FineOperation.log（宕机自助处理工具日志） |
| V2.10.0 | 启用 ElasticSearch 组件的项目也支持自定义勾选需下载的日志，缩短下载耗时 |
| V2.14.0 | 运维平台部署的项目支持按天/精确时间下载日志 |
| V2.25.0 | 新增支持导出 update.log（FineBI 数据更新日志） |
| V2.26.0 | 新增支持导出fine-ai、fine-chat-bi-parser组件日志 |
| V2.38.0 | 新增「数据留存天数」自定义功能 |
1.2 应用场景
部分公司机房管控较严格，进机房流程繁琐，日志获取费时费力。运维平台支持在前端快速定位并下载运维项目的 debug 日志，降低日志获取成本。
对于用量较大的项目，日志增长快、易占满磁盘。运维平台支持在「日志管理」中自定义「数据留存天数」以控制日志体积。
1.3 日志简介
运维平台支持查看日志存储位置，并支持下载以下类型的日志。
| 日志 | 说明 |
|---|---|
| fanruan.log | 帆软应用运行日志 |
| standard.log | 仅 FineBI 项目支持；FineBI 集群日志，一般默认存放在 logs/cluster 路径下 |
| eventlog | 仅 FineBI 项目支持；记录数据集更新在 Spark 引擎中计算的具体信息，用于分析 Spark 执行慢问题 |
| BIEvent.log | 仅 FineBI 项目支持；FineBI 配置操作记录 |
| polars.log | 仅 FineBI 项目支持；仪表板和数据集编辑涉及的计算日志 |
| operator_calculate.log | 仅 FineBI 项目支持；仪表板和数据集编辑涉及的计算日志 |
| update.log | 仅 FineBI 项目支持；数据更新相关日志 |
| access.log | Nginx 访问日志，记录访问时间、IP 地址、请求方法、访问路径、HTTP 状态码等 |
| catalina.out | Tomcat 标准输出和标准错误，包含 Tomcat 自身日志及应用向 console 输出的日志 |
| catalina.log | Tomcat 自身运行日志，主要记录启动和暂停时的运行内容 |
| localhost_access_log.txt | Tomcat 请求访问日志，记录请求时间、请求类型、请求资源和返回状态码 |
| messages.txt | Linux 系统日志，记录启动、关机、硬件故障、软件崩溃等事件和错误信息 |
| agent.log | ops-agent 组件日志 |
| exporter.log | 指标采集日志，记录项目指标信息采集情况 |
| FineOperation.log | 宕机自助处理工具日志，记录宕机自助处理定时任务信息和执行情况 |
2. 日志管理
「日志管理」用于查看日志存储位置，并设置日志的数据留存天数。
2.1 查看日志存储位置
本功能用于查看各工程节点的运维日志存储位置。
面向对象：
此功能仅面向未使用 ElasticSearch 组件存储日志的项目。
若已安装 ElasticSearch 组件用于日志存储，则「储存位置」不显示具体路径，显示「elasticsearch 日志服务」。
操作步骤：
1）管理员登录运维平台，选择运维项目，点击「日志>运维日志」。
2）在「日志管理」的「储存位置」中点击「查看」，即可查看该运维项目中各工程节点的运维日志存储位置。
注意事项：
如不存在某种类型的日志，则不展示该日志的存储位置。
2.2 设置数据留存天数
对于用量较大的项目，日志增长快、易占满磁盘。运维平台支持管理员自定义「数据留存天数」以控制日志体积。
面向对象：
此功能仅面向使用了 ElasticSearch 组件存储日志的项目。
操作步骤：
1）管理员登录运维平台，选择运维项目，点击「日志>运维日志」。
2）在「日志管理」的「数据留存天数」中点击「编辑」。
3）在「编辑规则」弹窗中填写「数据留存天数」，默认保留时间为 7 天。
4）点击「保存」，配置立即生效。
注意事项：
1）超过留存天数的日志将被自动清理，请合理设置，避免因留存天数过短导致历史日志无法追溯。
2）平台不提供直接的日志清理入口；如需减少历史日志占用的磁盘空间，请通过缩短「数据留存天数」实现。
3. 下载运维日志
| 序号 | 操作步骤 | 注意事项 |
|---|---|---|
| 1 | 管理员登录运维平台，选择运维项目，点击「日志>运维日志」。 | |
| 2 | 选择下载模式和时间范围 | 1）使用 ElasticSearch 组件存储日志的项目支持两种模式： 「精确时间下载」可选范围为日志留存时长范围内、时间跨度不超过 2 天、默认 2 小时前~当前时间； 「按天下载」可选范围不限日期、默认当天 2）使用 Swift 引擎存储日志的项目仅支持「按天下载」，默认当天 |
| 3 | 选择服务类型 | 支持类型：fr、fdl、bi-web、bi-engine-worker、 bi-engine-master 可选范围：所选时间内存在的服务类型，默认全选 注意事项： 1）非运维平台部署的项目不支持选择服务类型 2）如不存在任一类型，则不出现该选项 |
| 4 | 选择节点 | 可选范围：所选运维项目中的所有节点，默认全选 |
| 5 | 选择需下载的日志 | 支持类型可参见 1.3 节表格 如不存在某种类型的日志，则不支持下载该类型 |
| 6 | 点击「下载」，生成运维日志文件到本地电脑 | 1）文件大小超过 5GB 无法导出，提示「以下日志大小超过上限（5GB），不支持下载：xxx」 2）若该类型日志文件不存在，则无法导出该日志，提示「以下日志不存在：xxx」 3）日志下载时需要进行压缩，若等待时间过长，可点击「取消下载」按钮停止下载 4）下载的文件解压后，按照「节点-日期-服务类型-日志类型」结构存放 |
4. 注意事项
4.1 compress FanruanLog error
问题描述：下载日志时，出现报错：压缩失败 compress FanruanLog error
原因分析：磁盘空间不足
解决方案： 对运维项目挂载目录对应的磁盘进行扩容，确保有足够空间供生成压缩文件。
4.2 系统运维子进程连接失败
问题描述：管理员登录运维平台，点击运维项目，访问「日志>运维日志」界面，报错「系统运维子进程连接失败」
排查步骤：
1）管理员登录帆软应用，点击「管理系统>智能运维>宕机处理」，确认开启「自动导出内存堆栈」功能。
2）使用 curl 命令，确保运维平台与项目服务器间网络连通。
3）如果运维平台和项目配置了 SSL，确保双方证书未过期。
4）禁用系统运维插件后重新开启，重新配置运维平台与运维项目之间的对接。
上一篇：日志管理
