A parte de configuração de log no Java tem uma história que pode parecer um pouco confusa no início.
A opção de log que vem por padrão com o Java está no pacote java.util.logging
. Você pode usá-la simplesmente fazendo:
private static final Logger LOGGER = Logger.getLogger(ClassName.class.getName());
Ele fornece vários tipos de níveis de log. Como exemplo, ao capturar uma exceção:
try {
// codigo com erro
} catch( Exception ex ) {
LOGGER.log(Level.SEVERE, ex.toString(), ex);
}
Contudo, esta implementação do Java tinha suas limitações quando foi lançada. Isto abriu espaço para outras alternativas emergirem.
Assim surgiu o The Simple Logging Facade for Java (SLF4J). Ele cria uma abstração para diferentes implementações de log do Java, tais como java.util.logging, logback and log4j.
Com o SLF4J, você pode usá-lo no seu código da seguinte maneira:
private static final Logger LOGGER = LoggerFactory.getLogger(ClassName.class);
Exemplo:
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class HelloWorld {
public static void main(String[] args) {
Logger logger = LoggerFactory.getLogger(HelloWorld.class);
logger.info("Hello World");
}
}
E depois determinar qual a implementação de log que deseja, adicionando a biblioteca desejada no classpath da sua aplicação. A opção mais comum atualmente parece ser o Logback.
Em um projeto "normal", estas bibliotecas são adicionadas usando Maven ou Gradle. No Maven, você pode adicionar o Logback da seguinte maneira:
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.2.3</version>
</dependency>
Que ele trará logback-core (implementação) e slf4j-api (interface) ao seu projeto.
Como fazer um bom log para produção?
Em ambiente de produção nem sempre podemos contar com o acompanhamento detalhado da execução dos processos internos. Porém, o bom uso do log pode nos trazer quase todas as informações que precisamos para diagnosticar problemas.
Existem várias dicas para isto. Alguns pontos importantes a se observar:
- Não logar várias vezes o mesmo erro. Isto gera muita confusão ao tentar entender a origem do erro e distinguir um erro do outro.
- Procure logar várias informações do que está ocorrendo nas etapas importantes dos principais processos da sua aplicação. Isto te ajudará muito a compreender quais dados estão sendo usados e por quais caminhos do seu software eles estão passando.
- Colocar o nível de severidade correto do log. Para informações que possam ser úteis para quem está vendo o log, como acompanhar a execução de determinado item, usar
INFO
. Para avisos que podem ser importantes, usar WARN
. Para casos de erro, usar ERROR
.
- Não logar informações sensíveis ou pessoais (CPF, e-mail, etc) sem, no mínimo, mascarar a informação. A LGPD entra em vigor em 2020 e temos que ter cuidado com as informações do usuário.
NullPointerException
, por exemplo. Qualquer coisa você pode criar um arquivo.txt
para gravar os erros.