Konfigurasi pengaturan log klien untuk SDK - ApsaraMQ for RocketMQ

SDK ApsaraMQ for RocketMQ menghasilkan log client yang mencatat event dan exception selama waktu proses. Gunakan log tersebut untuk memecahkan masalah yang terjadi selama operasi client.

Jalur file log default

Tabel berikut mencantumkan jalur file log default untuk setiap bahasa SDK. {$HOME} adalah direktori root aplikasi yang Anda jalankan.

Bahasa	Jalur default
Java	`{$HOME}/logs/rocketmq/rocketmq-client.log`
C++	`{$HOME}/logs/rocketmq/client.log`
C#	`{$HOME}/logs/rocketmq/rocketmq-client.log`
Go	`{$HOME}/logs/rocketmq/rocketmq_client_go.log`

Parameter log

Setelah client dijalankan, file log dibuat berdasarkan pengaturan default. SDK Java dan Go mendukung parameter log kustom, sedangkan SDK C++ dan C# tidak mendukung konfigurasi log kustom.

Java

Semua parameter log Java dikonfigurasi melalui properti sistem JVM menggunakan flag -D.

Parameter	Deskripsi	Default	Nilai valid
`rocketmq.log.level`	Tingkat verbosity log.	`INFO`	`ERROR`, `WARN`, `INFO`, `DEBUG`
`rocketmq.log.root`	Direktori root untuk output log.	`{$HOME}/logs/rocketmq`	Direktori lokal apa pun yang memiliki izin tulis.
`rocketmq.log.file.maxIndex`	Jumlah maksimum file log yang disimpan. Setiap file log memiliki ukuran maksimum tetap sebesar 64 MB.	`10`	`1`--`100`. Nilai di luar rentang ini atau dalam format yang tidak valid akan kembali ke nilai default.

Catatan

Pastikan proses aplikasi memiliki izin tulis pada direktori log yang ditentukan. Jika tidak, log tidak dapat dicetak.

Go

Parameter log Go dikonfigurasi melalui variabel lingkungan.

Parameter	Deskripsi	Default	Nilai valid
`rocketmq.client.logLevel`	Tingkat verbosity log.	`INFO`	`ERROR`, `WARN`, `INFO`, `DEBUG`
`rocketmq.client.logRoot`	Direktori root untuk output log.	`{$HOME}/logs/rocketmq`	Direktori lokal apa pun yang memiliki izin tulis.
`rocketmq.client.logFileName`	Nama file log.	`rocketmq_client_go.log`	Nama file yang valid apa pun.
`rocketmq.log.file.maxIndex`	Jumlah maksimum file log yang disimpan.	`10`	`1`--`100`
`rocketmq.client.logFileMaxSize`	Ukuran maksimum setiap file log.	`1 GB`	--

Catatan

Pastikan proses aplikasi memiliki izin tulis pada direktori log yang ditentukan. Jika tidak, log tidak dapat dicetak.

Konfigurasi logging

Java

Dalam skrip startup atau opsi VM IDE, gunakan flag -D untuk mengatur parameter log.

Atur tingkat log ke INFO:

java -Drocketmq.log.level=INFO -jar foobar.jar

Atur direktori log kustom dan tingkatkan retensi file:

java -Drocketmq.log.level=WARN \
     -Drocketmq.log.root=/var/log/myapp/rocketmq \
     -Drocketmq.log.file.maxIndex=20 \
     -jar foobar.jar

Go

SDK Go mendukung dua metode konfigurasi:

Konfigurasi statis — Atur variabel lingkungan sebelum menjalankan client.
Konfigurasi dinamis — Atur variabel lingkungan dalam kode dan panggil ResetLogger() untuk menerapkan perubahan selama waktu proses.

Konfigurasi dinamis (ubah saat runtime):

os.Setenv("rocketmq.client.logLevel", "WARN")
rmq_client.ResetLogger()