Simple Log Service：Memulai dengan Simple Log Service SDK untuk HarmonyOS

Prasyarat

Simple Log Service SDK untuk HarmonyOS harus sudah diinstal. Untuk informasi lebih lanjut, lihat Instal Simple Log Service SDK untuk HarmonyOS.

Inisialisasi SDK

Anda dapat menginisialisasi SDK berdasarkan kode contoh berikut:

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>" // Variabel ini hanya diperlukan jika pasangan AccessKey diperoleh dengan memanggil operasi Security Token Service (STS).
);

• Layanan Log Sederhana menyediakan titik akhir untuk wilayah tempat proyek berada. Anda dapat mengakses Layanan Log Sederhana menggunakan titik akhir internal atau publik. Titik akhir internal dapat diakses melalui jaringan klasik atau virtual private cloud (VPC). Titik akhir publik dapat diakses melalui Internet. Untuk informasi lebih lanjut, lihat Titik akhir.

• Pasangan AccessKey Alibaba Cloud adalah kredensial identitas keamanan yang dapat Anda gunakan untuk mengakses sumber daya Alibaba Cloud dengan memanggil operasi API. Anda dapat menggunakan pasangan AccessKey untuk menandatangani permintaan API guna melewati otentikasi keamanan. Untuk informasi lebih lanjut, lihat Pasangan AccessKey.

Laporkan log

Anda dapat menggunakan metode addLog untuk melaporkan log bisnis kustom.

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

Jika code == 0 dikembalikan, log berhasil dilaporkan. Untuk informasi lebih lanjut tentang kode status, lihat Kode status.

Konfigurasikan pasangan AccessKey

Simple Log Service SDK untuk HarmonyOS memungkinkan Anda memperbarui pasangan AccessKey secara dinamis. Anda dapat memperbarui pasangan AccessKey berdasarkan kode contoh berikut:

aliyunLog.setAccessKey(
    "<your accesskey id>", // Tentukan ID AccessKey yang valid.
    "<your accesskey secret>", // Tentukan Rahasia AccessKey yang valid.
    null // Tentukan Token AccessKey yang valid. Variabel ini hanya diperlukan jika pasangan AccessKey diperoleh dengan memanggil operasi STS.
);

Konfigurasikan callback untuk pengiriman log

Simple Log Service SDK untuk HarmonyOS mendukung callback untuk pengiriman log. Ketika log berhasil dikirim atau gagal dikirim, informasi callback dihasilkan. Anda dapat menggunakan informasi callback untuk melihat status SDK atau memperbarui pengaturan parameter SDK.

class MyLogCallback implements LogCallback {

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

    onLogCallback(logStore:string, code:number, logBytes:number, compressedBytes:number, errorMessage:string) {
        // Kode kesalahan 6 menunjukkan bahwa pasangan AccessKey tidak valid.
        // Kode kesalahan 11 menunjukkan bahwa pengaturan parameter tidak valid.
        if (code == 6 || code == 11) {
            aliyunLog.setAccessKey(
                    "<your accesskey id>", // Tentukan ID AccessKey yang valid.
                    "<your accesskey secret>", // Tentukan Rahasia AccessKey yang valid.
                    null // Tentukan Token AccessKey yang valid. Variabel ini hanya diperlukan jika pasangan AccessKey diperoleh dengan memanggil operasi STS.
            );
        }
    }
}

Kode status