Journalisation avec le Kit de développement logiciel (SDK) Azure pour Java et java.util.logging

Article
10/23/2023

Cet article fournit une vue d’ensemble de l’ajout de la journalisation à l’aide de java.util.logging à des applications qui utilisent le kit de développement logiciel (SDK) Azure pour Java. Le framework java.util.logging fait partie du JDK. Comme indiqué dans Configurer la journalisation dans le SDK Azure pour Java, toutes les bibliothèques clientes Azure se connectent via SLF4J, de sorte que vous pouvez utiliser des frameworks de journalisation tels que java.util.logging.

Pour activer java.util.logging, vous devez effectuer deux opérations :

Incluez l’adaptateur SLF4J pour java.util.logging comme dépendance.
Créez un fichier appelé logging.properties dans le répertoire du 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, ajoutez 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 vous connecter à l’aide java.util.logging, créez un fichier appelé logging.properties sous le répertoire ./src/main/resources de votre projet ou ailleurs. Ce fichier contient les configurations de journalisation pour personnaliser vos besoins en matière de journalisation. Fournissez le chemin d’accès au fichier en définissant la java.util.logging.config.file propriété système. 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 connexion qui sont au niveau INFO ou supérieur, peu importe d’où 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 un certain laps de temps. Si vous avez besoin de cette fonctionnalité, vous devrez écrire un planificateur pour gérer la rotation des fichiers journaux.

Étapes suivantes

Cet article vous a présenté la configuration de java.util.logginget comment 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 Azure pour Java fonctionne avec tous les frameworks de journalisation SLF4J, consultez le manuel de l’utilisateur SLF4J pour plus d’informations.

Une fois que vous maîtrisez la journalisation, intéressez-vous aux intégrations offertes par Azure dans les frameworks tels que Spring et MicroProfile.

Partager via