性能打點

本模塊提供了追蹤進程軌跡，度量程序執(zhí)行性能的打點能力。本模塊打點的數(shù)據(jù)供hiTraceMeter工具分析使用。

說明： 本模塊首批接口從API version 8開始支持。后續(xù)版本的新增接口，采用上角標單獨標記接口的起始版本。 開發(fā)前請熟悉鴻蒙開發(fā)指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

導入模塊

import hiTraceMeter from '@ohos.hiTraceMeter';

hiTraceMeter.startTrace

startTrace(name: string, taskId: number): void

標記一個預追蹤耗時任務的開始，expectedTime是可選參數(shù)，標識該任務的期望耗時。

如果有多個相同name的任務需要追蹤或者對同一個任務要追蹤多次，并且任務同時被執(zhí)行，則每次調(diào)用startTrace的taskId不相同。

如果具有相同name的任務是串行執(zhí)行的，則taskId可以相同。

系統(tǒng)能力： SystemCapability.HiviewDFX.HiTrace

參數(shù)：

示例：

hiTraceMeter.startTrace("myTestFunc", 1);

hiTraceMeter.finishTrace

finishTrace(name: string, taskId: number): void

標記一個預追蹤耗時任務的結束。

finishTrace的name和taskId必須與流程開始的[startTrace]對應參數(shù)值一致。

系統(tǒng)能力： SystemCapability.HiviewDFX.HiTrace

參數(shù)：

示例：

hiTraceMeter.finishTrace("myTestFunc", 1);

//追蹤并行執(zhí)行的同名任務
hiTraceMeter.startTrace("myTestFunc", 1);
//業(yè)務流程...... 
hiTraceMeter.startTrace("myTestFunc", 2);  //第二個追蹤的任務開始，同時第一個追蹤的同名任務還沒結束，出現(xiàn)了并行執(zhí)行，對應接口的taskId需要不同。
//業(yè)務流程...... 
hiTraceMeter.finishTrace("myTestFunc", 1);
//業(yè)務流程...... 
hiTraceMeter.finishTrace("myTestFunc", 2);

//追蹤串行執(zhí)行的同名任務
hiTraceMeter.startTrace("myTestFunc", 1);
//業(yè)務流程...... 
hiTraceMeter.finishTrace("myTestFunc", 1);  //第一個追蹤的任務結束
//業(yè)務流程...... 
hiTraceMeter.startTrace("myTestFunc", 1);   //第二個追蹤的同名任務開始，同名的待追蹤任務串行執(zhí)行。
//業(yè)務流程...... 
hiTraceMeter.finishTrace("myTestFunc", 1);

hiTraceMeter.traceByValue

traceByValue(name: string, count: number): void

用來標記一個預追蹤的數(shù)值變量，該變量的數(shù)值會不斷變化。

系統(tǒng)能力： SystemCapability.HiviewDFX.HiTrace

參數(shù)：

示例：

let traceCount = 3;
hiTraceMeter.traceByValue("myTestCount", traceCount);
traceCount = 4;
hiTraceMeter.traceByValue("myTestCount", traceCount);
//業(yè)務流程......

審核編輯 黃宇