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 | 新增支持导出两种日志： 1）exporter.log：指标采集日志 2）FineOperation.log：宕机自助处理工具日志 |
| V2.10.0 | 为了缩短日志下载耗时，对于启用了ElasticSearch组件的项目，也支持自定义勾选需下载的日志 |
| V2.14.0 | 对于运维平台部署的项目，运维日志支持按天/精确时间下载，满足不同用户需求 |
| V2.25.0 | 新增支持导出update.log：FineBI数据更新日志 |
| V2.26.0 | 新增支持导出fine-ai、fine-chat-bi-parser组件日志 |
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 自身运行日志，主要记录 Tomcat 在启动和暂停时的运行内容 |
| localhost_access_log.txt | Tomcat 请求访问日志，记录请求时间、请求类型、请求资源和返回状态码 |
| messages.txt | Linux 系统日志，记录系统中发生的各类事件和错误信息，如启动、关机、硬件故障、软件崩溃等 |
agent.log | ops-agent 组件日志 |
| exporter.log | 指标采集日志，记录项目指标信息采集相关情况 |
| FineOperation.log | 宕机自助处理工具日志，记录宕机自助处理定时任务相关信息和执行情况 |
2. 查看日志基础信息
操作步骤：
1）管理员登录运维平台，选择运维项目，点击「日志 > 运维日志」。
2）在「储存位置」中，点击「查看」按钮，即可查看该运维项目中各个工程节点的运维日志存储位置。
注意事项：
1）运维平台部署的运维项目，若已安装 ElasticSearch 组件用于日志存储，则此处不显示储存位置，提示「elasticsearch 日志服务」。
2）如不存在某种类型的日志，则不展示该日志的存储位置。
3. 下载运维日志
| 序号 | 操作步骤 | 注意事项 |
|---|---|---|
| 1 | 管理员登录运维平台，选择运维项目，点击「日志>运维日志」。 | |
| 2 | 选择下载模式和时间范围 | 1）对于使用ElasticSearch组件作为日志存储的项目，支持两种下载模式：
可选范围：7天前~当前日期，所选时间跨度不可超过2天 默认时间：2小时前~当前时间
可选范围：不限日期 默认时间：当天 2）对于使用Swift引擎作为日志存储的项目，仅支持「按天下载」 默认时间：当天 |
| 3 | 选择服务类型 | 支持类型：fr、fdl、bi-web、bi-engine-worker、 bi-engine-master 可选范围：所选时间内存在的服务类型，默认全选 注意事项： 1）非运维平台部署的项目不支持选择服务类型 2）如不存在任一类型，则不出现该选项 |
| 4 | 选择节点 | 可选范围：所选运维项目中的所有节点，默认全选 |
| 5 | 选择需下载的日志 | 支持类型：可参见 1.3 节表格 注意事项：如不存在某种类型的日志，则不支持下载该类型日志 |
| 6 | 点击「下载」，生成运维日志文件到本地电脑 | 1）若文件大小超过5G，则无法导出该日志，提示「以下日志大小超过上限（5GB），不支持下载：xxx」 2）若该类型日志文件不存在，则无法导出该日志，提示「以下日志不存在：xxx」 3）日志下载时需要进行压缩，若等待时间过长，可点击「取消下载」按钮停止下载 4）下载的文件解压后，按照「节点-日期-服务类型-日志类型」结构存放 |
4. 注意事项
4.1 compress FanruanLog error
问题描述：下载日志时，出现报错：压缩失败 compress FanruanLog error
原因分析：磁盘空间不足
解决方案： 对运维项目挂载目录对应的磁盘进行扩容，确保有足够空间供生成压缩文件。
4.2 系统运维子进程连接失败
问题描述：管理员登录运维平台，点击运维项目，访问「日志>运维日志」界面，报错「系统运维子进程连接失败」
排查步骤：
1）管理员登录帆软应用，点击「管理系统>智能运维>宕机处理」，确认开启「自动导出内存堆栈」功能。
2）使用 curl 命令，确保运维平台与项目服务器间网络连通。
3）如果运维平台和项目配置了 SSL，确保双方证书未过期。
4）禁用系统运维插件后重新开启，重新配置运维平台与运维项目之间的对接。
上一篇：日志管理
