LumisLogConfig
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 de instalaçã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 LumisXP.
Suporte ao MDC no log
O LumisXP 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:
| 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.