Aktifkan dan konfigurasi log client untuk Java SDK-ApsaraMQ for RocketMQ-Alibaba Cloud

Log client mencatat exception waktu proses dari client ApsaraMQ for RocketMQ. Gunakan log ini untuk mengidentifikasi dan memecahkan masalah.

Aktifkan pencetakan log

SDK client TCP untuk Java menggunakan API SLF4J untuk pencatatan log. Persyaratan dependensi berbeda tergantung pada versi SDK:

SDK for Java 1.7.8.Final atau yang lebih baru: Pencetakan log diaktifkan secara default. SDK menyertakan implementasi logging bawaan—tidak diperlukan dependensi tambahan.
SDK for Java versi sebelum 1.7.8.Final: Tambahkan dependensi implementasi logging ke file pom.xml atau direktori lib Anda. Versi ini hanya mendukung Log4j dan Logback, tidak mendukung Log4j2. Disarankan menggunakan versi terbaru SDK ApsaraMQ for RocketMQ untuk Java guna mencetak log client.

Penting

Jika aplikasi Anda menyertakan dependensi Log4j dan Logback secara bersamaan, log client tidak dapat dicetak karena konflik logging. Pertahankan hanya satu implementasi logging. Untuk memeriksa, jalankan perintah berikut:

mvn clean dependency:tree | grep log

Konfigurasi default

Saat client dijalankan, file log dihasilkan dengan pengaturan default berikut:

Jalur file log: /{user.home}/logs/ons.log, dengan {user.home} sebagai direktori home akun yang menjalankan proses Java saat ini
Tingkat log: INFO
Jumlah maksimum file log historis: 10
Ukuran maksimum satu file log: 64 MB (tidak dapat dikonfigurasi)

Parameter konfigurasi

Ubah nilai default dengan meneruskan flag JVM -D dalam skrip startup atau opsi VM IDE Anda.

Parameter	Default	Nilai yang valid	Deskripsi
`ons.client.logRoot`	`/{user.home}/logs/`	Jalur apa pun yang dapat ditulis	Direktori root untuk file log. Pastikan proses aplikasi memiliki izin menulis pada jalur ini.
`ons.client.logLevel`	INFO	ERROR, WARN, INFO, DEBUG	Tingkat detail verbosity log.
`ons.client.logFileMaxIndex`	10	1–100	Jumlah maksimum file log historis yang disimpan. Nilai di luar rentang ini atau dalam format yang tidak valid akan kembali ke nilai default (10).

Konfigurasi log client

Penting

Konfigurasi log kustom memerlukan SDK for Java versi 1.2.5 atau yang lebih baru.

Teruskan flag -D dalam skrip startup atau opsi VM IDE untuk mengganti nilai default.

Linux:

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

Windows:

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

Ganti /home/admin/logs dan D:\logs dengan jalur direktori log aktual Anda.