【摘要】為確保各類應(yīng)用程序能夠在鴻蒙操作系統(tǒng)上實(shí)現(xiàn)無縫對(duì)接并高效利用 LTS，LTS SDK 進(jìn)行了 HarmonyOS 原生適配，可以提升鴻蒙生態(tài)下應(yīng)用的穩(wěn)定性和可靠性。

鴻蒙背景介紹

華為鴻蒙 HarmonyOS 系統(tǒng)是面向萬物互聯(lián)的全場(chǎng)景分布式操作系統(tǒng)，支持手機(jī)、平板、智能穿戴、智慧屏等多種終端設(shè)備運(yùn)行，提供應(yīng)用開發(fā)、設(shè)備開發(fā)的一站式服務(wù)的平臺(tái)。2024年1月18日正式推出HarmonyOS NEXT鴻蒙星河開發(fā)者預(yù)覽，也被稱為“純血”鴻蒙。為了確保這種復(fù)雜系統(tǒng)的穩(wěn)定性和高效運(yùn)行，日志采集成為了開發(fā)和維護(hù)過程中的關(guān)鍵環(huán)節(jié)。

華為云云日志服務(wù)介紹

云日志服務(wù)（Log Tank Service，簡(jiǎn)稱 LTS）用于收集來自主機(jī)和云服務(wù)的日志數(shù)據(jù)，通過海量日志數(shù)據(jù)的分析與處理，可以將云服務(wù)和應(yīng)用程序的可用性和性能最大化，為您提供實(shí)時(shí)、高效、安全的日志處理能力，幫助您快速高效地進(jìn)行實(shí)時(shí)決策分析、設(shè)備運(yùn)維管理、用戶業(yè)務(wù)趨勢(shì)分析等。

華為云云云日志業(yè)務(wù)全景圖

為確保各類應(yīng)用程序能夠在鴻蒙操作系統(tǒng)上實(shí)現(xiàn)無縫對(duì)接并高效利用 LTS，LTS SDK 進(jìn)行了 HarmonyOS原生適配，可以提升鴻蒙生態(tài)下應(yīng)用的穩(wěn)定性和可靠性。

LTS Harmony SDK 介紹

LTS Harmony SDK 基于華為終端日志底座進(jìn)行擴(kuò)展，底層適配鴻蒙 NDK，核心部分使用 ArkTS 語言編寫，對(duì)性能進(jìn)行了大量?jī)?yōu)化（包括緩存上報(bào)、文件存儲(chǔ)、上報(bào)策略等），能夠適用于移動(dòng)端、服務(wù)端等各種場(chǎng)景，LTS Harmony SDK提供 ArkTS語言原生調(diào)用 API，已通過 OpenHarmony 三方庫中心托管發(fā)布，當(dāng)前支持 HarmonyOS NEXT API 12及以上，僅支持 Stage 模式。

SDK 使用最佳實(shí)踐

使用前提

使用云日志前，您需要注冊(cè)華為賬號(hào)，并開通云日志服務(wù)。

確認(rèn)云日志服務(wù)的區(qū)域，請(qǐng)用戶根據(jù)所在的區(qū)域，選擇 region。

獲取華為賬號(hào) AK/SK。

獲取華為云賬號(hào)的項(xiàng)目 ID（project ID），步驟參考：請(qǐng)參見“我的憑證>API 憑證”。

獲取需要上報(bào)到 LTS 的日志組 ID 和日志流 ID。

集成接入 SDK

鴻蒙倉庫集成

在終端中運(yùn)行安裝命令。

ohpm install lts_harmony_sdk

在 app/oh-package.json5 中添加依賴。

dependencies { ... "lts_harmony_sdk": "0.0.1" ...}在終端中運(yùn)行以下命令安裝 SDKohpm install

手動(dòng)集成

下載[日志 SDK 包]。

下載后解壓到指定目錄。注：直接解壓即可，不需要額外操作。

