# **MindStudio Insight基础操作**
## 简介
MindStudio Insight工具为可视化调优工具，首先需完成工具基础配置的适配与常用操作的熟悉。本文档主要介绍主题与语言配置、数据导入、数据管理、日志管理的操作，以及快捷键相关信息。
## 安装说明
请先安装MindStudio Insight工具，具体安装步骤请参见[MindStudio Insight安装指南](../install_guide/mindstudio_insight_install_guide.md)。
## 设置主题与语言
**设置主题**
1. 打开MindStudio Insight工具。
2. 单击界面右上方，切换主题，可切换为亮色或者暗色主题。
**设置语言**
1. 打开MindStudio Insight工具。
2. 单击界面右上方，切换MindStudio Insight工具的中英文。
## 导入数据
MindStudio Insight工具支持三种数据导入方式，本节主要介绍数据导入的操作步骤。不同调优场景支持的数据格式不同，导入前建议先确认数据来源和文件类型是否匹配。
| 调优场景 | 常见导入数据 | 详细说明 |
| --- | --- | --- |
| 系统调优 | `json`、`db`、`csv`、集群分析目录 | 参见[系统调优数据说明](./system_tuning.md#数据说明)。 |
| 算子调优 | `trace.json`、`visualize_data.bin` | 参见[算子调优数据说明](./operator_tuning.md#数据说明)。 |
| 内存调优 | `memscope_dump_*.db`、`pickle` | 参见[内存调优数据说明](./memory_tuning.md#数据说明)。 |
| 服务化调优 | `profiler.db`、`chrome_tracing.json`、`ms_service_*.db` | 参见[服务化调优数据说明](./service_optimization.md#数据说明)。 |
**操作步骤**
- 方式一：选择性能数据路径
1. 打开MindStudio Insight工具，单击界面左上方“导入数据”。
2. 在弹窗中选择性能数据文件或目录，然后单击“确认”进行导入，如[**图 1** 选择路径](#选择路径)所示。
**图 1** 选择路径
- 方式二：输入性能数据路径
1. 打开MindStudio Insight工具，单击界面左上方“导入数据”。
2. 在弹窗中的输入框直接输入需要导入的性能数据所在正确路径，然后按键盘上的“ENTER”键，在下方自动定位至该目录。
3. 单击“确认”进行导入，如[**图 2** 输入正确路径](#输入正确路径)所示。
**图 2** 输入正确路径
- 方式三：拖拽性能文件至MindStudio Insight工具界面
打开MindStudio Insight工具，将性能文件拖拽至MindStudio Insight工具界面打开，展示对应页面。可支持拖拽单文件和单文件夹性能数据。
> [!NOTE]
>
> - 仅支持本地磁盘数据导入，如果是网络磁盘，则需要先将网络磁盘映射至本地，再导入对应目录，网络磁盘映射至本地的操作请参见[MindStudio Insight工具拖入网络磁盘目录无法加载数据](../support/faq.md#faq-network-disk-import)。
> - 如果Windows系统上的MindStudio Insight工具在拖入文件时，显示禁用，请参见[MindStudio Insight工具拖入文件显示禁用](../support/faq.md#faq-drag-file-disabled)解决。
**导入失败排查**
| 现象 | 可能原因 | 处理建议 |
| --- | --- | --- |
| 导入后没有展示目标页签 | 导入数据中缺少该页签所需文件或采集开关未开启 | 对照对应调优指南的数据说明，确认数据文件是否完整。 |
| 导入目录后页面为空 | 选择了错误层级目录，或目录中没有可解析文件 | 重新选择包含性能数据文件的根目录或指定文件。 |
| 拖拽文件无效 | 网络磁盘、系统权限或拖拽能力受限 | 使用“选择性能数据路径”或“输入性能数据路径”方式导入。 |
| 导入大文件耗时较长 | 数据量较大或需要预处理 | 等待解析完成；集群大数据建议先使用对应工具预处理后再导入。 |
| 仍无法定位原因 | 需要查看日志或 FAQ | 日志路径参见[管理日志](#管理日志)，常见问题参见[FAQ](../support/faq.md)。 |
## 管理数据
MindStudio Insight工具导入数据后，在数据管理器下会将当次导入的数据生成一个工程，该工程下显示当次导入数据的详情。MindStudio Insight具有数据记忆、数据管理以及数据对比功能。
**数据记忆**
当再次打开同一个版本的MindStudio Insight工具时，在界面左侧导航栏会自动记忆并展示上一次关闭工具时的数据。
**数据管理**
主要介绍在MindStudio Insight界面创建、删除、添加，以及修改数据工程信息的操作。
**表 1** 数据管理操作
|操作|步骤|
|--|--|
|创建数据工程|单击界面左上方“导入数据”，成功导入后，在数据管理器列表中自动创建一个数据工程。|
|修改数据工程名称|在数据管理器列表中，选择所需工程，在工程名称上双击鼠标左键，输入新的名称，即可修改工程名。|
|删除单个数据工程|单击工程行后面的，删除该工程。|
|删除多个数据工程|单击导入数据左侧的，勾选需要删除的工程，默认勾选全部工程，单击数据管理器列表中全部按钮所在行的，删除所选工程。|
|工程内导入数据|单击工程行后面的，在该工程下导入数据。|
|工程内删除数据|单击工程内所选数据行后面的，删除该工程内所选数据。|
|查看数据路径|在数据管理器列表中，选择所需工程或数据，单击鼠标右键，选择在文件资源管理器中打开，即可跳转至对应的数据文件路径。|
> [!NOTE]
>
> 删除数据工程操作不会影响原始的性能文件。
**数据对比**
MindStudio Insight工具支持单卡数据间的性能对比，也支持集群数据间的性能对比，需要设置基线数据和对比数据进行对比。
- 设置单卡对比
1. 选择需要设置为基线的卡目录，单击鼠标右键，选择“设置为基线数据”，设置当前选中卡为基线卡，如[**图 1** 设置基线数据](#设置基线数据)所示。
设置完成后，当前卡目录会标识颜色。在当前卡再次单击鼠标右键，选择“取消设置基线数据”，可直接取消当前卡的基线状态；也可重新选择任意一张卡目录，单击鼠标右键，选择“设置为基线数据”，则会重新将当前所选卡作为基线数据。
**图 1** 设置基线数据
2. 选择需要作为对比卡的卡目录，单击鼠标右键，选择“设置为对比数据”，设置所选卡为对比卡，如[**图 2** 设置对比数据](#设置对比数据)所示。
设置完成后，对比卡目录会标识颜色，且区别于基线数据目录的颜色。对比数据只能选择当前打开的工程下的卡目录作为对比卡。在当前对比卡上再次单击鼠标右键，选择“取消设置对比数据”，可直接取消当前对比卡的对比状态；也可重新选择任意一张卡目录，单击鼠标右键，选择“设置为对比数据”，则会重新设置对比数据。
**图 2** 设置对比数据
3. 基线数据和对比数据设置成功后，可前往时间线（Timeline）、内存（Memory）以及算子（Operator）界面查看数据对比详情。
- 设置集群对比
1. 选定一个对比数据，当前选中显示的数据即为对比数据。
2. 选择基线数据。
选择需要设置为基线的集群目录，单击鼠标右键，选择“设置为基线数据”，如[**图 3** 设置基线数据](#设置基线数据2)所示。
设置完成后，当前集群目录会标识颜色。在当前集群目录再次单击鼠标右键，选择“取消设置基线数据”，可直接取消当前集群目录的基线状态；也可重新选择任意一个集群目录，单击鼠标右键，选择“设置为基线数据”，则会重新将当前所选集群目录作为基线数据。
> [!NOTE]
>
> 当在某一个工程中导入的集群数据目录为“cluster\_analysis\_output”时，也可选择该工程下的此数据设置为基线数据。
**图 3** 设置基线数据
3. 基线数据设置成功后，可前往概览（Summary）和通信（Communication）界面查看数据对比详情。
## 管理日志
**查看日志存放路径**
查看日志文件存放路径有两种方式，一种是直接查看路径，另一种是可在界面操作。
- 日志文件存放路径
MindStudio Insight工具的日志文件存放路径请参见[**表 1** 日志文件存放路径](#日志文件存放路径)。
**表 1** 日志文件存放路径
|系统|日志存放路径|
|--|--|
|Windows|- 安装路径为C盘，日志路径为：C:\Users\\{*用户名*}\\.mindstudio_insight
- 安装路径为其他目录，日志路径为：{*安装目录*}\\.mindstudio_insight|
|Linux|$HOME/.mindstudio_insight|
|macOS|/Users/{*用户名*}/.mindstudio_insight|
- 界面操作
在MindStudio Insight工具界面中，单击右上方，选择“在资源管理器中显示日志”，即可进入日志存放目录进行查看。
> [!NOTE]
>
> 此功能仅支持Windows系统和macOS系统。
**日志文件说明**
MindStudio Insight工具的日志文件名称为“profiler\_server\_\{_端口号_\}\_\{_编号_\}.log”，为程序运行日志，主要供开发者定位问题使用。
**日志清理机制**
MindStudio Insight工具的日志清理方式包括自动清理和手动清理。
- 自动清理
MindStudio Insight工具的日志文件具有自动清理机制。由于MindStudio Insight工具每个端口仅支持存放10个日志文件，所以当日志文件数量超过10个后，后续生成的日志文件会自动从第一个日志文件开始覆盖，依次循环，且单个日志文件大小不超过10MB。
- 手动清理
进入日志文件存放路径，手动删除对应日志文件，日志存放路径参见[查看日志存放路径](#日志文件存放路径)。
## 常用快捷键
本节介绍MindStudio Insight工具的常用快捷键。也可在MindStudio Insight工具界面中，单击右上方，选择“键盘快捷键”，查看快捷键信息。
**表 1** 常用快捷键
|快捷键|说明|
|--|--|
|W|放大时间线（Timeline）界面的图形化窗格。|
|S|缩小时间线（Timeline）界面的图形化窗格。|
|Ctrl + 鼠标滚轮|缩小、放大时间线（Timeline）界面的图形化窗格。如果是macOS系统，需要使用Command + 鼠标滚轮。|
|Alt + 鼠标左键|放大时间线（Timeline）界面框选的区域。如果是macOS系统，需要使用Option + 鼠标左键。|
|Shift + Z|将时间线（Timeline）界面框选区域放大至当前屏幕。|
|Backspace|撤销一次时间线（Timeline）界面图形化窗格的缩放。|
|A/左方向键|左移时间线（Timeline）界面的图形化窗格。|
|D/右方向键|右移时间线（Timeline）界面的图形化窗格。|
|Ctrl + 鼠标左键|拖动可左右移动时间线（Timeline）界面的图形化窗格。如果是macOS系统，需要使用Command + 鼠标左键。|
|上方向键|上移时间线（Timeline）界面的图形化窗格。|
|下方向键|下移时间线（Timeline）界面的图形化窗格。|
|Ctrl + 0|重置时间线（Timeline）界面的图形化窗格。如果是macOS系统，需要使用Command + 0。|
|M|框选时间线（Timeline）界面所选的单个算子区域，再次按下M键，可取消框选。|
|L|在时间线（Timeline）界面，选中算子后，将选中算子与基准算子的开始时间（左边界）对齐。|
|R|在时间线（Timeline）界面，选中算子后，将选中算子与基准算子的结束时间（右边界）对齐。|
|Q|收起或展开时间线（Timeline）界面底部的面板。|
|K|在时间线（Timeline）界面，使用K键可快速设置区域标记和单点标记。|
|Shift + 鼠标滚轮/Ctrl + 鼠标拖动|在流水并行图和通信算子缩略图中，可左右移动图表。|
|Ctrl + 鼠标滚轮|在流水并行图和通信算子缩略图中，可放大或缩小图表。|
|Ctrl + F|调出源码（Source）界面源文件代码区域的搜索框，进行搜索。如果是macOS系统，需要使用Command + F。|
## 帮助文档
本节介绍MindStudio Insight工具的文档查看功能。若遇到问题，可优先在MindStudio Insight工具界面中，单击右上方，选择“帮助文档”查看本工具的资料文档。若仍然无法解决问题，可单击“[求助与反馈](#求助与反馈)”，前往社区提交issue寻求帮助。
## 求助与反馈
本节介绍MindStudio Insight工具的求助与反馈功能。如果您有解决不了的问题、建设性意见或者建议，可通过MindStudio Insight工具界面，单击右上方，选择“求助与反馈”前往社区寻求帮助或者提交反馈。