Simple Log Service:HarmonyOS　SDKの使用を開始する

前提条件

Simple Log Service SDK for HarmonyOSがインストールされています。 詳細については、「Simple Log Service SDK For HarmonyOSのインストール」をご参照ください。

SDKの初期化

次のサンプルコードに基づいてSDKを初期化できます。

import { AliyunLog, LogCallback } from "@aliyunsls/producer"

let aliyunLog: AliyunLog = new AliyunLog(
  "<your endpoint>",
  "<your project>",
  "<your logstore>",
  "<your accesskey id>",
  "<your accesskey secret>",
  "<your accesskey token>" // This variable is required only when the AccessKey pair is obtained by calling a Security Token Service (STS) operation.
);

• Simple Log Serviceは、プロジェクトが存在するリージョンのエンドポイントを提供します。 Simple Log Serviceには、内部エンドポイントまたはパブリックエンドポイントを使用してアクセスできます。 内部エンドポイントは、クラシックネットワークまたは仮想プライベートクラウド (VPC) 経由でアクセスできます。 インターネット経由でパブリックエンドポイントにアクセスできます。 詳細については、「エンドポイント」をご参照ください。

• Alibaba Cloud AccessKeyペアは、API操作を呼び出してAlibaba Cloudリソースにアクセスするために使用できる安全なID資格情報です。 AccessKeyペアを使用して、セキュリティ認証を渡すためのAPIリクエストに署名できます。 詳細は、「AccessKeyペア」をご参照ください。

レポートログ

addLogメソッドを使用して、カスタムビジネスログをレポートできます。

let code = aliyunLog.addLog(new Map(
  [
    ["key1", "value1"],
    ["key2", "value2"],
    ["key3", "value3"],
  ]
));

code == 0が返された場合、ログが報告されます。 ststusコードの詳細については、「ステータスコード」をご参照ください。

AccessKey ペアの設定

Simple Log Service SDK for HarmonyOS SDKでは、AccessKeyペアを動的に更新できます。 次のサンプルコードに基づいて、AccessKeyペアを更新できます。

aliyunLog.setAccessKey(
    "<your accesskey id>", // Specify a valid AccessKey ID.
    "<your accesskey secret>", // Specify a valid AccessKey secret.
    null // Specify a valid AccessKey token. This variable is required only when the AccessKey pair is obtained by calling an STS operation.
);

ログ送信用のコールバックの設定

Simple Log Service SDK for HarmonyOSは、ログ送信のコールバックをサポートしています。 ログが送信されるか、送信に失敗すると、コールバック情報が生成されます。 コールバック情報を使用して、SDKのステータスを表示したり、SDKのパラメーター設定を更新したりできます。

class MyLogCallback implements LogCallback {

    init() {
        aliyunLog.setLogCallback(this);
    }

    onLogCallback(logStore:string, code:number, logBytes:number, compressedBytes:number, errorMessage:string) {
        // The error code 6 indicates that the AccessKey pair is invalid.
        // The error code 11 indicates that the parameter settings are invalid.
        if (code == 6 || code == 11) {
            aliyunLog.setAccessKey(
                    "<your accesskey id>", // Specify a valid AccessKey ID.
                    "<your accesskey secret>", // Specify a valid AccessKey secret.
                    null // Specify a valid AccessKey token. This variable is required only when the AccessKey pair is obtained by calling an STS operation.
            );
        }
    }
}

ステータスコード