CANN Runtime 错误码 EK0201 排查指南：Profiling 采集时 Host 内存不足

CANN Runtime 错误码 EK0201 排查指南Profiling 采集时 Host 内存不足【免费下载链接】runtime本项目提供CANN运行时组件和维测功能组件。项目地址: https://gitcode.com/cann/runtime本指南基于 CANN Runtime 开源仓库的 EK0201 错误码文档 编写并结合仓库内错误码注册表与 msprof 采集器源码帮助开发者快速识别、定位并解决 Profiling性能数据采集过程中因 Host 侧内存不足导致的内存申请失败问题。读完本文你将掌握 EK0201 的报错格式与触发场景、Host 内存被 Profiling 消耗的底层原因以及一套可落地的排查与释放内存的操作方案。错误码概览EK0201 属于Profiling ErrorsProfiling 错误类别错误类型为Resource_Error_Insufficient_Host_Memory即资源类错误中的Host 侧内存不足。该错误码在 src/dfx/error_manager/error_code.json 中注册错误码注册表是该仓库统一维护错误定义、错误消息与处置建议的唯一数据源。项目值错误码EK0201错误类别Profiling Errors错误标题Resource_Error_Insufficient_Host_Memory参数Arglistbuf_size本次尝试申请的内存大小可能原因内存分配因 Host 内存不足而失败解决建议停止不必要的进程确保所需内存可用在 src/runtime_compact/c_base/src/error_manager.c 中EK0201 同样被登记在精简版runtime_compact错误表中并给出了配套的可能原因Available memory is insufficient.与解决建议Close unused applications.说明该错误码在完整版与精简版运行时中均受支持。错误信息报错格式EK0201 的报错文本格式如下占位符%s表示本次 Profiling 尝试申请的内存大小Failed to allocate %s host memory for Profiling.报错示例Failed to allocate 100M host memory for Profiling.即 Profiling 尝试申请 100M 的 Host 内存时失败最终由错误上报机制将其格式化为带错误码前缀的完整消息例如EK0201: Failed to allocate host memory for Profiling: 100.这种错误码 错误消息的完整形态可在精简版运行时对应的单元测试 tests/ut/runtime/runtime_c/testcase/c_base/error_manager_test.cc 中看到测试通过REPORT_INPUT_ERROR(EK0201, ARRAY(buf_size), ARRAY(100))触发上报并校验输出消息。注意%s中的实际大小数值随触发路径不同而不同——它可能是100M这类以容量单位表示的大块缓冲也可能是new (std::nothrow)申请单个结构体失败时换算出的字节数如200B、64B。数值本身用于帮助判断是大块内存耗尽还是小额分配也失败后者通常意味着 Host 内存已处于极度紧张状态。可能原因EK0201 的直接原因是在 Profiling 数据采集相关流程中Host服务器侧 CPU 内存内存不足导致内存申请失败。从源码看new一个 Profiling 配置/步进信息结构体、初始化 Stamp 内存池、创建上传队列Uploader等动作失败时都会触发 EK0201 上报典型触发点包括触发点申请内容源码位置创建订阅配置aclprofCreateSubscribeConfigaclprofSubscribeConfig结构体prof_api_common.cpp创建图级 Profiling 配置aclgrphProfCreateConfigaclgrphProfConfig结构体prof_ge_core.cpp创建步进信息aclprofCreateStepInfoaclprofStepInfo结构体prof_acl_core.cppmsproftx Stamp 内存池初始化CURRENT_STAMP_SIZE大小的 Stamp 池msprof_tx_manager.cpp创建上传器CreateUploaderqueueSize大小的上传队列uploader_mgr.cpp从以上触发路径可以看出EK0201 不是某个特定 API 独享的错误码而是Profiling 全链路配置创建、Stamp 池、数据上传队列在 Host 侧分配内存失败时的统一出口。buf_size参数会随触发点不同而填入对应的申请大小帮助开发者判断是哪个环节的内存分配失败。底层调用链以最典型的aclprofCreateSubscribeConfig为例其内存分配调用链为aclprofCreateSubscribeConfig (ACL 应用侧 Profiling 配置) └─ new (std::nothrow) aclprofSubscribeConfig ← Host 内存分配失败返回 nullptr └─ MSPROF_ENV_ERROR(EK0201, {buf_size}, {sizeof 结果 B})new (std::nothrow)在内存不足时不会抛出异常而是返回nullptr随后代码判断subscribeConfig nullptr并上报 EK0201。采用std::nothrow形式分配失败通常意味着系统可用内存已接近枯竭malloc 层直接返回失败而非普通的内存碎片问题。解决方法第一步确认内存是否真的不足在 Host 侧执行以下命令查看系统当前可用内存free -h重点关注available一列。当available远小于 Profiling 报错中申请的内存大小时即可确认是内存不足导致。同时可用top或htop按内存占用排序找出占用最大的进程top -o %MEM第二步停止不必要的进程释放内存EK0201 的标准解决思路是停止不必要的进程并确保有足够的内存可用。根据实际场景可执行以下操作关闭非关键应用停止当前主机上与本次采集无关的图形界面、浏览器、开发环境等内存占用大户。清理后台训练/推理任务若同一主机上并行运行了多个训练或推理进程可暂停或结束非必要的任务为 Profiling 采集预留内存。检查其他 Profiling 进程确认是否有未正常退出的 msprof / Profiling 采集进程残留残留进程会持续占用 Host 内存必要时结束这些残留进程。评估并调整配置若 Profiling 配置中申请的内存过大如较大的 Stamp 池或上传队列可评估能否缩减采集范围例如只采集必要的 Device、减少数据类型如关闭多余的PROF_TASK_TIME_L2/L3等高级指标从而降低 Host 侧内存峰值。释放内存后重新触发 Profiling 采集即可。第三步验证恢复重新启动采集后若不再出现Failed to allocate ... host memory for Profiling类报错说明 Host 内存已恢复充足问题解决。预防建议建立内存水位监控在 Profiling 采集前检查free -h确保可用内存充足避免采集途中内存耗尽。规划并发任务避免在同一 Host 上同时启动过多重内存任务与 Profiling 采集。及时清理残留进程采集结束后确认 Profiling 相关进程正常退出防止内存泄漏式占用累积。在必要时重启环境若长时间运行后内存碎片化严重、即使空闲内存充足也持续报 EK0201可考虑重启应用或主机环境后重试。相关资源错误码完整定义与处置建议src/dfx/error_manager/error_code.json精简版运行时错误码表src/runtime_compact/c_base/src/error_manager.c错误码上报单元测试tests/ut/runtime/runtime_c/testcase/c_base/error_manager_test.cc同类别错误码说明docs/zh/error_code_ref/Profiling-Errors/Profiling-Errors.md相邻错误码参考EK0202 Resource_Error_Insufficient_Host_Memory同属 Host 内存不足但申请失败点不同Profiling 相关 API 文档docs/zh/api_ref/19_profiling_data_collection.md【免费下载链接】runtime本项目提供CANN运行时组件和维测功能组件。项目地址: https://gitcode.com/cann/runtime创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考