全部产品
Search
文档中心

ApsaraMQ for RocketMQ:Konfigurasi Log

更新时间:Jun 28, 2025

Log klien mencatat dan membantu Anda menyelesaikan masalah pengecualian yang terjadi selama berjalannya ApsaraMQ for RocketMQ klien. Topik ini menjelaskan cara melihat dan mengonfigurasi log klien dari ApsaraMQ for RocketMQ SDK.

Jalur default file log

Tabel berikut menjelaskan jalur default log klien untuk berbagai bahasa pemrograman:
Catatan {$HOME} adalah direktori root aplikasi yang Anda mulai.
Bahasa pemrogramanJalur 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 klien dimulai, file log dihasilkan berdasarkan konfigurasi sistem default. Anda juga dapat mengonfigurasi item kustom dan memodifikasi parameter log.

Catatan Anda tidak dapat mengonfigurasi item kustom untuk log klien dalam C++ dan C#.

Java

ParameterDeskripsiNilai valid
rocketmq.log.levelTingkat log.
  • ERROR
  • WARN
  • INFO
  • DEBUG

Nilai default: INFO.

rocketmq.log.rootDirektori root log.Nilai default: {$HOME}/logs/rocketmq.

{$HOME} adalah direktori root proses Java yang Anda mulai. Anda dapat mengatur parameter ini ke direktori lokal Anda.

Catatan Pastikan proses aplikasi Anda diberi izin tulis pada jalur tersebut. Jika tidak, log tidak dapat dicetak.
rocketmq.log.file.maxIndexJumlah maksimum file log yang disimpan.Nilai valid: 1 hingga 100. Nilai default: 10.

Jika nilai yang ditentukan tidak dalam rentang ini atau dalam format yang tidak valid, nilai default yang disediakan oleh sistem akan digunakan.

Ukuran maksimum file log adalah 64 MB dan tidak dapat diubah.

Go

ParameterDeskripsiNilai Valid
rocketmq.client.logLevelTingkat log.
  • ERROR
  • WARN
  • INFO
  • DEBUG

Nilai default: INFO.

rocketmq.client.logRootDirektori root log.Nilai default: {$HOME}/logs/rocketmq.

{$HOME} adalah direktori root proses Go yang Anda mulai. Anda dapat mengatur parameter ini ke direktori lokal Anda.

Catatan Pastikan proses aplikasi Anda memiliki izin tulis pada jalur tersebut. Jika tidak, log tidak dapat dicetak.
rocketmq.client.logFileNameNama file log.Nilai default: rocketmq_client_go.log.
rocketmq.log.file.maxIndexJumlah maksimum file log yang disimpan.Nilai valid: 1 hingga 100. Nilai default: 10.
rocketmq.client.logFileMaxSizeUkuran maksimum file log.Nilai default: 1 GB.

Konfigurasi contoh

Anda dapat memodifikasi parameter sistem untuk mengonfigurasi item kustom untuk SDK Java dan SDK Go. Untuk informasi lebih lanjut tentang parameter log, lihat Parameter Log.

Konfigurasi contoh SDK untuk Java

Dalam skrip startup atau opsi mesin virtual (VM) dari lingkungan pengembangan terintegrasi (IDE), jalankan perintah -D untuk mengonfigurasi log klien.

Kode contoh berikut menunjukkan cara mengatur parameter rocketmq.log.level ke INFO:
java -Drocketmq.log.level=INFO -jar foobar.jar

Konfigurasi contoh SDK untuk Go

  • Konfigurasi statis: Konfigurasikan parameter log dalam variabel lingkungan dan mulai klien untuk Go.
  • Konfigurasi dinamis: Konfigurasikan parameter log dalam kode dan panggil operasi ResetLogger().
    Kode contoh berikut menunjukkan cara mengatur parameter rocketmq.log.level ke WARN:
    os.Setenv("rocketmq.client.logLevel", "WARN")
    rmq_client.ResetLogger()