--- title: 创建HPC应用任务 description: "HPC应用分析通过采集系统的PMU事件并配合采集面向OpenMP和MPI应用的关键指标，帮助用户精准获得Parallel Region及Barrier-to-Barrier的串行及并行时间、校准的L2层微架构指标、指令分布及L3的利用率和内存带宽等信息。" url: https://www.hikunpeng.com/document/detail/zh/kunpengdevkithistory/devkit_25_1_rc1/usermanual/devkit-hypertuner-061.html sourcePath: /source/zh/kunpengdevkithistory/devkit_25_1_rc1/usermanual/devkit-hypertuner-061.html indexId: 03706adbeaf7bc94ad8f23cd97a400df514c9d938bfdbbb04f6d5b244bfb3f2185 --- # 创建HPC应用任务 #### 功能描述 HPC应用分析通过采集系统的PMU事件并配合采集面向OpenMP和MPI应用的关键指标，帮助用户精准获得Parallel Region及Barrier-to-Barrier的串行及并行时间、校准的L2层微架构指标、指令分布及L3的利用率和内存带宽等信息。 采集OpenMP数据时，将开启内核参数/proc/sys/kernel/kptr_restrict和/proc/sys/kernel/perf_event_paranoid，以便采集call graph数据和PMU事件；当采集结束后会将内核参数恢复原值。 #### 前提条件 - 不存在“离线”状态的节点。 - HPC应用分析只支持Kunpeng 920 CPU的物理服务器上使用，且HPC应用任务中Top-Down和DRAM带宽数据需要操作系统内核4.19及以上或patched openEuler 4.14内核及以上。 - Ubuntu系统中HPC应用分析任务数据采集可能会失败，详情请参见 Ubuntu系统HPC应用分析任务数据采集失败 ；其中Ubuntu 20.04.1暂不支持HPC应用分析任务。 - 若使用MPICH，需将libmpi.so.12所在路径添加到LD_LIBRARY_PATH中，一般为MPICH安装路径的lib文件夹。 - 使用的MPI（OpenMPI/MPICH）需使能C/C++/Fortran三种语言，以OpenMPI使用GCC编译器为例：--enable-mpi-compatibility CC=gcc CXX=g++ FC=gfortran。 - OpenMPI需4.1.6及以上兼容版本，优选4.1.6版本；MPICH需4.3.0及以上兼容版本，优选4.3.0版本。 #### 创建HPC应用分析任务 1. 单击系统性能分析后面的。 选择“通用分析”，打开新建任务页面。 2. 参考“任务管理”和表1配置任务参数。 创建HPC应用分析任务，如图1所示。 图1 新建HPC应用分析任务 表1 新建HPC应用分析任务参数说明 参数 说明 任务名称 输入分析任务的名称。名称需要满足如下要求： 只能由中文、字母、数字和下划线组成。 长度为1~64个字符。 选择节点 选择需要分析的节点；只有一个节点时默认勾选，最多支持10个节点。仅采集模式为“OpenMP模式”时需配置。 分析对象 选择“应用”。当前仅支持“应用”。 模式 选择“Launch application”，当前仅支持“Launch application”。 分析对象选择“应用”时需配置此参数。 应用路径 输入待分析应用的绝对路径。例如分析保存在“/home/test”目录下的“loop_test”应用，则输入：/home/test/loop_test。 说明： 默认分析“/opt/”或者“/home/”目录下的应用，管理员用户可在首页右上方的“>工具设置>系统性能分析>系统设置”中，手动配置“应用程序路径配置”，路径之间采用分号分隔。仅管理员用户可修改，普通用户只有查看权限。 应用程序路径建议配置为“/home”、“/opt”等，请不要配置为“/”、“/dev”、“/sys”、“/boot”等系统目录，否则可能导致系统异常。 对于保存应用的目录，系统性能分析工具程序的操作系统运行用户（devkitworker1）对于待分析的应用需要有可读可执行权限。 多节点场景下，打开“配置指定节点参数”选项可单独配置各节点的该参数。 应用参数（可选） 输入应用参数，请根据实际应用场景填写。 说明： 打开“配置指定节点参数”时各节点可单独配置该参数。 应用运行用户（可选） 运行应用的操作系统用户信息。应用默认运行在工具内置devkitworker1用户下；如果应用运行对用户有依赖，需打开选项配置对应的用户密码后在对应用户下执行。 采集模式为“OpenMP模式”时可配置，默认关闭。 用户名 输入运行应用的操作系统用户。 “应用运行用户”选项打开时需配置。 密码 输入用户的密码。 “应用运行用户”选项打开时需配置。 分析类型 选择“HPC应用分析”。 采样时长（s） 设置采样的时间；默认为300秒，采样模式选“Detail模式”时取值范围1~600秒，采样模式选“Summary模式”时取值范围1~1800秒。如超过范围会有提示并自动失焦后回填。 采集模式为“MPI/MPI+OpenMP混合模式”时默认为“限制应用运行时长”；可选“不限制应用运行时长”，开启将采集到应用运行结束。 说明： 任务采集时需一定内存空间，采样时长越久，存储和分析时间也会相应增加；若选择“不限制采样时长”，请确保应用能正常运行结束，不会将系统资源耗尽。 采样时间太短，应用未完成运行可能造成任务失败。 延迟采样时长（s） 用于指定时间后执行分析，可以忽略程序的启动流程分析或用于采集程序热身，消除环境检测等带来的采集延迟。默认为0秒，取值范围0~900秒。如超过范围会有提示并自动失焦后回填。 配置指定节点参数（可选） 根据需求配置指定节点参数；如无需单独配置各节点参数，全部节点都将以当前配置参数执行。 采集模式选择“OpenMP模式”，且在有多个节点时可配置此参数。 采集模式 选择采集类型。可选择以下两种： OpenMP模式 MPI/MPI+OpenMP混合模式 MPI Only（可选） 仅采集MPI相关数据，不采集OpenMP数据。 默认关闭，采集模式选择“MPI/MPI+OpenMP混合模式”，分析模式选择“统计分析”时可在“高级配置”配置。 运行mpirun节点 选择运行mpirun的节点。 采集模式选择“MPI/MPI+OpenMP混合模式”时需要配置此参数。 共享目录 设置分析共享目录。采集模式选择“MPI/MPI+OpenMP混合模式”时需要配置此参数。 支持共享目录在/opt/或/home/或/mysharedir/下，配置路径请联系管理员。 说明： 共享目录的权限请合理配置，避免因权限过大造成网络不安全。 集群检查账户 设置运行用户。默认为mpirun运行用户，可选“root用户”。 说明： 使用root用户执行集群检查需要保证集群中root已经配置好免密登录。 集群环境节点重启后，需要使用root用户完成集群检查，否则perf相关采集配置不支持普通用户下执行mpirun。 root用户密码 输入root用户的密码。 采集模式选择“MPI/MPI+OpenMP混合模式”，集群检查账户选择“root用户”时需配置。 mpirun参数（可选） 设置MPI环境变量-x的参数。 采集模式选择“MPI/MPI+OpenMP混合模式”时可配置此参数。 说明： 参数中需明确指定任务节点（如--hostfile），仅使用-np参数将使任务随机发至送节点，导致集群检查和MPI运行环境不一致，造成任务失败。 mpirun所在路径 配置MPI所在路径。 采集模式选择“MPI/MPI+OpenMP混合模式”时需配置此参数。 rankfile（可选） 上传rank配置文件。文件内容格式如：rank =<主机名> slot=。 采集模式选择“MPI/MPI+OpenMP混合模式”时可选配置此参数。 分析模式 配置分析模式，默认为统计分析，可选“统计分析”和“精细化分析”。 说明： 参与MPI的多个节点需已配置SSH免密，如果未配置，请针对运行mpirun的用户配置SSH免密。 采集critical path（可选） 配置是否采集critical path，默认关闭。 采集模式选择“MPI/MPI+OpenMP混合模式”，分析模式选择“统计分析”时可配置。 基础信息采集（可选） 配置是否采集RDMA或共享存储数据，默认不勾选。 采集模式选择“MPI/MPI+OpenMP混合模式”，分析模式选择“精细化分析”时可配置。 基础信息采样间隔 配置采集RDMA或共享存储数据的采样间隔，默认1秒，取值范围1-15秒。 采集模式选择“MPI/MPI+OpenMP混合模式”，分析模式选择“精细化分析”并勾选“基础信息采集”中选项可配置。 采样模式 配置数据采集模式，默认为“Detail模式”。分析模式为“统计分析”时需配置。 Summary模式：采集基础指标，采集分析开销较小。 Detail模式：采集热点函数及详细指标，采集分析开销较大。 统计更多调用栈信息（可选） 配置是否采集callstack和Top-Down数据。默认关闭，分析模式选择“精细化分析”时在“高级配置”中可配置。 3. 单击“确认”完成分析任务的创建。 单击任务名称后面对应的图标可以执行如下操作： - ：取消分析任务，取消分析任务后，已采集的信息会被删除；或开始分析，开始分析将中断当前采集阶段，使用已采集数据进行分析；存在因应用中途停止导致任务失败的可能性。 - ：重启分析任务，可修改任务参数配置并重新启动分析任务，取消任务或任务失败时可使用。 - ：删除分析任务，删除分析任务会将该分析任务下的数据都删除，请谨慎操作。 - ：再次分析任务，自动命名任务并重新启动分析任务。 - ：修改任务或报告名称，可修改对应任务或报告名称（报告名称规则同任务名称一致）。