Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
61d80b93
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
61d80b93
编写于
8月 15, 2022
作者:
O
openharmony_ci
提交者:
Gitee
8月 15, 2022
浏览文件
操作
浏览文件
下载
差异文件
!8122 【轻量级 PR】:update zh-cn/application-dev/reference/apis/js-apis-bytrace.md.
Merge pull request !8122 from zengyawen/N/A
上级
2bb1c590
7fb137bb
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
39 addition
and
40 deletion
+39
-40
zh-cn/application-dev/reference/apis/js-apis-bytrace.md
zh-cn/application-dev/reference/apis/js-apis-bytrace.md
+39
-40
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-bytrace.md
浏览文件 @
61d80b93
# 性能打点
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
本模块提供了追踪进程轨迹。
> **说明:**
> - 从API Version 8开始,该接口不再维护,推荐使用新接口[`@ohos.hiTraceMeter`](js-apis-hitracemeter.md)。
> - 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
```
```
js
import
bytrace
from
'
@ohos.bytrace
'
;
```
## bytrace.startTrace
startTrace(name: string, taskId: number, expectedTime?: number): void
标记一个预追踪耗时任务的开始,expectedTime是可选参数,标识该任务的期望耗时。
标记一个时间片跟踪任务的开始。
> **说明:**
> 如果有多个相同name的任务需要追踪或者对同一个任务要追踪多次,并且这些跟踪任务会同时被执行,则每次调用startTrace的taskId必须不一致。如果具有相同name的跟踪任务是串行执行的,则taskId可以相同。在下面bytrace.finishTrace的示例中会举例说明。
**系统能力:**
SystemCapability.
Developtools.Byt
race
**系统能力:**
SystemCapability.
HiviewDFX.HiT
race
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 |
要追踪的
任务名称 |
| taskId | number | 是 | 任务id |
| expectedTime | number | 否 | 期望的耗时时间
,单位:ms
|
| name | string | 是 |
时间片跟踪
任务名称 |
| taskId | number | 是 |
时间片跟踪
任务id |
| expectedTime | number | 否 | 期望的耗时时间
(单位:ms)
|
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 如果有多个相同name的任务需要追踪或者对同一个任务要追踪多次,并且这些会同时被执行,则每次调用startTrace的taskId必须不一致。如果具有相同name的任务是串行执行的,则taskId可以相同。在下面bytrace.finishTrace的示例中会举例说明。
**示例:**
```
```
js
bytrace
.
startTrace
(
"
myTestFunc
"
,
1
);
bytrace.startTrace("myTestFunc", 1, 5); //
从startTrace到finishTrace流程的耗时期望
为5ms
bytrace
.
startTrace
(
"
myTestFunc
"
,
1
,
5
);
//
从startTrace到finishTrace流程的期望耗时
为5ms
```
## bytrace.finishTrace
finishTrace(name: string, taskId: number): void
标记一个预追踪耗时任务的结束。
标记一个时间片跟踪事件的结束。
> **说明:**<br>
> finishTrace的name和taskId必须与流程开始的startTrace对应参数值一致。
**系统能力:**
SystemCapability.
Developtools.Byt
race
**系统能力:**
SystemCapability.
HiviewDFX.HiT
race
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 |
要追踪的
任务名称 |
| taskId | number | 是 | 任务id |
| name | string | 是 |
时间片跟踪
任务名称 |
| taskId | number | 是 |
时间片跟踪
任务id |
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> finishTrace的name和taskId必须与流程开始的startTrace对应参数值一致。
**示例:**
```
```
js
bytrace
.
finishTrace
(
"
myTestFunc
"
,
1
);
```
```
//
追
踪并行执行的同名任务
//
跟
踪并行执行的同名任务
bytrace.startTrace("myTestFunc", 1);
//业务流程......
bytrace.startTrace("myTestFunc", 2); //
第二个追踪的任务开始,同时第一个追踪的同名任务还没结束,出现了并行执行,对应接口的taskId需要不同。
//业务流程......
//
业务流程......
bytrace.startTrace("myTestFunc", 2); //
第二个跟踪任务开始,同时第一个同名跟踪任务还没结束,出现了并行执行,对应接口的taskId需要不同
//
业务流程......
bytrace.finishTrace("myTestFunc", 1);
//业务流程......
//
业务流程......
bytrace.finishTrace("myTestFunc", 2);
```
```
//
追
踪串行执行的同名任务
//
跟
踪串行执行的同名任务
bytrace.startTrace("myTestFunc", 1);
//业务流程......
bytrace.finishTrace("myTestFunc", 1); //
第一个追踪的
任务结束
//业务流程......
bytrace.startTrace("myTestFunc", 1); //
第二个追踪的同名任务开始,同名的待追踪任务串行执行。
//业务流程......
//
业务流程......
bytrace.finishTrace("myTestFunc", 1); //
第一个跟踪
任务结束
//
业务流程......
bytrace.startTrace("myTestFunc", 1); //
第二个跟踪任务开始,同名跟踪任务串行执行
//
业务流程......
bytrace.finishTrace("myTestFunc", 1);
```
## bytrace.traceByValue
traceByValue(name: string, count: number): void
用来标记一个预追踪
的数值变量,该变量的数值会不断变化。
标记预追踪耗时任务
的数值变量,该变量的数值会不断变化。
**系统能力:**
SystemCapability.
Developtools.Byt
race
**系统能力:**
SystemCapability.
HiviewDFX.HiT
race
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 |
要追踪的数值变量
名称 |
| count | number | 是 | 变量的值 |
| name | string | 是 |
数值变量的
名称 |
| count | number | 是 |
数值
变量的值 |
**示例:**
```
```
js
let
traceCount
=
3
;
bytrace
.
traceByValue
(
"
myTestCount
"
,
traceCount
);
traceCount
=
4
;
bytrace
.
traceByValue
(
"
myTestCount
"
,
traceCount
);
//业务流程......
//
业务流程......
```
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录