Índice

Introdução

...

Em alguns casos, para obter mais informações sobre um determinado erro, pode ser necessário ativar um log mais detalhado.

Como funciona?

...

As configurações de log são  são realizadas por instalação da plataforma e são definidas no arquivo standalone'domain.xml localizado ' localizado em [Instalação fluig]/appserver/standalonedomain/configuration.

A configuração de log consiste basicamente em dois tipos de itens: 'handlers' e 'loggers'.

O 'handler é ' é responsável pela forma de processamento/armazenamento dos registros de log, enquanto o 'logger' é responsável por definir o nível de um pacote específico e por quais handlers este qual(is) 'handler(s)' este pacote será tratado.

...

...

Por exemplo, o 'handler' do arquivo de log padrão da plataforma (server.log) possui a seguinte configuração:

<periodic-rotating-file-handler autoflush="true" name="FILE">
    <formatter>
        <named-formatter name="PATTERN"/>
    </formatter>
    <file path="server.log" relative-to="jboss.server.log.dir"/>
    <suffix value=".yyyy-MM-dd"/>
    <append value="true"/>
    <level name="INFO"/>
</periodic-rotating-file-handler>

Basicamente , esta configuração define que o arquivo de de log definido na propriedade <file> (server.log), será rotacionado no final de cada dia, ou seja, o conteúdo que estava no arquivo será salvo em outro arquivo contendo a data como sufixo, seguindo o padrão definido na propriedade <suffix> e , e o arquivo original será zerado para registrar as próximas mensagens. 

É importante verificar que a propriedade <level> deste  deste 'handler' possui, por padrão, o valor "'INFO"'. Isso significa que este 'handler' irá registrar apenas mensagens de nível "INFO" ou superior. Sendo assim, mesmo que existam pacotes enviando mensagens em nível de 'DEBUG', eles não serão registrados, pois 'DEBUG' é um nível mais baixo que 'INFO'. Caso deseje visualizar mensagens em nível de 'DEBUG' no arquivo 'server.log', é necessário primeiramente alterar a configuração de '<level name="INFO"/>' para '<level name="DEBUG"/>'.

Os níveis de log seguem a seguinte ordem, sendo do nível mais baixo ao mais alto:

...

Exemplo: se um 'handler' for definido com level igual a 'INFO', irá registrar apenas mensagens de nível 'INFO', 'WARN', 'WARNING', 'ERROR', 'SEVERE' e 'FATAL'. Além dos níveis acima, também pode ser configurado o nível 'OFF', nos casos em que nenhuma mensagem deve ser registrada.

Cada configuração de 'logger está ' está atrelada a à um ou mais 'handlers'. Quando esta informação não é configurada na declaração de um 'logger', é considerada a configuração realizada para o 'root-logger que', que no caso do Fluig, fluig possui a configuração abaixo:

<root-logger>
    <level name="INFO"/>
    <handlers>
        <handler name="CONSOLE"/>
        <handler name="FILE"/>
        <handler name="USERLOGGING"/>
    </handlers>
</root-logger>

Neste caso, todos os 'loggers' que não definirem um 'handler' específico, serão processados por estes três 'handlers: CONSOLE' (caso seja iniciado via script no terminal do sistema operacional), 'FILE' (arquivo server.log) e 'USERLOGGING' (ver ver aqui).

A configuração de um 'logger' normalmente é feita conforme abaixo:

<logger category="io.undertow.request">
    <level name="FATAL"/>
</logger>

• O parâmetro 'category' indica o pacote ou o nome completo da classe que este 'logger está ' está configurando.
• O parâmetro 'level indica ' indica o nível mínimo das mensagens que serão apresentadas para esta categoria (pacote ou classe). Neste caso, as mensagens de log enviadas pelo pacote 'io.undertow.request serão ' serão registradas apenas se forem do nível 'FATAL'.

Configuração via interface de gerenciamento do servidor de aplicação

A seguir são descritos os passos necessários para criar um usuário de gerenciamento do servidor de aplicação e para adicionar uma classe ou pacote.

...

Usuário do

...

Servidor de

...

Aplicação

Caso não possua um usuário de gerenciamento do servidor de aplicação, é necessário criá-lo:01. No

1. No prompt de comando do Windows ou no console do Linux, navegue até o diretório bin

...

1.  do servidor de aplicação ([Instalação do fluig]/appserver/bin)

...

1. ;

...

1. Executar o

...

1. script add-user.bat ou add-user.sh

...

1. ;

...

1. Na primeira pergunta exibida, apenas

...

1. dê ENTER

...

1. ;

...

1. Informe o nome do usuário

...

1.  na segunda pergunta

...

1. ;

...

1. Escolha

...

1. uma senha

...

1.  e digite-a na terceira e quarta perguntas

...

1. ;

...

1. Após a confirmação da senha,

...

1. efetue um ENTER

...

1.  na quinta pergunta

...

1. ;

...

1. Na

...

1. sexta e sétima perguntas é necessário digitar "Sim" (

...

1. ou "Yes", se o console estiver em inglês) e confirmar com a tecla 

...

1. Enter. 

Adicionando Classe ou

...

Pacote 

...

1. Acesse http://[IP ou hostname]:9990 e informe o usuário e senha

...

1.  criados no passo anterior

...

1. ;

...

1. Acesse Configuration → Profiles → full → 

...

1. Logging → View

...

1. ;

...

1. Na tela de log, acesse a

...

1. aba Log Categories

...

1. ;

...

1. Clique

...

1. em Add

...

1. ;

...

1. Em name

...

1.  informe o pacote ou classe a ser monitorada (Ex.: com.datasul.technology.webdesk.workflow.engine )

...

1. ;

...

1. Defina a

...

1. opção Debug no Level, selecione a opção 'Use parent handlers' e Salve

...

1. ;

Veja abaixo um exemplo dos procedimentos citados acima, sendo eles: criando 'Usuário do servidor de aplicação' e 'Adicionando Classe ou Pacote':

Image Modified

Visualizando o

...

Log de

...

Debug

...

Após realizada as configurações, o log pode ser monitorado a partir do arquivo [Instalação fluig]/appserver/domain/servers/standalonefluig1/log/server.log.

Use uma das ferramentas de análise recomendadas para visualizar o arquivo ou, caso o sistema operacional seja Linux, é possível usar o comando:

...

...

...

...

...