diff --git a/zh-cn/device-dev/subsystems/subsys-dfx-hisysevent-logging.md b/zh-cn/device-dev/subsystems/subsys-dfx-hisysevent-logging.md index 64fb26a19fca91c38138d46c08726a909a7fddc2..7a846893cd99a3525b9bc0eb17573aa9bd41081e 100644 --- a/zh-cn/device-dev/subsystems/subsys-dfx-hisysevent-logging.md +++ b/zh-cn/device-dev/subsystems/subsys-dfx-hisysevent-logging.md @@ -19,66 +19,6 @@ HiSysEvent提供OpenHarmony打点接口,通过在关键路径打点记录系 ### 接口说明 -JAVA打点接口如下: - -HiSysEvent类,具体的API详见接口文档 。 - - **表1** HiSysEvent接口介绍 - -| 接口名 | 描述 | -| -------- | -------- | -| public static int write(String domain, String eventName, EventType type, Object... keyValues) | 接口功能:记录系统事件。
输入参数:
- domain:事件的相关领域,需要使用预置领域请参考Domain,可自定义领域。自定义领域长度在16个字符以内,有效的字符是0-9、A-Z,以字母开头。
- eventName:事件名,长度在32个字符以内,有效的字符是0-9、a-z、A-Z、_,以字母开头,不能以_结尾。
- type:事件类型,参考EventType。
- keyValues:事件参数键值对,支持基本的数据类型、std::string,以及std::vector<基本类型>、std:vector<std::string>。参数名长度在48个字符以内,有效的字符是0-9、a-z、A-Z、_,以字母开头,不能以_结尾。参数名的个数在32个以内。
返回值:成功返回0,错误返回小于0的值。 | -| public static int write(String domain, String eventName, EventType type, Map<String, Object> keyValues) | 接口功能:记录系统事件。
输入参数:
- domain:事件的相关领域,需要使用预置领域请参考Domain,可自定义领域。自定义领域长度在16个字符以内,有效的字符是0-9、A-Z,以字母开头。
- eventName:事件名,长度在32个字符以内,有效的字符是0-9、a-z、A-Z、_,以字母开头,不能以_结尾。
- type:事件类型,参考EventType。
- keyValues:事件参数键值对,支持基本的数据类型、std::string,以及std::vector<基本类型>、std:vector<std::string>。参数名长度在48个字符以内,有效的字符是0-9、a-z、A-Z、_,以字母开头,不能以_结尾。参数名的个数在32个以内。
返回值:成功返回0,错误返回小于0的值。 | - - **表2** HiSysEvent.Domain接口介绍 - -| 成员 | 描述 | -| -------- | -------- | -| public static final String AAFWK = "AAFWK" | 元能力子系统 | -| public static final String APPEXECFWK = "APPEXECFWK" | 用户程序框架子系统 | -| public static final String ACCOUNT = "ACCOUNT" | 账号子系统 | -| public static final String AI = "AI" | AI子系统 | -| public static final String BARRIER_FREE = "BARRIERFREE" | 无障碍软件服务子系统 | -| public static final String BIOMETRICS = "BIOMETRICS" | 生物特征识别服务子系统 | -| public static final String CCRUNTIME = "CCRUNTIME" | C/C++运行环境子系统 | -| public static final String COMMUNICATION = "COMMUNICATION" | 公共通信子系统 | -| public static final String DEVELOPTOOLS = "DEVELOPTOOLS" | 研发工具链子系统 | -| public static final String DISTRIBUTED_DATAMGR = "DISTDATAMGR" | 分布式数据管理子系统 | -| public static final String DISTRIBUTED_SCHEDULE = "DISTSCHEDULE" | 分布式任务调度子系统 | -| public static final String GLOBAL = "GLOBAL" | 全球化子系统 | -| public static final String GRAPHIC = "GRAPHIC" | 图形子系统 | -| public static final String HIVIEWDFX = "HIVIEWDFX" | DFX子系统 | -| public static final String IAWARE = "IAWARE" | 本地资源调度管控子系统 | -| public static final String INTELLI_ACCESSORIES = "INTELLIACC" | 智能配件业务子系统 | -| public static final String INTELLI_TV = "INTELLITV" | 智能电视业务子系统 | -| public static final String IVI_HARDWARE = "IVIHARDWARE" | 车机专有硬件服务子系统 | -| public static final String LOCATION = "LOCATION" | 位置服务子系统 | -| public static final String MSDP = "MSDP" | 综合传感处理平台子系统 | -| public static final String MULTI_MEDIA = "MULTIMEDIA" | 媒体子系统 | -| public static final String MULTI_MODAL_INPUT = "MULTIMODALINPUT" | 多模输入子系统 | -| public static final String NOTIFICATION = "NOTIFICATION" | 事件通知子系统 | -| public static final String POWERMGR = "POWERMGR" | 电源服务子系统 | -| public static final String ROUTER = "ROUTER" | 路由器业务子系统 | -| public static final String SECURITY = "SECURITY" | 安全子系统 | -| public static final String SENSORS = "SENSORS" | 泛Sensor服务子系统 | -| public static final String SOURCE_CODE_TRANSFORMER = "SRCTRANSFORMER" | 应用移植子系统 | -| public static final String STARTUP = "STARTUP" | 启动恢复子系统 | -| public static final String TELEPHONY = "TELEPHONY" | 电话服务子系统 | -| public static final String UPDATE = "UPDATE" | 升级服务子系统 | -| public static final String USB = "USB" | USB服务子系统 | -| public static final String WEARABLE_HARDWARE = "WEARABLEHW" | 穿戴专有硬件服务子系统 | -| public static final String WEARABLE = "WEARABLE" | 穿戴业务子系统 | -| public static final String OTHERS = "OTHERS" | 其它 | - - **表3** HiSysEvent.EventType接口介绍 - -| 接口名 | 描述 | -| -------- | -------- | -| FAULT | 故障类型事件 | -| STATISTIC | 统计类型事件 | -| SECURITY | 安全类型事件 | -| BEHAVIOR | 系统行为事件 | - C++打点接口如下: HiSysEvent类,具体的API详见接口文档 。 @@ -87,7 +27,7 @@ HiSysEvent类,具体的API详见接口文档 。 | 接口名 | 描述 | | -------- | -------- | -| template<typename... Types> static int Write(const std::string &domain, const std::string &eventName, EventType type, Types... keyValues) | 接口功能:记录系统事件。
输入参数:
- domain:事件的相关领域,需要使用预置领域请参考Domain,可自定义领域。自定义领域长度在16个字符以内,有效的字符是0-9、A-Z,以字母开头。
- eventName:事件名,长度在32个字符以内,有效的字符是0-9、A-Z、下划线,以字母开头,不能以下划线结尾。
- type:事件类型,参考EventType。
- keyValues:事件参数键值对,支持基本的数据类型、std::string,以及std::vector<基本类型>、std:vector<std::string>。参数名长度在48个字符以内,有效的字符是0-9、A-Z、下划线,以字母开头,不能以下划线结尾。参数名的个数在32个以内。
返回值:
- 0:系统事件记录成功。
- 负值:系统事件记录失败。 | +| template<typename... Types> static int Write(const std::string &domain,
 const std::string &eventName,
 EventType type, Types... keyValues) | 接口功能:记录系统事件。
