开发者
下载

GeSessionGraphDebugJSONPrint

头文件/库文件

  • 头文件:#include <ge/ge_api.h>
  • 库文件:libge_runner.so

功能说明

维测场景下,图加载后,使用本接口将图中运行任务信息以JSON格式导出,包括Stream ID、Task ID、Task Type等信息。然后,通过tracing方式(例如chrome://tracing/)查看任务可视化信息。

如果不调用GeSessionGraphDebugJSONPrint接口,GeSessionLoadGraph时,设置如下环境变量,也会生成运行任务信息的JSON文件,方法如下:

export DUMP_GE_GRAPH=1

生成的JSON文件目录遵循如下规则,文件名为debug_graph_{graph_id}_{time}_{pid}_{seq}:

  • 若指定环境变量:NPU_COLLECT_PATH,生成的JSON文件在${NPU_COLLECT_PATH}/extra-info/目录。
  • 若指定环境变量:DUMP_GRAPH_PATH,生成的JSON文件在${DUMP_GRAPH_PATH}/目录。
  • 若没有指定环境变量,生成的JSON文件在当前脚本执行目录。

上述环境变量的详细说明请参见环境变量参考

函数原型

1
ge::Status GeSessionGraphDebugJSONPrint(ge::Session &session, uint32_t graph_id, uint32_t flags, ge::AscendString &json_result);

参数说明

参数名

输入/输出

说明

session

输入

加载图的Session实例。

graph_id

输入

要导出的图id。

flags

输入

预留,当前固定配置为0。

json_result

输出

JSON格式字符,图中任务信息。

返回值说明

参数名

类型

说明

-

Status

GE_RTI_MODEL_NOT_LOADED:图未加载。

SUCCESS:信息导出成功。

FAILED:信息导出失败。

约束说明

调用示例

1
2
3
4
5
ge::Session session;
uint32_t graph_id = 1; //假设graph已经加载
uint32_t flags = 0;
ge::AscendString json_result;
ge::Status ret = GeSessionGraphDebugJSONPrint(session, graphId, flags, json_result);