Journalisation avec le Kit de développement logiciel (SDK) Azure pour Java et java.util.logging
Cet article fournit une vue d’ensemble de l’ajout de la journalisation à l’aide de java.util.logging aux applications qui utilisent le Kit de développement logiciel (SDK) Azure pour Java. Le framework java.util.logging fait partie du JDK. Comme mentionné dans Configurer la journalisation dans le Kit de développement logiciel (SDK) Azure pour Java, toutes les bibliothèques clientes Azure se connectent via SLF4J, afin de pouvoir utiliser des frameworks de journalisation tels que java.util.logging.
Pour activer java.util.logging, vous devez effectuer deux opérations :
- Inclure l’adaptateur SLF4J pour java.util.logging en tant que dépendance.
- Créez un fichier appelé logging.properties sous le répertoire de projet /src/main/resources.
Pour plus d’informations sur la configuration de votre enregistreur d’événements, consultez Configuration de la sortie de journalisation dans la documentation Oracle.
Ajouter la dépendance Maven
Pour ajouter la dépendance Maven, incluez le code XML suivant dans le fichier pom.xml du projet. Remplacez le numéro de version 1.7.30 par le numéro de la dernière version figurant sur la page de liaison SLF4J JDK14.
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-jdk14</artifactId>
<version>1.7.30</version> <!-- replace this version with the latest available version on Maven central -->
</dependency>
Ajouter logging.properties à votre projet
Pour journaliser à l’aide de java.util.logging, créez un fichier appelé logging.properties sous le répertoire ./src/main/resources répertoire de votre projet ou ailleurs. Ce fichier contient les configurations de journalisation pour personnaliser vos besoins de journalisation. Fournissez le chemin d’accès au fichier en définissant la propriété système java.util.logging.config.file. Vous devez définir cette propriété avant de créer l’instance d’enregistreur d’événements. Pour plus d’informations, consultez Journalisation Java : Configuration.
Écriture dans le journal de la console
Vous pouvez créer une configuration pour vous connecter à la console, comme illustré dans l’exemple suivant. Cet exemple est configuré pour journaliser tous les événements de journalisation qui sont au niveau INFO ou supérieur, où qu’ils proviennent.
handlers = java.util.logging.ConsoleHandler
.level = INFO
java.util.logging.ConsoleHandler.level = INFO
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
java.util.logging.SimpleFormatter.format=[%1$tF %1$tH:%1$tM:%1$tS.%1$tL] [%4$s] %3$s %5$s %n
Consigner dans un fichier
L’exemple précédent effectue la journalisation dans la console, qui n’est normalement pas l’emplacement privilégié pour les journaux. Pour configurer la journalisation dans un fichier à la place, utilisez la configuration suivante :
handlers = java.util.logging.FileHandler
.level = INFO
java.util.logging.FileHandler.pattern = %h/myapplication.log
java.util.logging.FileHandler.formatter = java.util.logging.SimpleFormatter
java.util.logging.FileHandler.level = INFO
Ce code crée un fichier appelé myapplication.log dans votre répertoire de base (%h). Cet enregistreur d’événements ne prend pas en charge la rotation automatique des fichiers après une certaine période. Si vous avez besoin de cette fonctionnalité, vous devez écrire un planificateur pour gérer la rotation des fichiers journaux.
Étapes suivantes
Cet article a abordé la configuration de java.util.logging et la façon de faire en sorte que le Kit de développement logiciel (SDK) Azure pour Java l’utilise pour la journalisation. Étant donné que le Kit de développement logiciel (SDK) Azure pour Java fonctionne avec toutes les infrastructures de journalisation SLF4J, considérez examiner le manuel de l’utilisateur SLF4J pour plus d’informations.
Après avoir masterisé la journalisation, examinez les intégrations qu’Azure propose dans des frameworks tels que Spring et MicroProfile.