性能打點

導(dǎo)入模塊

import hiTraceMeter from '@ohos.hiTraceMeter';

hiTraceMeter.startTrace

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

標(biāo)記一個預(yù)跟蹤耗時任務(wù)的開始。

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

如果具有相同name的任務(wù)是串行執(zhí)行的，則taskId可以相同。具體示例可參考hiTraceMeter.finishTrace中的示例。

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

參數(shù)：

示例：

hiTraceMeter.startTrace("myTestFunc", 1);

hiTraceMeter.finishTrace

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

標(biāo)記一個預(yù)跟蹤耗時任務(wù)的結(jié)束。

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

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

參數(shù)：

示例：

hiTraceMeter.finishTrace("myTestFunc", 1);

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

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

hiTraceMeter.traceByValue

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

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

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

參數(shù)：

示例：

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