TecoHotSpots

TecoHotSpots是一款性能调优插件，能够帮助开发人员快速地了解程序的性能瓶颈、资源利用率等信息，从而提高程序的性能和效率。

TecoHotSpots使用条件

• TecoDevTools >= 1.5.0b0

Windows/Mac端环境部署

• 打开Visual Studio Code工具，点击工具左侧的**扩展（Ctrl+Shift+X）**按钮
• 在应用商城中搜索Remote - SSH扩展，点击安装。

远程服务器端环境部署

初次安装TecoHotSpots后，需要在远程服务器端配置编译环境，程序调试功能才能正常使用。

• 根据Remote - SSH操作介绍，连接远程服务器
• 打开远程服务器的~/.bashrc文件，增加环境变量source /opt/tecoai/setvars.sh，保存退出。
• 执行source ~/.bashrc命令，刷新并执行~/.bashrc文件。
• 执行rm -rf ~/.vscode-server命令，删除VSCode缓存的历史环境变量。
• 在应用商城中搜索TecoHotSpots扩展，点击安装，安装完成后右下角会有弹窗，点击重新加载
• 安装时需注意，不要安装在本地，选择已连接的远程服务器安装

工程管理

创建工程

前提条件

在远程服务器创建一个空文件夹。

注意事项

在VSCode示例工程中提供的脚本为标准化脚本，在后续扩展中，请兼容此脚本，否则会导致程序调试和性能调优模块使用异常。

操作步骤

• 单击VSCode顶部菜单栏文件 > 打开文件夹，选择刚创建的空文件夹目录，单击确定。
• 在搜索框输入>，进入命令显示及搜索模式，或者使用键盘F1键，输入TecoStudio Create Project，在搜索结果中单击该命令。

• 输入需要创建的工程名称（不含特殊字符），单击回车。

执行结果

单击左侧导航栏的，可以查看到新创建的工程文件列表。该工程包含以下4个文件：

• build.sh：构建脚本。
• CmakeLists.txt：工程文件。
• device.scpp：源文件1。
• main.scpp：源文件2。

插桩管理

配置插桩

在新增插桩前，您需要配置插桩，选择需要采集的性能项。

注意事项

• 性能项支持多选，但部分性能项存在互斥关系，请根据页面的提示信息进行选择。
• **查看代码执行开销（CYCLE）**性能项为默认选中状态。

操作步骤

• 单击VSCode顶部菜单栏的文件 > 打开文件夹，打开目标工作目录。
• 单击VSCode左侧导航栏的，插桩管理区域提供插桩配置选项。

• 根据实际情况进行选择，执行编译时可以采集相关的性能数据并进行展示。

新增插桩

您可以通过新增插桩功能，在编译前对代码进行插桩，并在编译后查看对应代码段的执行周期、指令缓存MISS次数等性能数据。

注意事项

• 新增插桩时，鼠标的光标需要在待插桩的文件内。

• 插桩需要成对，如果不成对，会导致性能项数据采集异常。
• 目前暂不支持嵌套插桩，嵌套插桩，以插桩对A和插桩对B为例：
  • 插桩对A和插桩对B之间产生交集。
  • 插桩对A里的代码与插桩对B里的代码存在调用关系（如下图所示）。

单次插桩

• 单击VSCode左侧导航栏的。

• 在资源管理器页面，双击打开需要插桩的源文件。

• 在需要新增插桩的代码行，右击左侧空白区域。

• 在弹出的菜单中选择添加插桩/添加单行插桩对。

  • 添加插桩：只能在代码位置添加一个start/end状态，获取代码段的性能数据。
  • 添加单行插桩对：在代码位置添加完整的start&end状态，获取单行的性能数据。

  您也可以通过快捷键的方式进行单次插桩： 在需要加插桩的代码行，移动鼠标光标至代码所在行，通过快捷键Ctrl+Alt+J，为该行添加单行插桩对。

  

执行结果

在相应的代码前，显示插桩标识，表示插桩成功。

• 使用添加插桩功能：

• 使用添加单行插桩对功能：

连续插桩

• 单击VSCode左侧导航栏的。
• 在资源管理器页面，双击打开需要插桩的源文件。
• 通过快捷键Ctrl + Alt + L，开启连续插桩功能。
• 在需要新增插桩的代码行，移动鼠标光标至代码行左侧空白区域，待出现红点标识符号时，鼠标左击，为该行添加插桩。

删除插桩

删除插桩，以便进行二次选择/清空插桩对。

注意事项

插桩必须成对，如果不成对，会导致删除功能异常。目前暂不支持删除单个插桩，使用删除功能时，需要保证插桩成对出现。 如下图所示，start 0未成对执行删除动作，会提示插桩对没有完成，无法删除。

删除单个插桩对

方式一

• 单击VSCode左侧导航栏的。
• 在资源管理器页面，双击打开需要删除插桩对的源文件。
• 在需要删除插桩对的代码行，鼠标右键单击对应行号的左侧空白区域，在弹出的菜单中选择删除插桩对。

方式二

• 单击VSCode左侧导航栏的。
• 在资源管理器页面，双击打开需要删除插桩对的源文件。
• 鼠标悬停在插桩的start位置（停留在区间无效），通过快捷键Ctrl + Alt + 2进行单插桩对删除。

删除所有插桩对

• 单击VSCode左侧导航栏的。
• 在运行和调优页面的插桩管理区域，单击删除全部插桩按钮，删除工程里的所有插桩对。

编译脚本

前提条件

请确保编译环境已完成部署，可参考配置编译环境。

注意事项

在VSCode示例工程中，提供的脚本为标准的性能调优脚本，您在后续扩展中，请兼容此脚本，否则会导致调优模块使用异常。

操作步骤

• 单击VSCode左侧导航栏的。
• 在编译工程区域，通过选择工程文件的下拉框，选择需要编译的工程文件。

• 单击下拉框右侧的，执行编译。

执行结果

输出窗口会显示完整的编译过程。

查看性能数据

查看性能数据可以获取函数名称、执行拍数，和平均拍数等数据。

前提条件

源文件中有插桩，且插桩区间的代码可以被执行到。

操作步骤

• 单击VSCode左侧导航栏的。

• 在运行和调优页面的插桩管理区域，选择运行结果页签，查看性能数据列表。

  说明：拍数默认显示计算核心阵列SPA中的最大值。

  

  • 查看指定插桩对的所有计算核心SPE的数据：选中目标行，鼠标右键单击查看所有计算核心SPE数据。

  

  • 返回查看默认数据：单击插桩管理右侧的返回按钮。