81c78c7b创建于 10 小时前历史提交

FAQ

1. Windows 运行 MindStudio Insight 时出现 Missing Dependencies 报错怎么办？

问题现象

在 Windows 系统运行 MindStudio Insight 时，出现 Missing Dependencies 报错弹窗，且工具无法启动。

原因分析

系统缺少 MindStudio Insight 运行依赖的 WebView2 Runtime 组件。

解决方案

单击链接，进入 Microsoft 官网。
下载 “Evergreen Standalone Installer” 中的 x64 安装包，如[图 1 WebView2 安装包](#WebView2 安装包)所示。

图 1 WebView2 安装包
安装完成后，重新运行 MindStudio Insight。

2. 如何重新解析 text 格式的 Profiling 文件？

问题现象

在同一版本的 MindStudio Insight 中，再次导入 text 格式的 Profiling 文件时，工具不会重新解析数据。如果需要重新解析数据，可以按如下方法处理。

解决方案

删除 Profiling 数据目录中的解析结果文件 mindstudio_insight_data.db 后，再次导入数据即可重新解析。

3. EulerOS 等系统无法弹出数据导入选择框怎么办？

问题现象

在 EulerOS 等系统上运行 MindStudio Insight 时，单击界面左上方工具栏中的，无法弹出导入选择框。

解决方案

登录到待安装 MindStudio Insight 的环境。

执行以下命令，设置环境变量。

export WEBKIT_DISABLE_COMPOSITING_MODE=1

执行以下命令，启动 MindStudio Insight。
```
./MindStudio-Insight
```

4. X11 转发方式下输入框粘贴内容有误怎么办？

问题现象

在 Linux 系统中，通过 X11 转发方式运行 MindStudio Insight 时，在输入框已存在信息情况下，重新粘贴所需信息时会出现错误。

原因分析

在 Linux 系统中，通过 X11 转发方式运行 MindStudio Insight 时，默认开启了“copy on select”，导致剪贴板的信息会变为输入框已存在信息，造成输入框信息粘贴有误。

解决方案

方案一：

在远程登录工具菜单栏单击“Settings > Configuration“。此处以 MobaXterm 工具为例。
选择“X11”页签，在“Clipboard”选项中选择“disable"copy on select"”，如[图 1 MobaXterm Configuration](#MobaXterm Configuration)所示。

图 1 MobaXterm Configuration
单击“OK”。
完成配置后，重新运行 MindStudio Insight。

方案二：

在 MindStudio Insight 界面，先删除输入框中已存在的信息，再重新复制粘贴所需信息。

5. 拖入网络磁盘目录无法加载数据怎么办？

问题现象

在 MindStudio Insight 导入数据时，选择网络磁盘目录，无法导入。

原因分析

MindStudio Insight 仅支持导入本地磁盘目录，而网络磁盘未映射至本地，无法导入。

解决方案

打开电脑的文件资源管理器。
单击“此电脑 > 映射网络驱动器”，弹出“映射网络驱动器”弹窗，如图 1 映射网络驱动器。

图 1 映射网络驱动器
下拉“驱动器(D)”选框，选择连接指定的驱动器号。
单击“文件夹(O)”后的“浏览”，选择所需映射的网络目录。
单击“完成(F)”，完成网络目录至本地的映射操作。
打开 MindStudio Insight，重新选择映射后的目录，即可正常导入。

6. 运行时出现 Out of Memory 报错怎么办？

问题现象

在 MindStudio Insight 运行时，页面出现错误代码：Out of Memory。

原因分析

当前使用的电脑系统整体内存不足。

解决方案

自行关闭消耗大量内存的程序和不必要的应用，释放电脑系统内存。
在 MindStudio Insight 报错页面单击“刷新”按钮，重新加载页面。

7. Windows 安装后拖入文件显示禁用怎么办？

问题现象

在 Windows 系统上安装 MindStudio Insight 时，选择勾选“Run MindStudio Insight“自动打开MindStudio Insight的情况下，拖入文件显示禁用。

解决方案

关闭当前已打开的 MindStudio Insight。
双击桌面的“MindStudio Insight”快捷方式图标，或安装目录下的“MindStudio-Insight.exe”，重新打开 MindStudio Insight。
拖入文件，即可正常显示。

8. Linux 启动时出现 swrast_dri.so 缺失报错怎么办？

问题现象

在 Linux 系统中使用“X11 方式”或“VNC 方式”启动 MindStudio Insight 时，工具界面白屏，出现“cannot open shared object file swrast_dri.so”报错信息，如图 1 报错截图所示。

图 1 报错截图

原因分析

可能是缺少依赖。

解决方案

执行以下命令，安装转发依赖文件。
```
yum install -y mesa-dri-drivers
```
安装完成后，重新打开 MindStudio Insight即可。

9. 启动 VNC 时出现 “Oh no! Something has gone wrong.” 报错怎么办？

问题现象

在 Linux 系统上，使用“VNC 方式”启动 MindStudio Insight 时，启动VNC，出现“Oh no! Something has gone wrong.”报错弹窗，如图 1 报错信息所示。

图 1 报错信息

原因分析

可能是未开启AllowTcpForwarding。

VNC在某些情况下需要通过SSH通道来实现连接，而TCP转发正是支持这个功能的关键。如果AllowTcpForwarding被关闭，则SSH不允许使用端口转发，因此无法通过SSH通道访问VNC服务。开启AllowTcpForwarding后，就能在本地或远程通过SSH通道连接到VNC服务。

解决方案

需要配置SSH服务端。

进入/etc/ssh/路径，打开sshd_config文件。
修改文件中的AllowTcpForwarding为“yes”。
执行以下命令，重启SSH服务端。
```
systemctl restart sshd
```
重启成功后，重新打开新的窗口启动 VNC。

10. OpenEuler 及其衍生系统安装依赖时提示找不到依赖怎么办？

问题现象

在 Linux 操作系统上，OpenEuler 及其衍生操作系统在安装依赖时，提示找不到相关依赖。

原因分析

配置的源没有相关依赖。

解决方案

可参见链接配置新的源，并重新安装对应依赖。

11. 导入数据时页面显示黑屏怎么办？

问题现象

在MindStudio Insight 页面，第一次导入数据显示正常，第二次导入相同的数据时，“概览”界面和“通信”界面显示黑屏。

解决方案

方案一：关闭当前MindStudio Insight，重启即可恢复正常。

方案二：在当前MindStudio Insight工具页，查看或导入其他的数据后，再次选择查看刚才的数据，页面即可恢复正常。

12. 导入数据后通信界面未显示数据怎么办？

问题现象

使用 MindStudio Insight 导入数据后，通信界面未显示数据。

原因分析

当前导入的性能数据目录与以ascend_ms结尾的目录之间存在多层子文件夹，例如：profiling/rank_x/dyn_prof_data/rank_x_start_xxx_end_xxx/xxx_ascend_ms，此时，MindStudio Insight 会将导入的数据识别为集群数据，导致通信界面显示异常。

解决方案

找到以ascend_ms结尾的目录，将其拷贝至新创建的目录下，保证该目录层级为_目录名称_/ascend_ms结尾的目录，在 MindStudio Insight 中重新导入该目录，即可正常显示。

13. TencentOS Server 4.4_x86 中启动失败怎么办？

问题现象

在Linux的TencentOS Server 4.4_x86操作系统中，启动 MindStudio Insight，启动失败，报错信息如下：

** (MindStudio-Insight:302256): WARNING **: 08:07:35.531: webkit_settings_set_enable_offline_web_application_cache is deprecated and does nothing.
JIT session error: Missing definitions in module fs789_variant0_6-jitted-objectbuffer: [ fs_variant_whole ]
Failed to materialize symbols: { (fs789_variant0_6, { fs_variant_partial, fs_variant_whole }) }
JIT session error: Could not find symbol at given index, did you add it to JITSymbolTable? index: 4, shndx: 0 Size of table: 5
Failed to materialize symbols: { (fs790_variant0_7, { fs_variant_partial }) }

解决方案

执行以下命令后，重新启动 MindStudio Insight。

export JSC_useJIT=0
export JSC_useDFGJIT=0
export JSC_useFTLJIT=0
export WEBKIT_DISABLE_COMPOSITING_MODE=1
unset HTTPS_PROXY
unset HTTP_PROXY

14. 导入文件时提示路径过长或嵌套层数过深怎么办？

问题现象

The nesting depth of the imported sub-file exceeds 5 or the sub-file path length exceeds

解决方案

首先排查是否文件路径过长，如果文件路径长度超过260则可以修改文件路径名称；
然后排查是否文件嵌套过深，如以导入目录到trace_view.json文件的嵌套层数是否超过5层来判断，如果超过5层则可以修改嵌套深度；
检查导入文件是否为有效数据，文件是否有损坏或不完整
如果以上方法均无法解决问题，请联系 MindStudio Insight 工具接口人进一步定位。

15. System view 和 Operator 页签没有内容怎么办？

问题现象

在采集配置正常的情况下，采集到的 Profiling 数据在 MindStudio Insight 中 System view 没有内容，情况如下：

也可能表现为 Operator 页签无内容，如下：

原因分析

使用 torch_npu 旧版本，如 2.5.1.post1.dev20250722 时，采集到的 operator_memory.csv 文件中 Device 信息不正确，在进行 ASCEND_RT_VISIBLE_DEVICES 资源配置时，每个 Device 会存在 Device ID 和 Device 索引值两个概念，operator_memory.csv 中记录了 Device 索引值，与其他文件的 Device ID 不一致，导致 System view、Operator 界面无法正常显示。2025/08/06 后的 torch_npu 已修复此问题。

解决方案

手动修改 operator_memory.csv 内容

根据配置的 ASCEND_RT_VISIBLE_DEVICES 信息，修改 operator_memory.csv 文件中的 Device Type 列内容。

注意，此处应修改为局部 Device ID，而非全局 Rank ID。举例，若单节点 8 卡，双节点共 16 卡，全局 Rank ID 为 0 至 15，而 Device ID 为 0 至 7；Rank ID = 8 为第二个节点 Device ID 为 0 的卡，Rank ID = 9 为第二个节点 Device ID 为 1 的卡，以此类推。 2. 版本更新 2025/08/06 后的 torch_npu 已修复此问题，请更新 torch_npu 到 2025/08/06 后的版本。