鸿蒙OpenHarmony【HiSysEvent打点】子系统DFX

最新推荐文章于 2025-08-09 22:03:22 发布

原创

最新推荐文章于 2025-08-09 22:03:22 发布 · 649 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#harmonyos #华为 #鸿蒙 #鸿蒙系统 #嵌入式硬件

概述

功能简介

HiSysEvent打点提供了事件打点功能，开发者可以通过在关键路径打点来记录系统在运行过程中的重要信息。同时，HiSysEvent打点也提供了以事件领域为单位的HiSysEvent打点屏蔽机制，方便开发者评估及调试HiSysEvent打点操作的影响。

运作机制

在进行HiSysEvent事件打点之前，需要先完成HiSysEvent打点配置

开发指导

场景介绍

事件打点的主要工作是将打点数据进行落盘。

接口说明

C++接口说明

C++事件打点开发能力如下：HiSysEvent类，具体API详见接口目录（/base/hiviewdfx/hisysevent/interfaces/native/innerkits/hisysevent/include/）。

说明：

从OpenHarmony-3.2-Beta3版本开始，为避免打点风暴事件引发性能问题，对HiSysEvent打点进行了管控。表1中的HiSysEvent::Write打点接口被表2中的HiSysEventWrite宏接口取代。HiSysEvent::Write接口已废弃，请使用HiSysEventWrite宏接口完成HiSysEvent事件打点。

表1 事件打点接口（已废弃）

接口名	描述
template<typename… Types> static int Write(const std::string &domain, const std::string &eventName, EventType type, Types… keyValues)	将打点事件数据进行落盘。

表2 事件打点宏接口

接口名	描述
HiSysEventWrite(domain, eventName, type, …)	将打点事件数据进行落盘。

表3 EventType事件类型枚举

事件类型	描述
FAULT	故障类型事件。
STATISTIC	统计类型事件。
SECURITY	安全类型事件。
BEHAVIOR	行为类型事件。

C接口说明

C事件打点开发能力如下：具体API详见接口目录（/base/hiviewdfx/hisysevent/interfaces/native/innerkits/hisysevent/include/）。

表4 事件打点接口

接口名	描述
int OH_HiSysEvent_Write(const char* domain, const char* name, HiSysEventEventType type, HiSysEventParam params[], size_t size);	将打点事件数据进行落盘。

表5 HiSysEventEventType事件类型枚举

事件类型	描述
HISYSEVENT_FAULT	故障类型事件。
HISYSEVENT_STATISTIC	统计类型事件。
HISYSEVENT_SECURITY	安全类型事件。
HISYSEVENT_BEHAVIOR	行为类型事件。