將解壓后的 har 靜態(tài)庫文件添加到您的項(xiàng)目工程中。

在 app/oh-package.json5 中添加依賴。

dependencies { ... "lts_harmony_sdk": "file:../plugin/LTS_SDK/default/lts_harmony_sdk.har" // HAR 包存放地址 ...}

在終端中運(yùn)行以下命令使能 SDK。

ohpm install

注意事項(xiàng)：SDK 包使用語言為 ArkTS，只能在 ArkTS 文件中引入。僅支持 SDK11 以上版本。

引入依賴模塊

import { LTSSDK, ConfigParam } from 'lts_harmony_sdk';

初始化

初始化代碼示例：

// ArkTS 代碼示例// LTS 參數(shù)配置 const config:ConfigParam = { //必填參數(shù) region: string, //上報(bào) region projectId: string, //華為云項(xiàng)目 ID groupId: string, // LTS 日志組 ID streamId: string, // LTS 日志流 ID //選填參數(shù) url: string, //上報(bào)地址 cacheThreshold: number, //上報(bào)條數(shù)閾值 timeInterval: number, //上報(bào)時(shí)間閾值 isReportBackground: boolean //是否開啟后臺(tái)上報(bào)};//獲取 ApplicationContextlet applicationContext = this.context.getApplicationContext();// LTS 初始化方法 const ltssdk = new LTSSDK( applicationContext , config)

配置參數(shù)說明

日志上報(bào)

Report(content, labels)

說明：采集日志，緩存到本地，當(dāng)緩存條數(shù)達(dá)到閾值時(shí)，自動(dòng)上報(bào)。content 參數(shù)：日志內(nèi)容，支持 Map 和 Map 數(shù)組；鍵值對(duì)最多 500 個(gè)；content 轉(zhuǎn) JSON 字符串最大支持長(zhǎng)度為 1024*30，超出則被截?cái)鄟G棄。

labels 參數(shù)：日志標(biāo)簽，非必填，value 支持 String、Number 類型；key 最大長(zhǎng)度為 64，支持字母、數(shù)字和下劃線組合，首字符須是字母；如果 value 是 String 類型，最大長(zhǎng)度為 256。鍵值對(duì)最多 50 個(gè)。

代碼示例：

const ltssdk = new LTSSDK(applicationContext, config)let fruit = { "fruit_1": "apple", "fruit_2": "pear", "fruit_3": "banana"};let food = { "food_1": "rice" };let labels = { "date": "2023-10-01"};let contents = [food, fruit];ltssdk.report(food); //緩存上報(bào)單條不帶標(biāo)簽 ltssdk.report(food, labels); //緩存上報(bào)單條帶標(biāo)簽 ltssdk.report(contents); //緩存上報(bào)多條不帶標(biāo)簽 ltssdk.report(contents, labels); //緩存上報(bào)多條帶標(biāo)簽

ReportImmediately(content, labels)

說明：采集日志，立即上報(bào)。content 參數(shù)：日志內(nèi)容，支持 Map 和 Map 數(shù)組；鍵值對(duì)最多 500 個(gè)；Content 轉(zhuǎn) JSON 字符串最大支持長(zhǎng)度為 1024*30，超出則被截?cái)鄟G棄。

labels 參數(shù)：日志標(biāo)簽，非必填，value 支持 String、Number、Map；key 最大長(zhǎng)度為 64，支持字母、數(shù)字和下劃線組合，首字符須是字母；如果 value 是 String 類型，最大長(zhǎng)度為 256。鍵值對(duì)最多 50 個(gè)。

代碼示例：

const ltssdk = new LTSSDK(applicationContext , config)let fruit = { "fruit_1": "apple", "fruit_2": "pear", "fruit_3": "banana"};let food = { "food_1": "rice" };let labels = { "date":"2023-10-01"};let contents = [food, fruit];ltssdk.reportImmediately(food); //立即上報(bào)單條不帶標(biāo)簽 ltssdk.reportImmediately(food, labels); //立即上報(bào)單條帶標(biāo)簽 ltssdk.reportImmediately(contents); //立即上報(bào)多條不帶標(biāo)簽 ltssdk.reportImmediately(contents, labels); //立即上報(bào)多條帶標(biāo)簽