输入参数:
- domain:事件的相关领域,需要使用预置领域请参考Domain,可自定义领域。自定义领域长度在16个字符以内,有效的字符是0-9、A-Z,以字母开头。
- eventName:事件名,长度在32个字符以内,有效的字符是0-9、A-Z、下划线,以字母开头,不能以下划线结尾。
- type:事件类型,参考EventType。
- keyValues:事件参数键值对,支持基本的数据类型、std::string,以及std::vector<基本类型>、std:vector<std::string>。参数名长度在48个字符以内,有效的字符是0-9、A-Z、下划线,以字母开头,不能以下划线结尾。参数名的个数在32个以内。
返回值:
- 0:系统事件记录成功。
- 负值:系统事件记录失败。 | **表5** HiSysEvent::Domain接口介绍 @@ -142,29 +82,6 @@ HiSysEvent类,具体的API详见接口文档 。 ### 开发实例 -Java接口实例 - -1. 源代码开发 - 引入类名: - - - ``` - import ohos.hiviewdfx.HiSysEvent; - ``` - - 假设业务关注应用启动时间start_app,在相关代码中使用(调用接口打点): - - - ``` - HiSysEvent.write(HiSysEvent.Domain.AAFWK, "start_app", HiSysEvent.EventType.FAULT, "app_name", "com.demo"); - ``` - -2. 编译设置,在BUILD.gn里增加子系统SDK依赖: - - ``` - external_deps = [ "hisysevent:hisysevent_java" ] - ``` - C++接口实例 1. 源代码开发