CANNAscend人工智能任务调度【免费下载链接】runtime本项目提供CANN运行时组件和维测功能组件。项目地址https://gitcode.com/cann/runtime点击查看免费下载本篇文章以 CANN/runtime 仓库中 example/5_performance/log 目录下的 ACL 日志样例为骨架完整讲解对外 ACL 日志接口acllogRecord、acllogVaList、acllogCheckDebugLevel、acllogRegisterCallback、acllogUnregisterCallback的声明含义、日志级别与掩码机制、回调注册流程并结合 main.cpp 源码与 run.sh 构建脚本给出可直接复现的运行方案。读完本文你将掌握如何在自有模块中接入 CANN 的 ACL 日志通道将调试日志、运行日志定向输出并注册自定义回调对设备侧日志进行实时旁路。一、样例概览log 目录的定位与组成example/5_performance/log是 CANN Runtime 对外 ACL 日志接口的可运行样例目录。目录级 README.md 说明其职责是“提供对外 ACL 日志接口的可运行样例并通过目录级脚本输出统一的成功或失败结果”。整个目录包含以下内容0_acl_log覆盖acllogRecord、acllogVaList、acllogCheckDebugLevel、acllogRegisterCallback和acllogUnregisterCallback五个接口的核心用法CMakeLists.txt目录级 CMake 工程负责收集 CANN 安装路径并下发子目录构建run.sh目录级统一脚本完成环境解析、构建、运行与结果校验返回值为 0 表示全部步骤成功非 0 表示构建或运行失败0_acl_log/main.cpp样例主体程序演示调试日志、运行日志、va_list日志记录以及设备日志回调的注册与注销。该样例属于性能与可观测性performance/log示例家族核心价值在于用户模块无需关心日志平台内部实现仅通过公开头文件 acl_log.h 声明的 5 个接口即可把日志写入 CANN 日志体系同时可获取调试级别开关状态以做日志开销裁剪。二、对外 ACL 日志接口全景头文件声明逐项解读所有对外 ACL 日志接口均声明在 include/dfx/base/acl_log.h 中头文件通过LOG_FUNC_VISIBILITY宏定义于 include/dfx/base/log_types.h非 Windows 平台展开为__attribute__((visibility(default)))将符号导出为默认可见调用方仅需#include acl_log.h并链接libascendalog.so即可。2.1 回调句柄与输出类型typedef uintptr_t acllogCallbackHandle; typedef enum { OUTPUT_TYPE_DEBUG 0, OUTPUT_TYPE_RUN 1, OUTPUT_TYPE_BOTH 2, OUTPUT_TYPE_MAX } acllogOutputLogType;acllogCallbackHandle以uintptr_t表示回调句柄由注册接口回填注销时原样传回acllogOutputLogType决定回调接收哪类日志OUTPUT_TYPE_DEBUG仅调试日志、OUTPUT_TYPE_RUN仅运行日志、OUTPUT_TYPE_BOTH两类都接收。样例中注册回调时传入OUTPUT_TYPE_BOTH与日志接口按掩码区分调试/运行日志的机制对应。2.2 五个核心接口签名接口签名用途acllogRegisterCallbackint32_t (acllogRecordCallback callbackFunc, void* userData, uint32_t outputLogType, acllogCallbackHandle* callbackHandle)注册设备日志记录回调回调被触发时把日志内容转发给调用方acllogUnregisterCallbackint32_t (acllogCallbackHandle callback)按句柄注销已注册的回调acllogRecordvoid (int32_t moduleId, int32_t level, const char* fmt, ...)以格式化字符串方式记录日志声明带format(printf, 3, 4)属性编译期可校验格式串acllogVaListvoid (int32_t moduleId, int32_t level, const char* fmt, va_list list)以va_list方式记录日志适用于把日志接口二次封装进可变参数函数acllogCheckDebugLevelint32_t (int32_t moduleId, int32_t logLevel)查询指定模块在指定日志级别下调试日志是否开启供上层做日志开销裁剪回调函数类型定义如下typedef int32_t (*acllogRecordCallback)(void* userData, uint32_t outputLogType, const char* logContent, size_t length);回调返回int32_t状态码入参包括注册时传入的userData、日志类型outputLogType、日志内容指针logContent与内容长度length注意length为字节数且内容不保证以\0结尾样例中使用%.*s限定长度打印这是正确的处理姿势。从源码结构看acllogRecord、acllogVaList、acllogCheckDebugLevel三个记录/查询接口均带__attribute((weak))弱符号声明见 acl_log.h意味着它们属于“可选能力”即便链接的运行时版本未导出这些符号程序仍可正常链接仅需在运行期判空。样例 main.cpp 正是据此在调用前做了空指针检查。三、日志级别、掩码与模块 IDlog_types.h 中的基础概念五个接口的level、moduleId参数以及日志归类都建立在 include/dfx/base/log_types.h 定义的公共常量之上。理解这些常量是正确使用 ACL 日志接口的前提。3.1 日志级别#define DLOG_DEBUG 0x0 // debug level id #define DLOG_INFO 0x1 // info level id #define DLOG_WARN 0x2 // warning level id #define DLOG_ERROR 0x3 // error level id #define DLOG_NULL 0x4 // dont print log级别取值DLOG_DEBUG(0) ~DLOG_ERROR(3)DLOG_NULL(4) 表示不打印。样例中分别以DLOG_INFO记录调试日志与运行日志、以DLOG_WARN记录va_list日志并用acllogCheckDebugLevel(kUserModuleId, DLOG_INFO)查询该级别是否使能。3.2 日志掩码调试日志与运行日志的分类机制#define DEBUG_LOG_MASK (0x00010000U) // print log to directory debug #define SECURITY_LOG_MASK (0x00100000U) // print log to directory security #define RUN_LOG_MASK (0x01000000U) // print log to directory run #define STDOUT_LOG_MASK (0x10000000U) // print log to stdout调试日志写入 debug 目录与运行日志写入 run 目录并不是通过level区分的而是通过模块 ID 上叠加掩码。样例中acllogRecord(kUserModuleId, DLOG_INFO, user debug log: %d\n, 1); acllogRecord(kUserModuleId | RUN_LOG_MASK, DLOG_INFO, user run log: %d\n, 2);第一条使用裸kUserModuleId记录为调试日志第二条使用kUserModuleId | RUN_LOG_MASK叠加0x01000000U记录为运行日志。两条日志级别同为DLOG_INFO却因掩码不同而进入不同的日志归类通道。相应地注册回调时的OUTPUT_TYPE_DEBUG/OUTPUT_TYPE_RUN/OUTPUT_TYPE_BOTH正是对这一分类的消费端筛选。3.3 模块 ID从系统模块到用户应用log_types.h定义了完整的模块 ID 枚举SLOG0、RUNTIME7、HCCL3、GE45、ASCENDCL48 等直至INVALID_MODULE_ID77其中APP 33预留给用户应用。样例并未使用 33而是自定kUserModuleId 0xff00见 main.cpp以规避与任何系统模块冲突体现了“用户模块 ID 自行约定、避开系统枚举”的实践方式。此外还有MSG_LENGTH 1024表示单条日志最大长度DLOG_TYPE_DEBUG 0、DLOG_TYPE_RUN 1定义日志类型枚举供日志落盘目录与回调类型换算使用。四、样例源码逐段解析一条完整日志链路的实现0_acl_log/main.cpp 规模很小但流程完整包含回调定义、va_list封装、注册、记录、注销五个环节。4.1 自定义日志回调int32_t LogCallback(void*, uint32_t outputLogType, const char* logContent, size_t length) { std::printf([CALLBACK type%u] %.*s, outputLogType, static_castint(length), logContent); return 0; }回调把日志类型与内容按length精确截取打印到标准输出。这里outputLogType的取值即前文acllogOutputLogType枚举值可据此在回调内继续分流处理。4.2 va_list 二次封装void RecordWithVaList(int32_t moduleId, int32_t level, const char* format, ...) { va_list args; va_start(args, format); acllogVaList(moduleId, level, format, args); va_end(args); }这是acllogVaList的典型使用场景当你的业务代码需要对日志接口再做一层可变参数封装时用va_start/va_end捕获参数列表后直接转交acllogVaList避免重新解析格式化字符串。注意必须先va_start再调用且成对使用va_end。4.3 主流程注册 → 记录 → 注销int main() { acllogCallbackHandle callbackHandle 0; const int32_t registerResult acllogRegisterCallback(LogCallback, nullptr, OUTPUT_TYPE_BOTH, callbackHandle); if (registerResult ! 0) { std::printf([FAILURE] acllogRegisterCallback returned %d.\n, registerResult); return 1; } ... }主流程先以OUTPUT_TYPE_BOTH注册回调userData传nullptr回调中未使用注册失败立即以非 0 退出。随后在空指针保护下依次执行三条日志记录与一次级别查询最后注销回调const int32_t unregisterResult acllogUnregisterCallback(callbackHandle); if (unregisterResult ! 0) { ... return 1; } std::printf([SUCCESS] ACL log sample completed successfully.\n);注销使用注册时回填的callbackHandle。整个样例的运行期行为可归纳为注册回调输出类型为 BOTH→ 打印注册结果记录一条调试日志DLOG_INFO 裸模块 ID→ 触发回调类型为 DEBUG记录一条运行日志DLOG_INFORUN_LOG_MASK→ 触发回调类型为 RUN经RecordWithVaList以va_list记录一条DLOG_WARN日志查询acllogCheckDebugLevel返回的使能状态并打印注销回调 → 打印成功标记。需要留意的是第 2~5 步整体处于acllogRecord ! nullptr acllogVaList ! nullptr acllogCheckDebugLevel ! nullptr的保护之下。若链接的运行时未导出这三个弱符号程序会打印警告并仅验证回调注册/注销能力后正常结束这正是弱符号设计带来的向前兼容性。五、编译与运行从环境解析到结果校验5.1 运行前置条件样例面向已安装 CANN 软件包的环境0_acl_log/README.md 给出的运行方式为在 CANN 环境中执行上级目录的run.shsource ${install_root}/cann/set_env.sh cd ${git_clone_path}/example/5_performance/log bash run.sh其中${install_root}为 CANN 安装根目录${git_clone_path}为本仓库克隆路径。脚本会检查构建和样例输出失败时返回非 0 退出码。5.2 run.sh 的执行链路run.sh 采用set -euo pipefail严格模式执行链路如下定位脚本自身目录并source ../../common/resolve_cann_env.sh调用resolve_cann_env解析 CANN 安装路径详见 5.3清理旧build目录后执行cmake -B build -DASCEND_CANN_PACKAGE_PATH${ASCEND_INSTALL_PATH}配置工程执行cmake --build build -j$(nproc)并行构建运行./build/0_acl_log/acl_log_sample并将输出同时落盘到output_msg.txt用grep在输出中查找成功标记[SUCCESS] ACL log sample completed successfully.命中则打印成功并返回 0否则打印失败并返回 1。即目录级 README 中“脚本返回值为 0 表示全部步骤成功非 0 表示构建或运行失败详细输出保存在output_msg.txt”的约定其实现就是对样例输出文本的成功标记匹配。读者可自行把grep的成功标记替换为自定义标记以复用该骨架。5.3 CANN 环境自动解析example/common/resolve_cann_env.sh 是样例家族共享的环境解析脚本其候选路径按优先级依次为环境变量ASCEND_INSTALL_PATH、ASCEND_HOME_PATH、${HOME}/Ascend/cann、${HOME}/Ascend/ascend-toolkit/latest、/usr/local/Ascend/cann、/usr/local/Ascend/ascend-toolkit/latest、/opt/Ascend/cann。对每个候选路径脚本要求同时存在set_env.sh或bin/setenv.bash且具备 ACL 标准布局include/acl/acl.h与对应lib64/libacl_rt.so同时存在满足条件后导出ASCEND_INSTALL_PATH与ASCEND_HOME_PATH并source环境脚本。若全部路径均不可用脚本打印已检查路径列表并提示手动source cann_path/set_env.sh或export ASCEND_INSTALL_PATHcann_path。5.4 CMake 构建细节目录级 CMakeLists.txt 强制要求传入ASCEND_CANN_PACKAGE_PATH未设置时FATAL_ERROR终止。子工程 0_acl_log/CMakeLists.txt 揭示了本样例的依赖关系add_executable(acl_log_sample main.cpp) target_include_directories(acl_log_sample PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/../../../../include/dfx/base ${ASCEND_CANN_PACKAGE_PATH}/include/base) target_link_libraries(acl_log_sample PRIVATE ${ASCEND_CANN_PACKAGE_PATH}/lib64/libascendalog.so)头文件搜索路径覆盖仓库内 include/dfx/base提供acl_log.h、log_types.h与 CANN 安装包的include/base链接的库为 CANN 安装包lib64目录下的libascendalog.so即 ACL 日志功能库最终生成可执行文件acl_log_sample。这一依赖关系印证了接口分层对外头文件随仓库开源实现库由 CANN 软件包提供用户程序通过标准链接方式接入。六、使用建议与注意事项日志级别与掩码配合使用调试/运行日志的分类由模块 ID 叠加DEBUG_LOG_MASK/RUN_LOG_MASK决定与DLOG_*级别正交。想让同一条日志进 run 目录务必按样例写法叠加RUN_LOG_MASK0x01000000U。回调按长度消费日志内容logContent不保证\0结尾务必按回调传入的length处理样例的%.*s是安全范式。弱符号判空acllogRecord/acllogVaList/acllogCheckDebugLevel为弱符号调用前判空可保证旧版本运行时上的兼容降级。用户模块 ID 自定并避让系统枚举系统模块 ID 从SLOG(0) 枚举到INVALID_MODULE_ID(77)用户模块建议像样例一样选用高位自定义值如0xff00或使用保留给用户应用的APP(33)。日志级别查询用于开销裁剪在日志高频路径上先acllogCheckDebugLevel再决定是否拼装格式化参数可避免无谓的字符串格式化开销。运行失败排查run.sh全部输出保存在output_msg.txt若返回非 0先查看该文件确认是构建失败、样例运行失败还是成功标记未命中环境相关报错可参考resolve_cann_env.sh打印的“已检查路径列表”核对 CANN 安装位置与ASCEND_INSTALL_PATH。七、延伸阅读接口头文件include/dfx/base/acl_log.h、include/dfx/base/log_types.h样例源码example/5_performance/log/0_acl_log/main.cpp构建与运行脚本example/5_performance/log/run.sh、example/common/resolve_cann_env.sh日志相关更多文档docs/zh/log_ref含日志总览、级别设置、日志查看等以及环境变量 ASCEND_GLOBAL_LOG_LEVEL 与 ASCEND_MODULE_LOG_LEVEL 对日志级别控制的说明赞分享CANNAscend人工智能任务调度【免费下载链接】runtime本项目提供CANN运行时组件和维测功能组件。项目地址https://gitcode.com/cann/runtime点击查看免费下载相关推荐CANN Runtime ACL 日志接口实战使用 acl_log.h 记录日志与注册设备日志回调CANN Runtime ACL 日志接口实战使用 acl_log.h 记录日志与注册设备日志回调 CANNCompute Architecture forCANNAscend人工智能任务调度9大网盘直链下载助手告别龟速下载的智能解决方案9大网盘直链下载助手告别龟速下载的智能解决方案 还在为网盘下载速度慢、操作繁琐而烦恼吗LinkSwift网盘直链下载助手为您提供了一站式解决方案。这款基于JCANNAscend人工智能任务调度CANN Runtime ACL 日志接口实战在应用程序中使用 acl_log.h 记录与回调设备日志CANN Runtime ACL 日志接口实战在应用程序中使用 acl_log.h 记录与回调设备日志 本技术指南围绕 CANN/runtime 开源仓库中的CANNAscend人工智能任务调度上一篇如何评估Hermes-2-Pro-Mistral-7B-SFT性能7个关键指标与测试方法下一篇如何永久保存微信聊天记录WeChatMsg数据导出工具完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考