diff --git a/zh-cn/application-dev/dfx/hitracemeter-guidelines.md b/zh-cn/application-dev/dfx/hitracemeter-guidelines.md index aaefd0400b6070416d1371ad8e04606bea4d9d00..1c288b2bdc2d2835a3c0091dc53a122a0c1d5d47 100644 --- a/zh-cn/application-dev/dfx/hitracemeter-guidelines.md +++ b/zh-cn/application-dev/dfx/hitracemeter-guidelines.md @@ -2,7 +2,7 @@ ## 场景介绍 -HiTraceMeter为开发者提供系统性能打点接口。开发者通过在自己的业务逻辑中的关键代码位置调用HiTraceMeter提供的API接口,能够有效追踪进程轨迹、查看系统性能。 +HiTraceMeter为开发者提供系统性能打点接口。开发者通过在自己的业务逻辑中的关键代码位置调用HiTraceMeter提供的API接口,能够有效跟踪进程轨迹、查看系统性能。 ## 接口说明 @@ -12,15 +12,15 @@ HiTraceMeter为开发者提供系统性能打点接口。开发者通过在自 | 接口名 | 返回值 | 描述 | | ---------------------------------------------------------------------------- | --------- | ------------ | -| hiTraceMeter.startTrace(name: string, taskId: number, expectedTime?: number) | void | 标记一个预追踪耗时任务的开始。如果有多个相同name的任务需要追踪或者对同一个任务要追踪多次,并且任务同时被执行,则每次调用startTrace的taskId不相同。如果具有相同name的任务是串行执行的,则taskId可以相同。 | +| hiTraceMeter.startTrace(name: string, taskId: number, expectedTime?: number) | void | 标记一个预跟踪耗时任务的开始。如果有多个相同name的任务需要跟踪或者对同一个任务要跟踪多次,并且任务同时被执行,则每次调用startTrace的taskId不相同。如果具有相同name的任务是串行执行的,则taskId可以相同。 | | hiTraceMeter.finishTrace(name: string, taskId: number) | void | name和taskId必须与流程开始的hiTraceMeter.startTrace对应参数值保持一致。 | -| hiTraceMeter.traceByValue(name: string, value: number) | void | 用来标记一个预追踪的数值变量,该变量的数值会不断变化。| +| hiTraceMeter.traceByValue(name: string, value: number) | void | 用来标记一个预跟踪的数值变量,该变量的数值会不断变化。| ## 开发步骤 在应用启动执行页面加载后,开始分布式跟踪,完成业务之后,停止分布式跟踪。 -1. 新建一个JS应用工程,在“Project”窗口点击“entry > src > main > js > default > pages > index”,打开工程中的“index.js”文件,在页面执行加载后,在自己的业务中调用hiTraceMeter的接口,进行性能打点追踪,示例代码如下: +1. 新建一个JS应用工程,在“Project”窗口点击“entry > src > main > js > default > pages > index”,打开工程中的“index.js”文件,在页面执行加载后,在自己的业务中调用hiTraceMeter的接口,进行性能打点跟踪,示例代码如下: ```js import hiTraceMeter from '@ohos.hiTraceMeter' @@ -36,11 +36,11 @@ HiTraceMeter为开发者提供系统性能打点接口。开发者通过在自 hiTraceMeter.startTrace("business", 1); hiTraceMeter.startTrace("business", 1, 5); - // 追踪并行执行的同名任务 + // 跟踪并行执行的同名任务 hiTraceMeter.startTrace("business", 1); // 业务流程 console.log(`business running`); - hiTraceMeter.startTrace("business", 2); // 第二个追踪的任务开始,同时第一个追踪的同名任务还没结束,出现了并行执行,对应接口的taskId需要不同 + hiTraceMeter.startTrace("business", 2); // 第二个跟踪的任务开始,同时第一个跟踪的同名任务还没结束,出现了并行执行,对应接口的taskId需要不同 // 业务流程 console.log(`business running`); hiTraceMeter.finishTrace("business", 1); @@ -48,14 +48,14 @@ HiTraceMeter为开发者提供系统性能打点接口。开发者通过在自 console.log(`business running`); hiTraceMeter.finishTrace("business", 2); - // 追踪串行执行的同名任务 + // 跟踪串行执行的同名任务 hiTraceMeter.startTrace("business", 1); // 业务流程 console.log(`business running`); - hiTraceMeter.finishTrace("business", 1); // 第一个追踪的任务结束 + hiTraceMeter.finishTrace("business", 1); // 第一个跟踪的任务结束 // 业务流程 console.log(`business running`); - hiTraceMeter.startTrace("business", 1); // 第二个追踪的同名任务开始,同名的待追踪任务串行执行 + hiTraceMeter.startTrace("business", 1); // 第二个跟踪的同名任务开始,同名的待跟踪任务串行执行 // 业务流程 console.log(`business running`);