全部产品
Search

搜索本产品

    ApsaraMQ for RocketMQ：Pengaturan Logging

    文档中心

    ApsaraMQ for RocketMQ：Pengaturan Logging

    更新时间：Jun 28, 2025

    Log klien mencatat pengecualian yang terjadi saat klien ApsaraMQ for RocketMQ beroperasi. Log ini membantu Anda dengan cepat mengidentifikasi dan menangani pengecualian. Topik ini menjelaskan item konfigurasi log klien, cara mengaktifkan fitur pencetakan log untuk klien, serta cara mengonfigurasi pengaturan log klien.

    Aktifkan fitur pencetakan log untuk klien

    TCP Client SDK untuk Java dari ApsaraMQ for RocketMQ dikembangkan menggunakan API SLF4J.

    • SDK untuk Java versi 1.7.8.Final atau lebih baru: Fitur pencetakan log diaktifkan secara default. Tidak diperlukan konfigurasi tambahan.

      ApsaraMQ for RocketMQ SDK untuk Java 1.7.8.Final menyertakan implementasi logging bawaan. Anda tidak perlu menambahkan dependensi implementasi logging ke aplikasi klien untuk mencetak log klien ApsaraMQ for RocketMQ.

    • SDK untuk Java versi sebelum 1.7.8.Final: Tambahkan dependensi implementasi logging.

      ApsaraMQ for RocketMQ SDK untuk Java versi sebelum 1.7.8.Final hanya mendukung Log4j dan Logback, tetapi tidak mendukung Log4j2. Anda perlu menambahkan dependensi implementasi logging yang sesuai ke file konfigurasi pom.xml atau lib untuk mencetak log klien ApsaraMQ for RocketMQ. Kami merekomendasikan penggunaan versi terbaru dari Message Queue for Apache RocketMQ SDK untuk Java untuk mencetak log klien.

      Penting

      Jika aplikasi menggunakan Log4j dan Logback sebagai dependensi implementasi logging, log klien mungkin tidak dapat dicetak dengan benar karena konflik logging. Pastikan aplikasi hanya menggunakan salah satu dari dua dependensi implementasi logging tersebut. Anda dapat menjalankan perintah mvn clean dependency:tree | grep log untuk memeriksanya.

    Item konfigurasi log klien

    Tabel berikut menjelaskan item konfigurasi log klien. Setelah klien dimulai, file log akan dibuat berdasarkan konfigurasi sistem default. Anda juga dapat menyesuaikan item konfigurasi dan mengubah parameter log. Untuk informasi lebih lanjut, lihat bagian Konfigurasikan Log Klien dalam topik ini.

    Item konfigurasi

    Konfigurasi sistem default

    Apakah mendukung parameter kustom

    Parameter

    Nilai kustom

    Path penyimpanan log

    Path untuk menyimpan file log: /{user.home}/logs/ons.log, di mana {user.home} adalah direktori root akun yang menjalankan proses Java saat ini.

    Ya

    ons.client.logRoot

    Anda dapat menyesuaikan path tempat Anda ingin menyimpan file log ke komputer lokal Anda.

    Pastikan proses aplikasi diberikan izin tulis pada path ini. Jika proses aplikasi tidak diberikan izin tulis pada path tersebut, log tidak dapat dicetak.

    Level log

    INFO

    Ya

    ons.client.logLevel

    Nilai valid:

    • ERROR

    • WARN

    • INFO

    • DEBUG

    Jumlah maksimum file log historis yang disimpan

    10

    Ya

    ons.client.logFileMaxIndex

    Nilai valid: 1 hingga 100.

    Jika nilai yang ditentukan berada di luar rentang ini atau dalam format yang tidak valid, nilai default sistem (10) yang disediakan oleh sistem akan digunakan.

    Ukuran file log tunggal

    64 MB

    Tidak

    N/A

    N/A

    Konfigurasikan log klien

    Penting

    Untuk menyesuaikan konfigurasi log klien, tingkatkan SDK untuk Java ke versi 1.2.5 atau lebih baru.

    • Metode Konfigurasi: Dalam skrip startup atau opsi VM dari lingkungan pengembangan terintegrasi (IDE), jalankan perintah -D untuk menentukan item konfigurasi log klien.

    • Contoh Konfigurasi:

      • Contoh Konfigurasi di Linux

        -Dons.client.logRoot=/home/admin/logs -Dons.client.logLevel=WARN -Dons.client.logFileMaxIndex=20

      • Contoh Konfigurasi di Windows

        -Dons.client.logRoot=D:\logs -Dons.client.logLevel=WARN -Dons.client.logFileMaxIndex=20

      /home/admin/ dan D:\ disediakan sebagai referensi. Ganti sesuai kebutuhan.