|
Como utilizar a ferramenta/biblioteca Log4j?
A plugin disponibiliza publicamente as bibliotecas log4j.jar e commons-logging-1.1.jar
criar o arquivo de configuração log4j.properties dentro do diretorio WEB-INF/classes de sua hospedagem com o seguinte conteúdo:
# Início - log4j.properties
log4j.rootLogger=INFO, LOG
log4j.appender.LOG=org.apache.log4j.RollingFileAppender
log4j.appender.LOG.layout=org.apache.log4j.PatternLayout
log4j.appender.LOG.layout.ConversionPattern=%d [%t] %p %c - %m%n
log4j.appender.LOG.File=
log4j.appender.LOG.MaxFileSize=10MB
log4j.appender.LOG.MaxBackupIndex=10
# Fim
Onde:
Appender -Destinos das mensagens de log.
Layout - Formatação das mensagens de log.
log4j.rootLogger=INFO, LOG -> Define o nível das mensagens de log e um nome para o appender, os níveis podem ser: INFO, DEBUG, WARN, ERROR, FATAL, ALL e OFF.
log4j.appender.LOG=org.apache.log4j.RollingFileAppender -> Define o appender, neste caso o appender RollingFileAppender é utilizado para rotacionar os arquivos de log. Existem vários appenders diferentes, como por exemplo SMTPAppender utilizado para enviar as mensagens de log por email.
log4j.appender.LOG.layout=org.apache.log4j.PatternLayout -> Define qual layout (formatação das mensagens) será usado, PatternLayout depende da regra abaixo.
log4j.appender.LOG.layout.ConversionPattern=%d [%t] %p %c - %m%n -> Personalização da saída das mensagens, descrição:
%d - Mostra a data e a hora em que a mensagem foi gerada.
%t - Mostra qual thread gerou a mensagem.
%p - Mostra o nível das mensagens.
%c - Mostra a classe que gerou o erro.
%m - Mostra a mensagem de log.
%n - Quebra a linha.
log4j.appender.LOG.File= = Nesta linha é indicado o caminho absoluto do arquivo de logs que serão gerados, o indicado é que o cliente crie um diretório específico para o armazenamento de seus logs, e caso nao saiba o caminho até a raiz de sua hospedagem, a nossa central de atendimento pode estar informando o mesmo.
Lembrando que após a configuração do Log da aplicação, será necessário um restart do Tomcat, que é realizado pela Plugin diariamente as 04:00.
No caso de dúvidas sobre a configuração, os links abaixo trazem uma explicação mais completa sobre o log4j
http://jakarta.apache.org/commons/logging/guide.html - Site oficial da ferramenta
https://portaljava.dev.java.net/files/documents/353/17634/log4j.pdf - Documentacao em português sobre a ferramenta
|