Log klien mencatat dan membantu Anda menyelesaikan masalah pengecualian yang terjadi selama berjalannya ApsaraMQ for RocketMQ klien. Topik ini menjelaskan item konfigurasi log klien, cara mengaktifkan fitur pencetakan log untuk klien, serta cara mengonfigurasi log klien kustom.
Kami merekomendasikan agar Anda menggunakan SDK RocketMQ 5.x terbaru. SDK ini sepenuhnya kompatibel dengan broker ApsaraMQ for RocketMQ 5.x dan menyediakan lebih banyak fungsi serta fitur yang ditingkatkan. Untuk informasi lebih lanjut, lihat Deskripsi Versi.
Alibaba Cloud hanya memelihara SDK klien RocketMQ 3.x, 4.x, dan TCP. Kami merekomendasikan agar Anda hanya menggunakannya untuk bisnis yang sudah ada.
Aktifkan fitur pencetakan log untuk klien
SDK untuk Java yang disediakan oleh ApsaraMQ for RocketMQ dikembangkan menggunakan API SLF4J.
- SDK untuk Java 1.7.8.Final atau lebih baru: Secara default, fitur pencetakan log didukung oleh versi SDK ini. Tidak diperlukan konfigurasi tambahan.
SDK untuk Java 1.7.8.Final yang disediakan oleh ApsaraMQ for RocketMQ memiliki kerangka kerja bawaan untuk logging. Anda tidak perlu menambahkan dependensi pada kerangka kerja logging yang sesuai untuk aplikasi di klien sebelum mencetak log ApsaraMQ for RocketMQ klien.
- SDK untuk Java versi lebih lama dari 1.7.8.Final: Anda harus menambahkan dependensi pada kerangka kerja logging yang sesuai.
SDK ApsaraMQ for RocketMQ untuk Java 1.7.8.Final atau lebih lama hanya mendukung Log4j dan Logback tetapi tidak mendukung Log4j2. Anda harus menambahkan dependensi pada kerangka kerja logging yang sesuai ke file
pom.xmlatau file .lib sebelum mencetak log klien ApsaraMQ for RocketMQ. Kami merekomendasikan agar Anda menggunakan versi terbaru dari SDK untuk Java untuk mencetak log klien.
mvn clean dependency:tree | grep log untuk menyelesaikan masalah.Item konfigurasi log klien
Tabel berikut menjelaskan item konfigurasi log klien. Setelah klien dimulai, sistem akan menghasilkan file log berdasarkan konfigurasi default. Anda juga dapat menentukan nilai kustom untuk item konfigurasi. Untuk informasi lebih lanjut, lihat bagian Konfigurasikan Log Klien Kustom dalam topik ini.
| Item konfigurasi | Konfigurasi default | Konfigurasi kustom diizinkan | Parameter | Nilai kustom |
| Path penyimpanan log | Path untuk menyimpan file log adalah /{user.home}/logs/ons.log. Dalam path tersebut, {user.home} adalah direktori root dari akun yang menjalankan proses Java. | Ya | ons.client.logRoot | Anda dapat menentukan path kustom di komputer Anda untuk menyimpan file log. Pastikan proses aplikasi Anda diberi izin menulis pada path tersebut. Jika tidak, log tidak dapat dicetak. |
| Level log | INFO | Ya | ons.client.logLevel | Nilai valid:
|
| Jumlah maksimum file log historis yang disimpan | 10 | Ya | ons.client.logFileMaxIndex | Nilai valid: 1 hingga 100. Jika nilai yang ditentukan tidak dalam rentang valid atau memiliki format tidak valid, nilai default 10 akan digunakan. |
| Ukuran file log | 64 MB | Tidak | Tidak tersedia | Tidak tersedia |
Konfigurasikan log klien kustom
- Metode: Dalam skrip startup atau opsi mesin virtual (VM) dari lingkungan pengembangan terintegrasi (IDE), jalankan perintah
-Duntuk menentukan item konfigurasi log klien. - Contoh:
- Kode Contoh di Linux
-Dons.client.logRoot=/home/admin/logs -Dons.client.logLevel=WARN -Dons.client.logFileMaxIndex=20 - Kode Contoh di Windows
-Dons.client.logRoot=D:\logs -Dons.client.logLevel=WARN -Dons.client.logFileMaxIndex=20
- Kode Contoh di Linux