tencent cloud

Cloud Log Service

Harmony OS SDKログアップロード

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-12 15:06:43
AI翻訳・品質チェック済み
本文では、CLSのHarmonyOS SDKを使用してログアップロードを迅速に実装する方法について説明します。SDKの使用方法の詳細については、コードリポジトリ:tencntcloud-cls-sdk-ohosを参照してください。

前提条件

HarmonyOSアプリケーション開発環境がインストール済みです。詳細については、HarmonyOS開発者ガイドを参照してください。
TencentCloud APIキー情報access_secretとaccess_keyを作成して取得します。キー情報の取得については、APIキー管理にアクセスしてください。また、キーに関連付けられたアカウントに、対応するSDKログアップロード権限が付与されていることを確認してください。

HarmonyOS SDKのインストール

1. HarmonyOSアプリケーションプロジェクトを作成します。
2. CLS HarmonyOSモジュールをインポートし、プロジェクトで以下のコマンドを実行します。
ohpm install @farmerx/tencntcloud-cls-sdk-ohos
3. 実行完了後、指定されたetsファイルにCLSモジュールをインポートし、参照してコードを記述できます。
import { TencntcloudLog, LogCallback } from "@farmerx/tencntcloud-cls-sdk-ohos"

リクエストパラメータ

変数
タイプ
必須/任意
説明
endpoint
String
はい
地域情報です。入力の際は、利用可能なリージョンのAPIアップロードログタブにあるドメインをご参照ください。
access_secret
String
はい
TencentCloud APIキー情報です。キー情報の取得はAPIキー管理にアクセスしてください。また、キーに関連付けられたアカウントにSDKログアップロード権限が付与されていることを確認してください。
access_key
String
はい
TencentCloud APIキー情報です。キー情報の取得はAPIキー管理にアクセスしてください。また、キーに関連付けられたアカウントにSDKログアップロード権限が付与されていることを確認してください。
access_token
String
いいえ
一時キーのtokenです。一時キーを使用する場合は入力できます。
topic_id
String
はい
ログトピックのID情報です。

ログアップロードのサンプルコード

お客様のHarmonyOSプロジェクトでは、以下のサンプルコードを使用してログアップロード機能を実装できます。サンプルコードは以下の通りです。
コード内でTencentCloud APIキー(access_key、access_secret)を直接平文で使用することはリスクが高いため、安全性を確保するために、一時キーを使用して認証することをお勧めします。
import {LogProducer} from "@farmerx/tencntcloud-cls-sdk-ohos";

// 初期化します。
let producer = new LogProducer(
"#[topic_id]",
"#[access_key]",
"#[access_secret]",
"#[access_token]",
"",
"#[endpoint]", 100, 100, 2000)

// callbackコールバック関数を設定します。
producer.setCallback((err: Error | null, topicID: string, code: number, request_id: string, errorMessage: string) => {
if (err==null) {
hilog.info(0x0000,
'testTagCLS',
'onLogCallback.topic: %{public}s , code: %{public}d, request_id: %{public}s, errorMessage: %{public}s',
topicID, code, request_id, errorMessage
);
} else {
hilog.info(0x0000,
'testTagCLS',
'onLogCallback.topic: %{public}s, code: %{public}d, request_id: %{public}s, errorMessage: %{public}s',
topicID, code, request_id, err.message
);
}
})

// ソースIPを設定します。
producer.setSourceIp("127.0.0.3")


// reset access key
producer.setAccessKey("#[access_key]", "#[access_secret]", "#[access_token]");

// 同期送信します。
function syncsencLog() {
let logs: Record<string, string>[] = [];
let log: Record<string, string> = {};
// キーバリューペアを追加します。
log["key1"] = "value1";
log["key2"] = "value2";
log["key3"] = "value3";
logs.push(log)
try {
let rsp = producer.syncSendLogs( "127.0.0.1", logs)
hilog.info(0x0000, 'testTag', "========%{public}s, %{public}s", rsp.requestId, rsp.rspText)
} catch (e) {
// ....
}
}
// 非同期送信します。
function asyncSendLog() {
let log: Record<string, string> = {};
// キーバリューペアを追加します。
log["key1"] = "value1";
log["key2"] = "value2";
log["key3"] = "value3";
try {
producer.addLog(log)
} catch (e) {
// ....
}
}

asyncSendLog()
sencLog()


おわりに

以上の手順により、Tencent Cloud CLSのHarmonyOS SDKを使用して、ログのアップロード操作を迅速に完了できます。問題が発生した場合は、お問い合わせください。

ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック