Les journaux du client enregistrent les exceptions d'exécution des clients ApsaraMQ for RocketMQ. Utilisez-les pour localiser et résoudre les problèmes.
Activer la journalisation
Le SDK client TCP pour Java utilise l'API SLF4J pour la journalisation. Les exigences en matière de dépendances varient selon la version du SDK :
SDK for Java 1.7.8.Final ou version ultérieure : La journalisation est activée par défaut. Le SDK intègre une implémentation de journalisation ; aucune dépendance supplémentaire n'est requise.
SDK for Java antérieur à la version 1.7.8.Final : Ajoutez une dépendance d'implémentation de journalisation à votre fichier
pom.xmlou au répertoire lib. Ces versions prennent uniquement en charge Log4j et Logback, mais pas Log4j2. Nous vous recommandons d'utiliser la dernière version du SDK ApsaraMQ for RocketMQ pour Java afin d'imprimer les journaux du client.
Si votre application inclut à la fois Log4j et Logback en tant que dépendances, les journaux du client ne s'affichent pas en raison de conflits de journalisation. Conservez une seule implémentation de journalisation. Pour vérifier, exécutez :
mvn clean dependency:tree | grep logConfiguration par défaut
Au démarrage, le client génère des fichiers journaux avec les paramètres par défaut suivants :
Chemin du fichier journal :
/{user.home}/logs/ons.log, où{user.home}représente le répertoire personnel du compte exécutant le processus Java actuelNiveau de journalisation : INFO
Nombre maximal de fichiers journaux historiques : 10
Taille d'un fichier journal unique : 64 Mo (non configurable)
Paramètres de configuration
Pour remplacer les valeurs par défaut, transmettez des indicateurs JVM -D dans votre script de démarrage ou dans les options VM de l'IDE.
|
Paramètre |
Valeur par défaut |
Valeurs valides |
Description |
|
|
|
Tout chemin accessible en écriture |
Répertoire racine des fichiers journaux. Assurez-vous que le processus de l'application dispose des autorisations d'écriture sur ce chemin. |
|
|
INFO |
ERROR, WARN, INFO, DEBUG |
Niveau de verbosité des journaux. |
|
|
10 |
1–100 |
Nombre maximal de fichiers journaux historiques à conserver. Les valeurs situées en dehors de cette plage ou dont le format est incorrect reviennent à la valeur par défaut (10). |
Configurer les journaux du client
La configuration personnalisée des journaux nécessite le SDK for Java 1.2.5 ou une version ultérieure.
Transmettez des indicateurs -D dans le script de démarrage ou dans les options VM de l'IDE pour remplacer les valeurs par défaut.
Linux :
-Dons.client.logRoot=/home/admin/logs -Dons.client.logLevel=WARN -Dons.client.logFileMaxIndex=20Windows :
-Dons.client.logRoot=D:\logs -Dons.client.logLevel=WARN -Dons.client.logFileMaxIndex=20Remplacez /home/admin/logs et D:\logs par les chemins réels de vos répertoires de journaux.