Registrar em log com o SDK do Azure para Java e o java.util.logging

Este artigo apresenta uma visão geral de como adicionar o registro em log usando o java.util.logging a aplicativos que usam o SDK do Azure para Java. A estrutura do java.util.logging faz parte do JDK. Conforme mencionado em Configurar o registro em log no SDK do Azure para Java, todas as bibliotecas de clientes do Azure fazem logon por meio de SLF4J, de modo que você pode usar estruturas de registro em log como java.util.logging.

Para habilitar o java.util.logging, você deve fazer duas coisas:

1. incluir o adaptador SLF4J para java.util.logging como uma dependência; e
2. criar um arquivo chamado log.properties no diretório do projeto /src/main/resources.

Para obter mais informações relacionadas à configuração de seu agente, confira Configurar a saída de registro em log na documentação do Oracle.

Adicionar a dependência do Maven

Para adicionar a dependência do Maven, inclua o XML a seguir no arquivo pom.xml do projeto. Substitua o número de versão 1.7.30 pelo número de versão de lançamento mais recente mostrado na página de associação JDK14 do SLF4J.

<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>

Adicionar logging.properties ao seu projeto

Para registrar em log usando java.util.loggingo , crie um arquivo chamado logging.properties no diretório ./src/main/resources do seu projeto ou em qualquer outro lugar. Esse arquivo conterá as configurações de log para personalizar suas necessidades de registro em log. Forneça o caminho para o arquivo definindo a java.util.logging.config.file propriedade system. Você deve definir essa propriedade antes de criar a instância do registrador. Para obter mais informações, consulte Java Logging: Configuration.

Log de console

Você pode criar uma configuração para registrar em log no console conforme mostra o exemplo a seguir. Este exemplo é configurado para registrar em log todos os eventos de log que estão no nível INFO ou superior, não importa a origem.

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

Registrar em log em um arquivo

O exemplo anterior registra em log no console, que normalmente não é a localização preferida para os logs. Para configurar o registro em log em um arquivo, use a seguinte configuração:

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

Esse código criará um arquivo chamado myapplication.log no diretório base (%h). Esse agente de log não dá suporte à rotação automática de arquivo após um determinado período. Se você precisar dessa funcionalidade, será necessário escrever um agendador para gerenciar a rotação do arquivo de log.

Próximas etapas

Este artigo abordou a configuração do java.util.logging e como fazer o SDK do Azure Java usá-lo para registro em log. Como o SDK do Azure para Java funciona com todas as estruturas de registro em log do SLF4J, considere examinar o manual do usuário do SLF4J para obter mais detalhes.

Depois de ter feito o registro em log mestre, considere as integrações que o Azure oferece em estruturas como Spring e MicroProfile.