Log configuration - ApsaraMQ for RocketMQ - Centre de documentation Alibaba Cloud

Les SDK ApsaraMQ for RocketMQ génèrent des journaux client qui enregistrent les événements d'exécution et les exceptions. Utilisez ces journaux pour diagnostiquer les problèmes lors de l'utilisation du client.

Chemins par défaut des fichiers de journaux

Le tableau suivant répertorie le chemin d'accès par défaut aux fichiers de journaux pour chaque langage SDK. {$HOME} correspond au répertoire racine de l'application lancée.

Langage	Chemin par défaut
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`

Paramètres des journaux

Au démarrage, le client crée un fichier journal selon les paramètres par défaut. Les SDK Java et Go permettent de personnaliser la configuration des journaux. Les SDK C++ et C# ne prennent pas en charge cette personnalisation.

Java

Définissez tous les paramètres de journalisation Java via les propriétés système de la JVM (indicateurs -D).

Paramètre	Description	Valeur par défaut	Valeurs valides
`rocketmq.log.level`	Niveau de verbosité des journaux.	`INFO`	`ERROR`, `WARN`, `INFO`, `DEBUG`
`rocketmq.log.root`	Répertoire racine de sortie des journaux.	`{$HOME}/logs/rocketmq`	Tout répertoire local disposant d'autorisations en écriture.
`rocketmq.log.file.maxIndex`	Nombre maximal de fichiers journaux à conserver. Chaque fichier journal a une taille maximale fixe de 64 Mo.	`10`	`1`--`100`. Les valeurs hors de cette plage ou dans un format invalide reviennent à la valeur par défaut.

Remarque

Vérifiez que le processus de l'application dispose des autorisations en écriture sur le répertoire de journalisation spécifié. Sinon, la génération des journaux échouera.

Go

Configurez les paramètres de journalisation Go via des variables d'environnement.

Paramètre	Description	Valeur par défaut	Valeurs valides
`rocketmq.client.logLevel`	Niveau de verbosité des journaux.	`INFO`	`ERROR`, `WARN`, `INFO`, `DEBUG`
`rocketmq.client.logRoot`	Répertoire racine de sortie des journaux.	`{$HOME}/logs/rocketmq`	Tout répertoire local disposant d'autorisations en écriture.
`rocketmq.client.logFileName`	Nom du fichier journal.	`rocketmq_client_go.log`	Tout nom de fichier valide.
`rocketmq.log.file.maxIndex`	Nombre maximal de fichiers journaux à conserver.	`10`	`1`--`100`
`rocketmq.client.logFileMaxSize`	Taille maximale de chaque fichier journal.	`1 GB`	--

Remarque

Vérifiez que le processus de l'application dispose des autorisations en écriture sur le répertoire de journalisation spécifié. Sinon, la génération des journaux échouera.

Configurer la journalisation

Java

Dans le script de démarrage ou les options de machine virtuelle (VM) de l'IDE, transmettez les indicateurs -D pour définir les paramètres de journalisation.

Définir le niveau de journalisation sur INFO :

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

Définir un répertoire de journalisation personnalisé et augmenter la rétention des fichiers :

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

Go

Le SDK Go prend en charge deux méthodes de configuration :

Configuration statique : définissez les variables d'environnement avant de démarrer le client.
Configuration dynamique : définissez les variables d'environnement dans le code et appelez ResetLogger() pour appliquer les modifications pendant l'exécution.

Configuration dynamique (modification à l'exécution) :

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