鸿蒙OpenHarmony【HiCollie开辟】子系统DFX

概述

HiCollie提供了软件看门狗功能。针对系统服务死锁、应用主线程阻塞，用户业务流程超时等故障，HiCollie提供了一套同一的用于故障检测和故障日记天生的框架，提供软件超时故障日记，辅助定位软件超时问题。
接口分析

表1 XCollieChecker接口
接口名称描述virtual void CheckBlock()接口功能：卡死检测回调函数。 输入参数：无。 输出参数：无。 返回值：无。virtual void CheckThreadBlock()接口功能：线程卡死检测回调函数。 输入参数：无。 输出参数：无。 返回值：无。 表2 XCollie接口
接口名称描述void RegisterXCollieChecker(const sptr &checker, unsigned int type)接口功能：线程卡死检测回调函数注册。 输入参数： - checker：XCollieChecker实例指针。 - type：卡死检测类型，取值设置为XCOLLIE_THREAD。 输出参数：无。 返回值：无。int SetTimer(const std::string &name, unsigned int timeout, std::function<void(void*)> func, void *arg, unsigned int flag)接口功能：添加定时器。 输入参数： - name：定时器名称。 - timeout：超时时间，单位为秒。 - func：超时回调函数。 - arg：超时回调函数参数指针。 - flag：定时器操作类型。 XCOLLIE_FLAG_DEFAULT：其他三个选项功能之和 XCOLLIE_FLAG_NOOP：仅调用超时回调函数 XCOLLIE_FLAG_LOG：天生超时故障日记 XCOLLIE_FLAG_RECOVERY：历程退出 输出参数：无。 返回值：成功返回定时器标识，失败返回 -1。bool UpdateTimer(int id, unsigned int timeout)接口功能：更新定时器。 输入参数： - id：定时器标识。 - timeout：超时时间，单位为秒。 输出参数：无。 返回值：成功返回true，失败返回false。void CancelTimer(int id)接口功能：取消定时器。 输入参数： - id：定时器标识。 输出参数：无。 返回值：无。 开辟实例

线程卡死监控开辟实例

线程卡死监控功能需要开辟者实现两个卡死检测回调函数，XCollieChecker类的CheckBlock和CheckThreadBlock接口函数。实现了该回调函数之后，开辟者还需要通过XCollie类的RegisterXCollieChecker函数，将该回调函数的类实例成功注册。卡死监控线程会定时执行全部已成功注册的回调函数，检查线程逻辑完成标志位，判定已经成功注册的线程逻辑是否被卡死。

• 源代码开辟 包罗头文件：
  
  1. #include "xcollie.h"

  复制代码
  在业务代码中利用：
  
  1. void MyXCollieChecker::CheckLock()
  2. {
  3.     /* time consuming job */
  4. }
  5.    
  6. void MyXCollieChecker::CheckThreadBlock()
  7. {
  8.     /* time consuming job */
  9. }
  10.    
  11. sptr<XCollieChecker> checker = new MyXCollieChecker("MyXCollieChecker");
  12. XCollie::GetInstance().RegisterXCollieChecker(checker,
  13.     (XCOLLIE_LOCK | XCOLLIE_THREAD));
  14. ......

  复制代码
• 编译设置，在BUILD.gn里增加子系统SDK依赖：
  
  1. external_deps = [ "hiviewdfx:libxcollie" ]

  复制代码

超时监控开辟实例

单个历程通过SetTimer接口函数添加定时器最多可以设置128个，超过上限则添加定时器操作会失败。

• 源代码开辟 包罗头文件：
  
  1. #include "xcollie.h"

  复制代码
  在业务代码中利用（添加/更新/取消）：
  
  1. std::function<void(void *)> callback = [](void *args)
  2. {
  3.     /* dump helpful information */
  4. };
  5.    
  6. int id = XCollie::GetInstance().SetTimer("MyXCollieTimer", 10, callback ,nullptr, XCOLLIE_FLAG_LOG);
  7. /* time consuming job */
  8. XCollie::GetInstance().UpdateTimer(id, 5);
  9. /* time consuming job */
  10. XCollie::GetInstance().CancelTimer(id);
  11. ......

  复制代码
• 编译设置，在BUILD.gn里增加子系统SDK依赖：
  
  1. external_deps = [ "hiviewdfx:libxcollie" ]

  复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。