CANN/ops-sparse日志规范

【免费下载链接】ops-sparse本项目是CANN提供的高性能稀疏矩阵计算的算子库，专注于优化稀疏矩阵的计算效率。项目地址: https://gitcode.com/cann/ops-sparse

name: sparse-log description: ops-sparse 日志集成规范，定义 dlog 日志使用方式、日志级别、格式要求。

ops-sparse 日志规范

日志框架

ops-sparse 使用dlog作为统一日志框架，对应头文件：

#include "log/log.h"

日志级别

日志格式

OP_LOGE("aclsparseXxx", "Error message: %s, code: %d", detail, code); OP_LOGD("aclsparseXxx", "Tiling data: rows=%u, cols=%u, blockDim=%u", rows, cols, blockDim); OP_LOGI("aclsparseXxx", "Kernel launched: blockIdx=%u, stream=%p", blockIdx, stream);

格式规范：

• 第一个参数为API 名或算子名（如"aclsparseSpMV"）
• 后续参数为格式化字符串 + 可变参数

Host 侧日志集成

强制规则

1. 必须包含#include "log/log.h"
2. 禁止使用printf、std::cout、LOG_PRINT（旧代码遗留，新代码禁止）
3. 参数校验失败 →OP_LOGE
4. ACL Runtime 调用失败 →OP_LOGE
5. Tiling 参数 →OP_LOGD
6. Kernel launch →OP_LOGI

示例

static aclsparseStatus_t ValidateSpMVParams(aclsparseHandle_t handle, ...) { if (handle == nullptr) { OP_LOGE("aclsparseSpMV", "handle is nullptr"); return ACL_SPARSE_STATUS_HANDLE_IS_NULLPTR; } // ... } static aclsparseStatus_t LaunchSpMVKernel(...) { OP_LOGD("aclsparseSpMV", "Tiling: rows=%u, cols=%u, blockDim=%u", tiling.totalRowsNum, tiling.totalColNum, blockDim); spmv_kernel_do(...); OP_LOGI("aclsparseSpMV", "Kernel launched, blockDim=%u", blockDim); return ACL_SPARSE_STATUS_SUCCESS; }

Kernel 侧日志

• Kernel 侧通常不使用 dlog（性能考虑）
• 如需调试输出，使用AscendC内置的PRINT宏（仅调试模式使用）
• 正式代码中必须移除所有 Kernel 侧调试输出

日志级别设置

通过环境变量控制（推荐）：

export ASCEND_GLOBAL_LOG_LEVEL=0 # 0=DEBUG, 1=INFO, 2=WARNING, 3=ERROR export ASCEND_SLOG_PRINT_TO_STDOUT=1 # 1=输出到 stdout

详见references/log-config.md（含CheckLogLevel条件调试用法）。

参考文档

【免费下载链接】ops-sparse本项目是CANN提供的高性能稀疏矩阵计算的算子库，专注于优化稀疏矩阵的计算效率。项目地址: https://gitcode.com/cann/ops-sparse