LumisLogConfig

Top Previous Next

As informações de log são registradas em arquivos textos e seguem o padrão do W3C Extended.

As configurações desses arquivos estão definidas no arquivo lumisdata/config/lumislogconfig.xml que por sua vez segue o padrão“log4j” que pode ser encontrado em http://logging.apache.org/log4j/docs/documentation.html.

Para facilitar, pode-se utilizar a variável ${lumisdata} dentro do valor de qualquer parâmetro. Esta variável retorna o diretório desinstalação relativo ao lumisdata, não necessitando explicitá-lo.

Dentre várias configurações disponíveis no lumislogconfig, uma delas é a possibilidade de receber por e-mail, os logs gerados para determinado nível. Tal configuração está disponível na tag <appender name="SMTP" class="org.apache.log4j.net.SMTPAppender"> .

Quando não especificado, o log4j's SMTPAppender aceita apenas log com nível error ou maior (fatal ).

Alguns tipos de log disponíveis:

•	debug: Detalha a informação sobre o fluxo do sistema que são úteis para o debug da aplicação;

•	trace: Traz informações mais refinadas sobre o fluxo do sistema, que as disponíveis pelo nível debug;

•	info: Traz informações do progresso da aplicação;

•	warn: Traz informações sobre potenciais situações que podem comprometer o sistema;

•	error: Traz informações de erros, mas que permitem que a aplicação continue rodando;

•	fatal:Traz informações de erros que fazem a aplicação abortar.

Por default, os logs gerados pelo portal estão configurados para debug, exceto para log de serialização.

Consultar a seção Logs do Portal para visualizar os arquivos gerados pelo Lumis Portal.

Suporte ao MDC no log

O Lumis Portal provê suporte ao MDC (http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/MDC.html) nativamente.

A configuração e integração do MDC com o Apache Log4J, dá-se, através da classe de layout PatternLayout, que já possui um caracter de conversão específico para acessar as variáveis contidas no MDC.

Para acessar as variáveis disponíveis no MDC, deve-se incluir no padrão de conversão o caracter 'X', como a seguir:

%X{<nome da variável desejada>}

Variáveis Disponibilizadas:	Descrição:
lumis.user.login	Login do usuário.
lumis.user.groups	Grupos do usuário autenticado.
lumis.user.locale	Língua do usuário atual.
lumis.request.client.ip	IP do request do cliente.
lumis.website	Website do request atual.
lumis.server.id	Identificador do servidor.
lumis.channel.path	Caminho real do canal atual.
lumis.page.name	Nome da página atual.
lumis.si.name	Nome da instância de serviço atual.

Soluções customizadas podem adicionar variáveis customizadas ao MDC. Essa adição pode ser feita de duas formas:

•	Diretamente pela API MDC do Apache Log4J: Dessa forma, a variável passa a estar disponível para o Log4J através do MDC. Porém, a mesma não estará disponível para as coletas de monitoramento pelo contexto de monitoramento;

•	Pela API de monitoramento do portal: Dessa forma a variável fica disponível tanto no contexto de monitoramento quanto para o Log4J, através do MDC.