harmony 鸿蒙HiCollie开发指导

2022-08-09
浏览 (1329)

HiCollie开发指导

概述

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

接口说明

表1 XCollieChecker接口

接口名称	描述
virtual void CheckBlock()	接口功能：卡死检测回调函数。输入参数：无。输出参数：无。返回值：无。
virtual void CheckThreadBlock()	接口功能：线程卡死检测回调函数。输入参数：无。输出参数：无。返回值：无。

表2 XCollie接口

接口名称	描述
void RegisterXCollieChecker(const sptr<XCollieChecker> &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函数，将该回调函数的类实例成功注册。卡死监控线程会定时执行全部已成功注册的回调函数，检查线程逻辑完成标志位，判定已经成功注册的线程逻辑是否被卡死。

源代码开发包含头文件：

   #include "xcollie.h"

在业务代码中使用：

   void MyXCollieChecker::CheckLock()
   {
       /* time consuming job */
   }
       
   void MyXCollieChecker::CheckThreadBlock()
   {
       /* time consuming job */
   }
       
   sptr<XCollieChecker> checker = new MyXCollieChecker("MyXCollieChecker");
   XCollie::GetInstance().RegisterXCollieChecker(checker, 
       (XCOLLIE_LOCK|XCOLLIE_THREAD));
   ......

编译设置，在BUILD.gn里增加子系统SDK依赖：

   external_deps = [ "hiviewdfx:libxcollie" ]

超时监控开发实例

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

源代码开发包含头文件：

   #include "xcollie.h"

 在业务代码中使用（添加/更新/取消）：

   std::function<void(void *)> callback = [](void *args)
   {
       /* dump helpful information */
   };
       
   int id = XCollie::GetInstance().SetTimer("MyXCollieTimer", 10, callback ,nullptr, XCOLLIE_FLAG_LOG);
   /* time consuming job */
   XCollie::GetInstance().UpdateTimer(id, 5);
   /* time consuming job */
   XCollie::GetInstance().CancelTimer(id);
   ......

编译设置，在BUILD.gn里增加子系统SDK依赖：

   external_deps = [ "hiviewdfx:libxcollie" ]

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkCompiler开发指导

harmony 鸿蒙窗口标题栏定制开发指导

0 赞

所属分类： 后端技术
本文标签： 软件鸿蒙
版权声明： 原创文章如转载，请注明本文链接: https://www.seaxiang.com/blog/561d26f69b7b45c98dad167fdb86906c