Registro con Azure SDK para Java y java.util.logging

En este artículo se proporciona información general sobre cómo agregar el registro con java.util.logging a aplicaciones que usan Azure SDK para Java. El marco java.util.logging es parte del JDK. Como se menciona en Configuración del registro en Azure SDK para Java, todas las bibliotecas cliente Azure registran mediante SLF4J, por lo que puede usar marcos de registro como java.util.logging.

Para habilitar java.util.logging, debe hacer dos cosas:

1. Incluir el adaptador de SLF4J para java.util.logging como una dependencia.
2. Crear un archivo llamado logging.properties en el directorio del proyecto /src/main/resources.

Para más información relacionada con la configuración del registrador, consulte Configuración de la salida del registro en la documentación de Oracle.

Adición de la dependencia de Maven

Para agregar la dependencia de Maven, incluya el siguiente código XML en el archivo pom.xml del proyecto. Reemplace el número de versión 1.7.30 por el número de versión más reciente que se muestra en la página Enlace de SLF4J y 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>

Adición del archivo logging.properties al proyecto

Para registrar con java.util.logging, cree un archivo denominado logging.properties en el directorio ./src/main/resources del proyecto o en cualquier otro lugar. Este archivo contendrá las configuraciones que precisa para personalizar sus necesidades de registro. Proporcione la ruta de acceso al archivo estableciendo la propiedad del java.util.logging.config.file sistema. Debe establecer esta propiedad antes de crear la instancia del registrador. Para obtener más información, consulte Registro de Java: Configuración.

Registro de consolas

Puede crear una configuración para registrar en la consola, tal como se muestra en el ejemplo siguiente. Este ejemplo se ha configurado para registrar todos los eventos de registro que tengan el nivel INFO o superior, independientemente de su procedencia.

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

Registro en un archivo

En el ejemplo anterior se registra en la consola, que normalmente no es la ubicación preferida para los registros. Para configurar el registro en un archivo, use la siguiente configuración:

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

Este código creará un archivo llamado myapplication.log en el directorio principal (%h). Este registrador no admite la rotación de archivos automática después de un período determinado. Si necesita esta funcionalidad, deberá escribir un programador para administrar la rotación del archivo de registro.

Pasos siguientes

En este artículo se ha tratado la configuración de java.util.logging y cómo hacer que Azure SDK para Java lo use para el registro. Dado que Azure SDK para Java funciona con todos los marcos de registro de SLF4J, considere la posibilidad de revisar el manual del usuario de SLF4J para más detalles.

Después de conocer el registro, puede que le interese examinar las integraciones que ofrece Azure en marcos de trabajo como Spring y MicroProfile.