Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
Coping0606
Docs
提交
dfdad949
D
Docs
项目概览
Coping0606
/
Docs
与 Fork 源项目一致
Fork自
OpenHarmony / Docs
通知
1
Star
1
Fork
0
代码
文件
提交
分支
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,发现更多精彩内容 >>
未验证
提交
dfdad949
编写于
7月 08, 2022
作者:
O
openharmony_ci
提交者:
Gitee
7月 08, 2022
浏览文件
操作
浏览文件
下载
差异文件
!6513 【文档体验官】DFX页面版式及表达问题
Merge pull request !6513 from king_he/0707-a
上级
691052d6
12cb6a4b
变更
4
隐藏空白更改
内联
并排
Showing
4 changed file
with
37 addition
and
34 deletion
+37
-34
zh-cn/application-dev/dfx/hiappevent-guidelines.md
zh-cn/application-dev/dfx/hiappevent-guidelines.md
+14
-14
zh-cn/application-dev/dfx/hiappevent-overview.md
zh-cn/application-dev/dfx/hiappevent-overview.md
+6
-3
zh-cn/application-dev/dfx/hitracemeter-guidelines.md
zh-cn/application-dev/dfx/hitracemeter-guidelines.md
+15
-15
zh-cn/application-dev/dfx/hitracemeter-overview.md
zh-cn/application-dev/dfx/hitracemeter-overview.md
+2
-2
未找到文件。
zh-cn/application-dev/dfx/hiappevent-guidelines.md
浏览文件 @
dfdad949
...
@@ -2,24 +2,24 @@
...
@@ -2,24 +2,24 @@
## 场景介绍
## 场景介绍
应用事件打点的主要
工作是在应用运行过程中,
帮助应用记录在运行过程中发生的各种信息。
应用事件打点的主要
用于
帮助应用记录在运行过程中发生的各种信息。
## 接口说明
## 接口说明
应用事件JS打点接口由hiAppEvent模块提供。
应用事件JS打点接口由hiAppEvent模块提供。
以下仅提供简单的
接口介绍,API接口的具体使用说明(参数使用限制、具体取值范围等),请参考
[
应用事件打点API文档
](
../reference/apis/js-apis-hiappevent.md
)
。
以下仅提供简单的
API接口介绍,具体使用说明(参数使用限制、具体取值范围等),请参考
[
应用事件打点API参考
](
../reference/apis/js-apis-hiappevent.md
)
。
**
打点接口功能介绍:**
**
表1**
打点接口功能介绍
| 接口名 | 返回值 | 描述 |
| 接口名 | 返回值 | 描述 |
| ------------------------------------------------------------ | -------------- | ---------------------------------------------------- |
| ------------------------------------------------------------ | -------------- | ---------------------------------------------------- |
| write(string eventName, EventType type, object keyValues, AsyncCallback
\<
void> callback): void | void | 应用事件异步打点方法,使用callback方式作为异步回调。 |
| write(string eventName, EventType type, object keyValues, AsyncCallback
\<
void> callback): void | void | 应用事件异步打点方法,使用callback方式作为异步回调。 |
| write(string eventName, EventType type, object keyValues): Promise
\<
void> | Promise
\<
void> | 应用事件异步打点方法,使用
p
romise方式作为异步回调。 |
| write(string eventName, EventType type, object keyValues): Promise
\<
void> | Promise
\<
void> | 应用事件异步打点方法,使用
P
romise方式作为异步回调。 |
当采用callback作为异步回调时,可以在callback中进行下一步处理。当采用Promise对象返回时,可以在Promise对象中类似地处理接口返回值。具体结果码说明见
[
事件校验结果码
](
#事件校验结果码
)
。
当采用callback作为异步回调时,可以在callback中进行下一步处理。当采用Promise对象返回时,可以在Promise对象中类似地处理接口返回值。具体结果码说明见
[
事件校验结果码
](
#事件校验结果码
)
。
**
打点配置接口功能介绍:**
**
表2**
打点配置接口功能介绍
| 接口名 | 返回值 | 描述 |
| 接口名 | 返回值 | 描述 |
| ------------------------------ | ------- | ------------------------------------------------------------ |
| ------------------------------ | ------- | ------------------------------------------------------------ |
...
@@ -27,18 +27,18 @@
...
@@ -27,18 +27,18 @@
### 事件校验结果码
### 事件校验结果码
| 错误码 | 原因 | 校验规则 | 处理结果
|
| 错误码 | 原因 | 校验规则 | 处理结果 |
| ------ | --------------------------- | ------------------------------------------------------------ | -------------------------------------------
----------
|
| ------ | --------------------------- | ------------------------------------------------------------ | ------------------------------------------- |
| 0 | 无 | 事件校验成功 | 事件正常打点。 |
| 0 | 无 | 事件校验成功
。
| 事件正常打点。 |
| -1 | 无效的事件名称 | 非空且长度在48个字符以内(含)。
<br>
只由以下字符组成:0-9、a-z、_。
<br/>
非数字以及下划线开头。 | 忽略该事件,不执行打点。 |
| -1 | 无效的事件名称 | 非空且长度在48个字符以内(含)。
<br>
只由以下字符组成:0-9、a-z、_。
<br/>
非数字以及下划线开头。 | 忽略该事件,不执行打点。 |
| -2 | 无效的事件基本参数类型 | 事件名称参数必须为string。
<br/>
事件类型参数必须为number类型。
<br/>
keyValues参数必须为object类型。 | 忽略该事件,不执行打点。 |
| -2 | 无效的事件基本参数类型 | 事件名称参数必须为string。
<br/>
事件类型参数必须为number类型。
<br/>
keyValues参数必须为object类型。 | 忽略该事件,不执行打点。 |
| -99 | 应用打点功能被关闭 | 应用打点功能被关闭。 | 忽略该事件,不执行打点。 |
| -99 | 应用打点功能被关闭 | 应用打点功能被关闭。 | 忽略该事件,不执行打点。 |
| -100 | 未知错误 | 无。 | 忽略该事件,不执行打点。 |
| -100 | 未知错误 | 无。 | 忽略该事件,不执行打点。 |
| 1 | 无效的key参数名称 | 非空且长度在16个字符以内(含)。
<br/>
只由以下字符组成:0-9、a-z、_。
<br/>
非数字以及下划线开头。
<br/>
非下划线结尾。 | 忽略该键值对参数后,继续执行打点。
|
| 1 | 无效的key参数名称 | 非空且长度在16个字符以内(含)。
<br/>
只由以下字符组成:0-9、a-z、_。
<br/>
非数字以及下划线开头。
<br/>
非下划线结尾。 | 忽略该键值对参数后,继续执行打点。 |
| 2 | 无效的key参数类型 | Key参数必须为字符串类型。 | 忽略该键值对参数后,继续执行打点。
|
| 2 | 无效的key参数类型 | Key参数必须为字符串类型。 | 忽略该键值对参数后,继续执行打点。 |
| 3 | 无效的value参数类型 | value参数只支持以下类型:
<br/>
boolean、number、string、Array[基本类型]。
<br/>
| 忽略该键值对参数后,继续执行打点。
|
| 3 | 无效的value参数类型 | value参数只支持以下类型:
<br/>
boolean、number、string、Array[基本类型]。
| 忽略该键值对参数后,继续执行打点。
|
| 4 | value参数值过长 | 参数值长度必须在8
*
1024个字符以内(含)。 | 忽略该键值对参数后,继续执行打点。
|
| 4 | value参数值过长 | 参数值长度必须在8
*
1024个字符以内(含)。 | 忽略该键值对参数后,继续执行打点。 |
| 5 | key-value参数对数过多 | key-value参数对数必须在32对以内(含)。 | 忽略后面多余的键值对参数后,继续执行打点。
|
| 5 | key-value参数对数过多 | key-value参数对数必须在32对以内(含)。 | 忽略后面多余的键值对参数后,继续执行打点。 |
| 6 | List类型的value参数容量过大 | List类型的value参数容量必须在100个以内(含)。 | 对List进行截断(只保留前100个元素)后,继续执行打点。 |
| 6 | List类型的value参数容量过大 | List类型的value参数容量必须在100个以内(含)。 | 对List进行截断(只保留前100个元素)后,继续执行打点。 |
| 7 | 无效的List类型value参数 | List的泛型类型只能为基本类型。
<br/>
List内的参数必须为同一类型。 | 忽略该键值对参数后,继续执行打点。 |
| 7 | 无效的List类型value参数 | List的泛型类型只能为基本类型。
<br/>
List内的参数必须为同一类型。 | 忽略该键值对参数后,继续执行打点。 |
...
@@ -88,7 +88,7 @@
...
@@ -88,7 +88,7 @@
}
}
```
```
2.
运行项目,点击应用界面上的运行按钮
。
2.
点击应用界面上的运行按钮运行项目
。
## 相关实例
## 相关实例
...
...
zh-cn/application-dev/dfx/hiappevent-overview.md
浏览文件 @
dfdad949
# 应用事件打点概述
# 应用事件打点概述
HiAppEvent提供了应用事件打点接口,为应用提供事件打点的功能,用于帮助应用记录在运行过程中发生的故障信息、统计信息、安全信息、用户行为信息,以支撑开发者分析应用的运行情况。
HiAppEvent为应用提供事件打点的功能,通过提供应用事件打点接口帮助应用记录在运行过程中发生的故障信息、统计信息、安全信息、用户行为信息,以支撑开发者分析应用的运行情况。
HiAppEvent模块支持应用事件业务的开发,提供应用事件相关的功能,主要包括应用事件落盘、查询历史应用事件数据等功能。
## 基本概念
## 基本概念
HiAppEvent模块支持应用事件业务的开发,提供应用事件相关的功能,主要包括应用事件落盘、查询历史应用事件数据等功能。
**打点**
:记录由用户操作引起的变化,提供业务数据信息,以供开发、产品、运维分析。
-
**打点**
:
\ No newline at end of file
记录由用户操作引起的变化,提供业务数据信息,以供产品开发、优化、运维分析。
\ No newline at end of file
zh-cn/application-dev/dfx/hitracemeter-guidelines.md
浏览文件 @
dfdad949
...
@@ -2,13 +2,13 @@
...
@@ -2,13 +2,13 @@
## 场景介绍
## 场景介绍
HiTraceMeter为开发者提供系统性能打点接口。开发者通过在自己的业务逻辑中的关键代码位置调用HiTraceMeter
接口
提供的API接口,能够有效追踪进程轨迹、查看系统性能。
HiTraceMeter为开发者提供系统性能打点接口。开发者通过在自己的业务逻辑中的关键代码位置调用HiTraceMeter提供的API接口,能够有效追踪进程轨迹、查看系统性能。
## 接口说明
## 接口说明
性能打点跟踪接口由hiTraceMeter模块提供,详细API请参考
[
性能打点跟踪API参考
](
../reference/apis/js-apis-hitracemeter.md
)
。
性能打点跟踪接口由hiTraceMeter模块提供,详细API请参考
[
性能打点跟踪API参考
](
../reference/apis/js-apis-hitracemeter.md
)
。
**
性能打点跟踪接口功能介绍:**
**
表1**
性能打点跟踪接口功能介绍
| 接口名 | 返回值 | 描述 |
| 接口名 | 返回值 | 描述 |
| ---------------------------------------------------------------------------- | --------- | ------------ |
| ---------------------------------------------------------------------------- | --------- | ------------ |
...
@@ -32,31 +32,31 @@ HiTraceMeter为开发者提供系统性能打点接口。开发者通过在自
...
@@ -32,31 +32,31 @@ HiTraceMeter为开发者提供系统性能打点接口。开发者通过在自
onInit
()
{
onInit
()
{
this
.
title
=
this
.
$t
(
'
strings.world
'
);
this
.
title
=
this
.
$t
(
'
strings.world
'
);
//从startTrace到finishTrace流程的耗时期望为5ms
//
从startTrace到finishTrace流程的耗时期望为5ms
hiTraceMeter
.
startTrace
(
"
business
"
,
1
);
hiTraceMeter
.
startTrace
(
"
business
"
,
1
);
hiTraceMeter
.
startTrace
(
"
business
"
,
1
,
5
);
hiTraceMeter
.
startTrace
(
"
business
"
,
1
,
5
);
//追踪并行执行的同名任务
//
追踪并行执行的同名任务
hiTraceMeter
.
startTrace
(
"
business
"
,
1
);
hiTraceMeter
.
startTrace
(
"
business
"
,
1
);
//业务流程
//
业务流程
console
.
log
(
`business running`
);
console
.
log
(
`business running`
);
hiTraceMeter
.
startTrace
(
"
business
"
,
2
);
//
第二个追踪的任务开始,同时第一个追踪的同名任务还没结束,出现了并行执行,对应接口的taskId需要不同。
hiTraceMeter
.
startTrace
(
"
business
"
,
2
);
//
第二个追踪的任务开始,同时第一个追踪的同名任务还没结束,出现了并行执行,对应接口的taskId需要不同
//业务流程
//
业务流程
console
.
log
(
`business running`
);
console
.
log
(
`business running`
);
hiTraceMeter
.
finishTrace
(
"
business
"
,
1
);
hiTraceMeter
.
finishTrace
(
"
business
"
,
1
);
//业务流程
//
业务流程
console
.
log
(
`business running`
);
console
.
log
(
`business running`
);
hiTraceMeter
.
finishTrace
(
"
business
"
,
2
);
hiTraceMeter
.
finishTrace
(
"
business
"
,
2
);
//追踪串行执行的同名任务
//
追踪串行执行的同名任务
hiTraceMeter
.
startTrace
(
"
business
"
,
1
);
hiTraceMeter
.
startTrace
(
"
business
"
,
1
);
//业务流程
//
业务流程
console
.
log
(
`business running`
);
console
.
log
(
`business running`
);
hiTraceMeter
.
finishTrace
(
"
business
"
,
1
);
//第一个追踪的任务结束
hiTraceMeter
.
finishTrace
(
"
business
"
,
1
);
//
第一个追踪的任务结束
//业务流程
//
业务流程
console
.
log
(
`business running`
);
console
.
log
(
`business running`
);
hiTraceMeter
.
startTrace
(
"
business
"
,
1
);
//
第二个追踪的同名任务开始,同名的待追踪任务串行执行。
hiTraceMeter
.
startTrace
(
"
business
"
,
1
);
//
第二个追踪的同名任务开始,同名的待追踪任务串行执行
//业务流程
//
业务流程
console
.
log
(
`business running`
);
console
.
log
(
`business running`
);
let
traceCount
=
3
;
let
traceCount
=
3
;
...
@@ -68,6 +68,6 @@ HiTraceMeter为开发者提供系统性能打点接口。开发者通过在自
...
@@ -68,6 +68,6 @@ HiTraceMeter为开发者提供系统性能打点接口。开发者通过在自
}
}
```
```
2.
运行项目,点击应用界面上的运行按钮
,即可通过日志信息分析实际业务。
2.
点击应用界面上的运行按钮运行项目
,即可通过日志信息分析实际业务。
zh-cn/application-dev/dfx/hitracemeter-overview.md
浏览文件 @
dfdad949
# 性能打点跟踪概述
# 性能打点跟踪概述
hiTraceMeter是
开发者
用于追踪进程轨迹,度量程序执行性能的一种工具,基于内核的ftrace机制,提供给用户态应用代码执行时长度量打点的能力。开发者通过使用hiTraceMeter API在程序中打点,并使用hiTraceMeter提供的命令行工具采集跟踪数据。
hiTraceMeter是用于追踪进程轨迹,度量程序执行性能的一种工具,基于内核的ftrace机制,提供给用户态应用代码执行时长度量打点的能力。开发者通过使用hiTraceMeter API在程序中打点,并使用hiTraceMeter提供的命令行工具采集跟踪数据。
## 基本概念
## 基本概念
...
@@ -15,4 +15,4 @@ hiTraceMeter是开发者用于追踪进程轨迹,度量程序执行性能的
...
@@ -15,4 +15,4 @@ hiTraceMeter是开发者用于追踪进程轨迹,度量程序执行性能的
## 约束与限制
## 约束与限制
-
由于JS程序的异步IO特性,现在hiTraceMeter只提供了异步接口。
由于JS程序的异步IO特性,现在hiTraceMeter只提供了异步接口。
\ No newline at end of file
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录