用戶端日誌用於記錄雲訊息佇列 RocketMQ 版用戶端運行過程中的異常，協助您快速定位和修複問題。本文為您介紹如何查看和配置雲訊息佇列 RocketMQ 版SDK的用戶端日誌。
記錄檔預設路徑
各語言的用戶端記錄檔的預設路徑如下：
{$HOME}為您啟動當前應用程式的根目錄。
語言 | 預設路徑 |
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 |
日誌參數
用戶端啟動後，會按照系統預設配置組建記錄檔檔案；您也可以自訂配置項，修改日誌參數。
C++和C#的用戶端日誌暫不支援自訂配置。
Java
參數 | 說明 | 取值 |
rocketmq.log.level | 日誌輸出層級。 |
預設值：INFO。 |
rocketmq.log.root | 日誌輸出根目錄。 | 預設值為：{$HOME}/logs/rocketmq。 {$HOME}為啟動當前Java進程的根目錄，支援自訂為您的本地目錄。 說明 請確保您的應用進程有該路徑的寫入權限，否則日誌無法列印。 |
rocketmq.log.file.maxIndex | 記錄檔最大保留個數。 | 取值範圍：1~100，預設值：10。 若設定的值超出該範圍或格式錯誤，則以系統預設值為準。 單個記錄檔最大限制為64 MB，不支援調整。 |
Go
參數 | 說明 | 取值 |
rocketmq.client.logLevel | 日誌輸出層級。 |
預設值：INFO。 |
rocketmq.client.logRoot | 日誌輸出根目錄。 | 預設值為：{$HOME}/logs/rocketmq。 {$HOME}為啟動當前go進程的根目錄，支援自訂為您的本地目錄。 說明 請確保您的應用進程有該路徑的寫入權限，否則日誌無法列印。 |
rocketmq.client.logFileName | 記錄檔名。 | 預設值為：rocketmq_client_go.log。 |
rocketmq.log.file.maxIndex | 記錄檔最大保留個數。 | 取值範圍：1~100，預設值：10。 |
rocketmq.client.logFileMaxSize | 單個記錄檔大小的最大限制。 | 預設值：1 G。 |
配置樣本
Java SDK和Go SDK支援通過修改系統參數來修改日誌配置項，具體日誌參數，請參見日誌參數。
Java SDK日誌配置樣本
在啟動指令碼或者IDE的VM options中，通過-D命令設定用戶端日誌配置項。
以將日誌輸出層級設定為INFO為例，樣本如下：
java -Drocketmq.log.level=INFO -jar foobar.jarGo SDK日誌配置樣本
靜態設定：在環境變數中配置日誌參數後，直接啟動Go用戶端即可。
動態設定：在代碼中設定日誌參數，並調用
ResetLogger()。以將日誌輸出層級設定為WARN為例，樣本如下：
os.Setenv("rocketmq.client.logLevel", "WARN") rmq_client.ResetLogger()