應(yīng)用打點

本模塊提供了應(yīng)用事件打點能力，包括對打點數(shù)據(jù)的落盤，以及對打點功能的管理配置。

說明： 本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口，采用上角標單獨標記接口的起始版本。 開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

導(dǎo)入模塊

import hiAppEvent from '@ohos.hiAppEvent';

hiAppEvent.write

write(eventName: string, eventType: EventType, keyValues: object, callback: AsyncCallback): void

應(yīng)用事件打點方法，將事件寫入到當天的事件文件中，可接收類型為Json對象的事件參數(shù)，使用callback方式作為異步回調(diào)。

系統(tǒng)能力： SystemCapability.HiviewDFX.HiAppEvent

參數(shù)：

示例：

hiAppEvent.write("test_event", hiAppEvent.EventType.FAULT, {"int_data":100, "str_data":"strValue"}, (err, value) = > {
    if (err) {
        // 事件寫入異常：事件存在異常參數(shù)時忽略異常參數(shù)后繼續(xù)寫入，或者事件校驗失敗時不執(zhí)行寫入
        console.error(`failed to write event because ${err.code}`);
        return;
    }

    // 事件寫入正常
    console.log(`success to write event: ${value}`);
});

hiAppEvent.write

write(eventName: string, eventType: EventType, keyValues: object): Promise

應(yīng)用事件打點方法，將事件寫入到當天的事件文件中，可接收類型為Json對象的事件參數(shù)，使用promise方式作為異步回調(diào)。

系統(tǒng)能力： SystemCapability.HiviewDFX.HiAppEvent

參數(shù)：

返回值：

示例：

hiAppEvent.write("test_event", hiAppEvent.EventType.FAULT, {"int_data":100, "str_data":"strValue"})
    .then((value) = > {
        // 事件寫入正常
        console.log(`success to write event: ${value}`);
    }).catch((err) = > {
        // 事件寫入異常：事件存在異常參數(shù)時忽略異常參數(shù)后繼續(xù)寫入，或者事件校驗失敗時不執(zhí)行寫入
        console.error(`failed to write event because ${err.code}`);
    });

hiAppEvent.configure

configure(config: ConfigOption): boolean

應(yīng)用事件打點配置方法，可用于配置打點開關(guān)、文件目錄存儲限額大小等功能。

系統(tǒng)能力： SystemCapability.HiviewDFX.HiAppEvent

參數(shù)：

返回值：

示例：

// 配置應(yīng)用事件打點功能開關(guān)
hiAppEvent.configure({
    disable: true
});

// 配置事件文件目錄存儲限額大小
hiAppEvent.configure({
    maxStorage: '100M'
});

ConfigOption

此接口提供了應(yīng)用打點的配置選項。

系統(tǒng)能力： 以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.HiviewDFX.HiAppEvent。

EventType

事件類型枚舉。

系統(tǒng)能力： 以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.HiviewDFX.HiAppEvent。

Event

此接口提供了所有預(yù)定義事件的事件名稱常量。

系統(tǒng)能力： 以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.HiviewDFX.HiAppEvent。

Param

此接口提供了所有預(yù)定義參數(shù)的參數(shù)名稱常量。

系統(tǒng)能力： 以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.HiviewDFX.HiAppEvent。