日志使用場(chǎng)景

應(yīng)用場(chǎng)景 1：應(yīng)用運(yùn)維

企業(yè)在日常業(yè)務(wù)運(yùn)維、審計(jì)或等保時(shí)，需要收集各種類型的日志，常遇到如下痛點(diǎn)：

企業(yè)部門多且日志繁雜，日志量大。

云服務(wù)資源種類數(shù)量多，不熟悉監(jiān)控指標(biāo)和運(yùn)維日志，運(yùn)維難度大。

安全合規(guī)要求高，等保合規(guī)要求日志長(zhǎng)期存儲(chǔ)，人力不足，維護(hù)成本高。

基于云日志服務(wù) LTS 可以實(shí)現(xiàn)：

提供全場(chǎng)景日志接入，全面覆蓋業(yè)務(wù)、應(yīng)用、中間件和基礎(chǔ)設(shè)施，實(shí)現(xiàn)快速收集日志。

支持秒級(jí)日志查詢和分鐘級(jí)日志監(jiān)控，通過配置告警規(guī)則和告警通知，實(shí)現(xiàn)分鐘級(jí)問題定位和分析。

支持將日志轉(zhuǎn)儲(chǔ)至 OBS 實(shí)現(xiàn)長(zhǎng)期保存，滿足網(wǎng)絡(luò)安全要求。

LTS 提供解決方案參考如下圖1，可以實(shí)現(xiàn)統(tǒng)一收集生產(chǎn)環(huán)境應(yīng)用日志，開發(fā)人員檢索分析日志，運(yùn)維人員基于日志配置告警，實(shí)時(shí)感知現(xiàn)網(wǎng)業(yè)務(wù)，及時(shí)發(fā)現(xiàn)并解決故障問題。

圖 1 應(yīng)用運(yùn)維解決方案

應(yīng)用場(chǎng)景 2：安全合規(guī)

大型企業(yè)的每個(gè)業(yè)務(wù)部門都有獨(dú)立的云賬戶實(shí)現(xiàn)資源隔離，每個(gè)業(yè)務(wù)部門的運(yùn)維人員需要依賴日志監(jiān)控告警實(shí)現(xiàn)故障定位分析，同時(shí)集團(tuán)安全部門需要統(tǒng)一監(jiān)控日志，因此多賬號(hào)的統(tǒng)一日志管理成為企業(yè)痛點(diǎn)：

分業(yè)務(wù)獨(dú)立運(yùn)維：客戶每個(gè)業(yè)務(wù)模塊都有一個(gè)獨(dú)立的賬號(hào)做資源隔離，依賴日志服務(wù)配置監(jiān)控告警，快速分析發(fā)現(xiàn)故障并定位根因。

安全部門統(tǒng)一監(jiān)控日志：客戶使用多賬號(hào)管理體系，每個(gè)業(yè)務(wù)部門有一個(gè)獨(dú)立的賬號(hào)，安全部門需要匯聚所有日志到一個(gè)賬號(hào)，并存儲(chǔ) 180 天以上來滿足法規(guī)要求。

基于云日志服務(wù) LTS 可以實(shí)現(xiàn)：

多賬號(hào)獨(dú)立管理：每個(gè)賬號(hào)獨(dú)立采集各自業(yè)務(wù)的應(yīng)用日志、云服務(wù)日志，資源互相隔離、權(quán)限劃分清晰；借助日志告警配置，90%問題定位控制在 10 分鐘。

日志數(shù)據(jù)跨賬號(hào)集中匯聚：使用 LTS 的多賬號(hào)日志匯聚功能，將各個(gè)子賬號(hào)的日志復(fù)制一份到統(tǒng)一監(jiān)控賬號(hào)，長(zhǎng)期存儲(chǔ) 180 天，便于安全部門集中審計(jì)，滿足網(wǎng)絡(luò)安全法規(guī)要求。

