tidb-in-action
2.4 日志搜索和导出
上一节介绍如何操作生成集群诊断报告。
本节将介绍如何使用 TiDB Dashboard 分析 TiDB 系统日志。
日志搜索功能允许用户在集群中搜索所有节点上的日志，在页面上预览搜索结果和导出日志。
1. 日志搜索功能
日志搜索主要是根据用户设置，对服务器上的日志内容进行筛选。
可设置参数包括:
- 时间范围：限定搜索日志的时间范围，为空的话默认搜索所有日志
- 日志等级：限定 最低日志等级 ，搜索该日志等级以上的所有日志
- 组件：选择要搜索的集群组件。支持选择多个组件
- 关键词：任何合法的任何字符串。选填，关键词之间以空格分割，支持 regex
点击「日志搜索」按钮后，会进入下面详情页面，如下图：
2. 日志搜索进度
搜索进度在左边栏中，可以展示当前搜索的进度、状态以及每个节点日志搜索状态和统计等，搜索进度中还包括下载日志功能，见下小节图。展示状态示例：
- 运行中：开始搜索后，所有任务会进入「运行中」状态
- 成功：任务完成后自动转到「成功」，此时日志已缓存在 Dashboard 后端所在的本地磁盘中，可以提供给前端下载
- 失败：用户主动取消，或者某种原因报错退出的任务进入「失败」状态。任务失败时会自动清理本地临时文件
包含三个控制按钮：
- 下载选中日志：下载被勾选组件的日志(只有已完成的才能被勾选)
- Cancel： 取消所有正在运行的任务 ，只能在有运行中的任务时才能点击
- Retry：重试所有失败的任务 ，只有在有失败任务且无正在运行的任务时才能点击
3. 日志搜索结果
日志搜索结果展示各个节点的日志信息。
主要包括以下 4 项信息：
- 时间：日志产生的时间，时区与前端用户所处时区相同
- 日志等级：日志 WARN、ERROR 等日志等级
- 组件类型：显示组件名称，目前主要有 TiDB、TiKV、PD
- 日志：每条日志记录的正文部分，不包含日志的时间和日志等级。过长的日志，会自动截断，鼠标悬停可以查看完整的日志，完整日志最长显示 512 个字符。如下图：
4. 日志导出功能
搜索结果可以在右边栏中看到日志下载功能，用户可以选择要下载的组件日志。
点击「下载选中日志」按钮，自动下载日志压缩包到本地，供用户分析查看，如下图：
- 当选择一个组件时会返回 zip 文件，解压得到 log 文本文件
- 当选择多个组件时会返回 tar 文件，解压得到多个 zip 文件，解压 zip 得到 log 文本文件