---
title: 总体说明
description: "Trace模块提供推理服务化性能数据采集（C++）接口，用于Trace数据监控。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/devaids/Profiling/mindieprofiling_0058.html
sourcePath: /source/zh/canncommercial/900/devaids/Profiling/mindieprofiling_0058.html
indexId: e70730171cb44ccc9630b0523facfcb9f7cf6401dd5e50a014864ca35e86325973
---
# 总体说明

#### 接口简介

Trace模块提供推理服务化性能数据采集（C++）接口，用于Trace数据监控。

Trace接口功能介绍和使用示例请参见msServiceProfiler Trace数据监控。

头文件：${INSTALL_DIR}/include/msServiceProfiler/Tracer.h

库文件：${INSTALL_DIR}/lib64/libms_service_profiler.so

${INSTALL_DIR}请替换为CANN软件安装后文件存储路径。以root用户安装为例，安装后文件默认存储路径为：/usr/local/Ascend/cann。


#### 接口列表

具体接口如下：


**表1 Trace API（C++）**

| 接口 | 说明 |
| --- | --- |
| TraceContext类 | Trace上下文管理类，负责管理线程级别的Trace信息。 |
| GetTraceCtx | 获取当前线程的Trace上下文实例。 |
| addResAttribute | 添加资源属性（全局属性）。 |
| ExtractAndAttach | 解析HTTPTrace信息并附加到当前上下文。 |
| Attach | 附加Trace信息到当前上下文。 |
| Unattach | 解除指定索引的Trace上下文。 |
| GetCurrent | 获取当前Trace上下文信息。 |
| Span类 | 跨度类，表示一个具体的操作或请求。 |
| Span | 创建一个跨度。 |
| Activate | 激活跨度并开始计时。 |
| SetAttribute | 设置跨度属性。 |
| SetStatus | 设置跨度状态。 |
| End | 结束跨度。 |
| Tracer类 | 提供创建跨度的接口。 |
| StartSpanAsActive | 创建并激活一个跨度。 |
| IsEnable | 检查Trace功能是否启用。 |