LTS 提供解決方案參考如下圖2，可以實(shí)現(xiàn)統(tǒng)一收集云服務(wù)、應(yīng)用程序日志，支持保存 180 天以上，滿足《網(wǎng)絡(luò)安全法》、《GDPR》等法律法規(guī)要求。

圖 2 安全合規(guī)解決方案

應(yīng)用場(chǎng)景 3：運(yùn)營(yíng)分析

企業(yè)在日常經(jīng)營(yíng)中，可以上報(bào)各種業(yè)務(wù)日志（例如移動(dòng)端日志、服務(wù)端日志），經(jīng)過規(guī)整、過濾、脫敏、富化等加工處理后，可以融合大數(shù)據(jù)平臺(tái)、BI 工具進(jìn)行業(yè)務(wù)分析，例如獲取頁面的 PV、UV、用戶停留時(shí)間、交易金額等，用于了解業(yè)務(wù)運(yùn)營(yíng)狀況、分析用戶行為特征，基于實(shí)時(shí)的數(shù)據(jù)分析反饋調(diào)整業(yè)務(wù)決策，提升用戶體驗(yàn)，提升經(jīng)營(yíng)效率，實(shí)現(xiàn)企業(yè)的數(shù)字化轉(zhuǎn)型。

在業(yè)務(wù)分析過程中經(jīng)常遇到如下痛點(diǎn)：

移動(dòng)端數(shù)據(jù)難采集：難以快速采集多種移動(dòng)端設(shè)備，例如 Web 瀏覽器、iOS、安卓、鴻蒙、百度小程序、微信小程序、釘釘小程序、快應(yīng)用等多類端側(cè)日志無法快速采集。

數(shù)據(jù)傳輸不可靠：移動(dòng)端日志數(shù)據(jù)量多且頻繁，傳輸速度慢，也極易出現(xiàn)丟失，對(duì)業(yè)務(wù)分析造成一定影響。

數(shù)據(jù)處理不方便：原始數(shù)據(jù)不方便處理，不方便快速與大數(shù)據(jù)平臺(tái)實(shí)現(xiàn)對(duì)接。

云日志服務(wù) LTS 支持采集多種移動(dòng)端日志，融合大數(shù)據(jù)完成業(yè)務(wù)運(yùn)營(yíng)分析，基于 LTS 可以實(shí)現(xiàn)：

端側(cè)日志全面采集接入：集成 LTS 提供的多種移動(dòng)端 SDK，實(shí)現(xiàn)了緩存發(fā)送、異常重試、批量發(fā)送等穩(wěn)定功能，用戶快速集成即可全面采集移動(dòng)端日志到 LTS。

秒級(jí)上報(bào)，高可靠：端側(cè)采集日志后，經(jīng)傳輸鏈路秒級(jí)完成上報(bào)，數(shù)據(jù)無丟失，支撐業(yè)務(wù)做完整性分析。

DLI 和 DWS 快速對(duì)接 LTS：DLI-Flink 簡(jiǎn)易集成 Connector，定點(diǎn)從 LTS 實(shí)時(shí)消費(fèi)日志；LTS 日志可快速配置轉(zhuǎn)儲(chǔ)到 OBS，供 DLI 快速從 OBS 讀取日志；LTS 支持直接將結(jié)構(gòu)化日志轉(zhuǎn)儲(chǔ)到 DWS。

LTS 提供解決方案參考如下圖3，可以對(duì)日志結(jié)構(gòu)化解析，基于 SQL 語法分析日志，生成可視化圖表，并結(jié)合大數(shù)據(jù)平臺(tái)幫助企業(yè)進(jìn)一步挖掘數(shù)據(jù)價(jià)值，助力企業(yè)數(shù)字化轉(zhuǎn)型。

審核編輯 黃宇