O objetivo deste guia é auxiliar o suporte e desenvolvedores da plataforma a ativar o controle de log por usuário. Os tópicos a seguir irão demonstrar como ativar essas mensagens e farão uma breve descrição do seu funcionamento.
A ativação deste recurso somente pode ser feita por usuários administradores, selecionando individualmente os usuários dos quais as ações devem ser registradas em um arquivo de log separado.
O log de usuário tem por objetivo registrar as ações executadas por determinados usuários, com a finalidade de auxiliar no diagnóstico de situações que estejam prejudicando o uso da plataforma.
Para ativar a geração de logs das ações de um determinado usuário na plataforma em um arquivo de log separado, é necessário acessar o Painel de Controle, aba Gerais, na opção Controle de Log.
A partir desta tela é possível selecionar quais usuários terão este recurso ativo, bem como o período que este permanecerá ativo, que pode ser de até 7 dias corridos. Este período corresponde ao tempo que as ações do usuário serão registradas em um arquivo de log específico à partir do próximo login, sendo que, uma vez registradas, permanecerão no arquivo até que o mesmo seja removido ou alterado manualmente.
Este arquivo ficará na pasta configurada para persistência dos logs (por padrão em <fluig>/appserver/domain/servers/<servername>/log/user-logging/<login>.log). A limpeza deste arquivo não é feita de forma automática, para permitir a avaliação das informações mesmo após o período de ativação. Para facilitar a análise, no início de cada registro é informada a data e a hora, no formato "yyyy-MM-dd HH:mm:ss,SSS".
Além disso, esta página também permite efetuar o download do arquivo "server.log" através da opção Baixar log do servidor, e filtrar pelo nome dos usuários ou pelos usuários que possuem o controle de log ativo.
Se o usuário já estiver autenticado na plataforma, a ativação não terá efeito até o próximo login. Nesse caso pode-se solicitar que o mesmo efetue logoff e login novamente. |
O recurso de controle de log de usuário - quando em um ambiente de alta disponibilidade - tem seu acesso com usuário de perfil administrador. Para que este funcione adequadamente em ambientes com múltiplas instâncias, é necessário que ambos os acessos (usuário e administrador) sejam executados diretamente de um dos servidores, e não pelo endereço de balanceamento de carga (load balancer).
Exemplo
E que o Servidor 02 seja escolhido como controle de log para o usuário João Carlos, sendo assim: