Manual Do Elipse Event Log (4.5.162)
Manual Do Elipse Event Log (4.5.162)
Manual Do Elipse Event Log (4.5.162)
Event Log
I
CAPÍTULO
Elipse Event Log
1
O Elipse Event Log é o sistema de logs desenvolvido pela Elipse Software, integra algumas características novas
para o usuário e está disponível para sistemas operacionais Windows 7 SP1 ou superiores. Para sistemas anteriores,
os logs continuam funcionando da mesma forma, ou seja, sendo gravados em arquivos de texto. As principais
mudanças incorporadas ao sistema referem-se:
· Ao formato e modo como os logs são gravados
· À forma de visualização dos dados
· Ao gerenciamento dos arquivos pelo sistema
NOTA
Consulte o tópico Requisitos de Instalação para verificar quais os requisitos mínimos de hardware e software para
instalação e execução das ferramentas disponíveis no Elipse Event Log.
Quanto ao formato de gravação, os arquivos não são mais armazenados apenas em texto, mas sim em um formato
binário, o que permite que mais informações sejam armazenadas por eventos. Isto permite uma série de novas
funcionalidades aplicadas sobre os dados gravados, tais como filtros, gravação de mensagens binárias, ordenamento
e pesquisa.
Já o modo de gravação é agora mais seguro e robusto. Caso haja qualquer falha em um processo, os logs são
sempre gravados em disco, o que garante que as mensagens nunca sejam perdidas. Além disto, novos modos de
gravação de arquivos foram adicionados, permitindo arquivos circulares e sequenciais, bem como serialização para
backup.
Quanto à forma de visualização dos dados, o novo sistema agora é um controle ActiveX, que pode ser inclusive
integrado a uma aplicação do E3 ou Elipse Power. Além disto, é possível exportar os eventos para um arquivo texto.
Com o novo visualizador, pode-se filtrar, procurar e selecionar mensagens específicas.
Finalmente, há o gerenciamento de arquivos, que garante a manutenção de um tamanho máximo de arquivos em
disco sem esgotamento do espaço disponível. O serviço de logs, a partir do momento em que é configurado e
iniciado, monitora constantemente a pasta de repositório, controlando os arquivos que devem ser mantidos em disco,
rotacionando os mais recentes e apagando os mais antigos.
IMPORTANTE
Estes logs são habilitados apenas por usuários pertencentes aos grupos Administrator ou Performance Log Users
do Windows. Para mais informações, consulte o tópico Restrições de Segurança.
Para utilizar o Log Viewer, selecione o item Log Viewer no menu Iniciar do Windows. A janela da figura a seguir é
aberta.
Category Fast Filter Selector Permite selecionar uma categoria para a classificação da
mensagem
As categorias disponíveis para classificação de uma mensagem estão descritas na tabela a seguir.
Categorias disponíveis para classificação de mensagens
NÚMERO CATEGORIA COR
0 (zero) Cabeçalho de log Verde
10 Erro Vermelho
12 Informação Azul
16 Trace --
A barra de status da janela principal do Log Viewer é dividida nas áreas mostradas na tabela a seguir.
Áreas da barra de status do Log Viewer
ÁREA DESCRIÇÃO
Total de Eventos Número de eventos do arquivo selecionado na área de
visualização de arquivos. Se não há nenhum arquivo
selecionado, mostra o texto "Ready". Caso haja algum
filtro ativo, o valor mostrado se refere aos eventos
visíveis após a aplicação do filtro
NOTA
Cuidado ao desabilitar o repositório com o valor 0 (zero) na opção Limit the diskspace used for storing log files
to, pois ao habilitar a opção Enable storage management, o gerenciamento deixa o repositório com um mínimo de
arquivos (por padrão de nome, pré-definido igual a 2), assim que a opção é confirmada clicando em OK ou Apply.
Automatically manage the maximum size O sistema de logs calcula o limite disponível baseado no
espaço livre da partição para o gerenciamento dos logs.
A regra para alocação de espaço no modo automático é
usar 25% (vinte e cinco por cento) do espaço livre da
partição
Limit the diskspace used for storing log files to Especifica o tamanho máximo disponível para o
arquivamento de logs em disco. Se for especificado o
tamanho 0 (zero), os arquivos de log são apagados
assim que liberados pela sessão
Minimum diskspace free to storage (MB) Determina o mínimo de espaço em disco em uma
partição para realocar os logs ou iniciar a gravação no
repositório. Este é o limite inferior de banda a ser
monitorado
Delete log files older than (days) Especifica o número de dias durante os quais os
arquivos são armazenados. Se o valor é igual a 0 (zero),
o gerenciamento é realizado por tamanho ou pelo
número mínimo de arquivos
NOTA
As rotinas citadas a seguir e o gerenciamento só ocorrem quando há necessidade de liberar arquivos, em função de
o tamanho estar próximo do limite de configuração da opção Limit the diskspace used for storing log files to.
A ordem de execução dos filtros de exclusão de arquivos do repositório está descrita a seguir.
1. Data de criação: Com a execução do gerenciamento, todos os arquivos com data de criação anterior ao máximo
permitido na opção Delete log files older than (days) são apagados começando do mais antigo para o mais
recente, desde que o tamanho dos arquivos ultrapasse a cota máxima do repositório.
2. Padrão de nome: Se mesmo após ter apagado os arquivos mais antigos do repositório, na opção Delete log
files older than (days), ainda assim o tamanho remanescente for maior do que o limite, os arquivos são
processados pelo filtro de nomes, na opção Minimum number of files. Neste filtro, os arquivos são apagados
até que o limite de controle seja atingido, mas preservando no mínimo a quantidade de arquivos configurada. Isto
é muito útil para estabelecer uma sequência na análise regressiva de eventos.
3. Tamanho total do repositório: O último filtro executado é por tamanho total do repositório. Neste caso, se ainda
depois dos filtros anteriores o repositório estiver acima do limite, os arquivos são apagados usando a ordenação
do mais antigo para o mais recente, até que se atinja o limite de segurança.
É possível remover ou acrescentar colunas clicando com o botão direito do mouse nos nomes das colunas. Apenas a
coluna Session não pode ser removida.
É possível também selecionar algumas ações que podem ser aplicadas às sessões de log, clicando com o botão
direito do mouse na respectiva linha.
Open File Folder Abre uma janela do Windows Explorer, no diretório onde
são armazenados os arquivos de log, configurado na
opção Folder da janela Storage Settings
Create New File Cria um novo arquivo de log na sessão selecionada. Este
item do menu contextual está desabilitado caso o modo
de gravação, na coluna Log Mode, ou a sessão sejam
incompatíveis com a criação de novos arquivos
A janela Running Sessions permite a operação de arrastar e soltar arquivos, tanto para a janela principal do Log
Viewer quanto para uma janela externa ao programa, como por exemplo o Windows Explorer.
No caso da janela principal do Log Viewer, o comportamento deste recurso obedece às seguintes regras:
· Se o arquivo é arrastado e solto sobre o item Merged Log Files, o arquivo é adicionado a este item
· Se o arquivo é solto em qualquer outra área da janela principal, que é o comportamento padrão, este arquivo é
adicionado ao item Opened Log Files
· Se o arquivo é arrastado para fora da janela principal do Log Viewer, cria-se uma cópia do arquivo no local de
destino
Move Previous e Move Next Permite navegar pelos eventos anteriores e posteriores
ao evento selecionado
Quando o mouse permanece por algum tempo sobre um evento, uma dica aparece mostrando a mensagem, como na
figura a seguir.
Full File Path to Clipboard Copia o caminho do arquivo selecionado para a Área de
Transferência do Windows
Match whole word only Procura pelo valor como palavra ou frase inteira, e não
como parte de outras mensagens
Após percorrer todo o arquivo, de acordo com a direção selecionada, a pesquisa é encerrada.
2.6 Filtros
Os filtros são uma opção para refinamento da visualização de eventos. No Log Viewer, existem filtros independentes,
por Mensagem ou por Tempo.
Show messages using the following criteria Edita os scripts dos filtros selecionados
Ao clicar em Help, é mostrada uma janela com a sintaxe correta para cada palavra-chave válida, conforme a figura a
seguir.
Isto significa que apenas são exibidos eventos que satisfaçam a seguinte equação lógica equivalente:
(Process == 0x12B8) AND Module == SYSTEM
Para ligar o filtro, clique em Toggle Filter On/Off na barra de ferramentas. Para o filtro do exemplo anterior, o
resultado é semelhante ao mostrado na figura a seguir.
Sempre que a data e a hora finais forem anteriores à data e à hora iniciais, ou que o intervalo de tempo final é
anterior ao inicial, o filtro é automaticamente desabilitado.
No filtro Por Tempo, a hora inicial é incluída, mas a final é excluída, ou seja, um filtro entre 09:30:47 e 09:35:47 mostra
apenas os eventos até o segundo 46. Logo, não é permitido um filtro Por Tempo com data e hora iguais.
Note que, embora seja possível selecionar as horas inicial e final através do número da mensagem, os milissegundos
do intervalo são zerados. Por isto, ao selecionar um determinado segundo inicial, são listados todos os seus eventos
desde o primeiro milissegundo.
Para ligar o filtro, clique em Toggle Filter On/Off na barra de ferramentas. O resultado é semelhante ao mostrado
na figura a seguir, para mensagens no intervalo entre 2020-01-17 08:07:02 e 2020-01-17 08:15:02.
2.7 Bookmarks
Os Bookmarks são tags que podem ser associados a um ou mais eventos em um arquivo. Na área de visualização de
eventos há uma coluna chamada Bookmarks que mostra quais eventos possuem um bookmark associado. Nestes
casos o ícone é colocado ao lado do ID de um evento.
Todas as operações realizadas nesta janela são aplicadas instantaneamente. Clicando com o botão direito do mouse
em um evento, é mostrado um menu contextual com as opções mostradas na figura a seguir.
Add Bookmark Abre uma janela para solicitar um nome para o bookmark
e adiciona-o a todos os eventos selecionados
Process and Thread as Hexadecimal Permite selecionar se a visualização das colunas Process
e Thread é em formato hexadecimal (padrão) ou
decimal. Esta opção é persistida por usuário e é usada
também na exportação de eventos
Destination path (will be created if does not exist) Determina a pasta de destino da exportação. Este
diretório é criado se não existir. Se nenhum diretório é
especificado, o diretório dos arquivos de log é utilizado
Add event field names Os eventos são exportados no modo mais completo,
contendo o nome e o valor do evento. O valor padrão
desta opção é selecionado
Print Process ID and Thread ID as Hexadecimal Permite selecionar se as colunas Process e Thread são
exportadas em formato hexadecimal ou decimal. O valor
padrão desta opção é selecionado
Quando mais de um arquivo é selecionado para exportação, o nome do arquivo é ProcessedEvents.log. Quando
apenas um arquivo é selecionado para exportação, o nome do arquivo se mantém o mesmo, apenas sua extensão é
modificada para .log.
Após configurar esta opção, clique em Export. A janela da figura a seguir é aberta quando a exportação dos eventos
iniciar.
NOTA
Alguns dos comandos a seguir devem ser executados com privilégios elevados, utilizando a opção Executar como
Administrador (Run as Administrator) do menu contextual do Elipse Event Log Export.
NOTA
A partir da versão 4.5 build 60 do Elipse Event Log Collector, é necessária a instalação do Elipse Event Log Tools.
Include files in sub-directories Indica se a coleta deve ser realizada buscando arquivos
nos subdiretórios
File extension filter Informa qual a extensão dos arquivos que devem ser
coletados
Ao coletar arquivos com extensão .etl (Elipse Trace Logs) que estejam em uso, o programa realiza automaticamente a
descarga dos eventos que estão em memória (flush dos buffers de eventos), evitando que informações sejam
perdidas.
A descarga dos eventos em memória para o disco só acontece quando os arquivos a serem coletados estão no
mesmo computador em que se executa o Elipse Event Log Collector. Coletas executadas em computadores remotos
não têm como efetuar a descarga de eventos no outro computador, apesar de coletarem os arquivos gravados em
disco. O arquivo de saída gerado sempre tem o nome CollectedLogs.ezp. Ao iniciar uma nova coleta, se já existia um
arquivo anterior no mesmo diretório de saída com o nome CollectedLogs.ezp, este arquivo é apagado e um novo é
criado.
Se a unidade de disco onde é gerado o arquivo CollectedLogs.ezp tem espaço livre menor ou igual a 5 MB, o coletor
não inicia a coleta. Se a coleta já foi iniciada, esta para no momento em que este limite é atingido.
Se a opção Send by e-mail to é selecionada, ao final da coleta é aberta uma janela para que o e-mail seja enviado. O
arquivo coletado é adicionado como um anexo.
Se não há clientes de e-mail configurados ou compatíveis, ou se ocorreu algum outro erro com a preparação da
mensagem, o arquivo não é enviado. Neste caso, o usuário deve enviar o arquivo manualmente utilizando seu cliente
de e-mail ou webmail. Dependendo do tamanho do arquivo gerado, pode ser necessário enviar via mídia física, como
CD ou DVD, à Elipse Software.
NOTA
Para que o Elipse Event Log Collector abra uma mensagem de envio de e-mail, o usuário deve ter na máquina um
cliente de e-mail compatível com o Microsoft Simple MAPI (Microsoft Simple Message API), protocolo usado pelo
coletor para criar a chamada do cliente de e-mail que gera a mensagem.
Qualquer erro devido à configuração das opções de pesquisa, direitos de acesso às pastas de saída ou de entrada,
espaço em disco livre insuficiente (menor do que 5 MB), usuário abortar o processo de coleta ou algum outro erro,
impede que o arquivo final CollectedLog.ezp seja gerado.
Enquanto a coleta é executada e o arquivo de saída está sendo gerado, este possui adicionado ao seu nome o sufixo
__tmp, portanto tendo o nome de CollectedLogs.ezp__tmp. Este arquivo é renomeado ao final da coleta para
CollectedLogs.ezp.
Se foi selecionada a opção de enviar por e-mail, é mostrada uma mensagem perguntando se a lista de arquivos
coletados deve ser mostrada antes de enviá-la.
Restrições de Segurança 28
Matriz Filial em São Paulo
Rua Mostardeiro, 322/Cj. 902, 1001 e 1002 Rua dos Pinheiros, 870/Cj. 141 e 142
90430-000 — Porto Alegre — RS 05422-001 — São Paulo — SP
Fone: (+55 51) 3346-4699 Fone: (+55 11) 3061-2828
Fax: (+55 51) 3222-6226 Fax:(+55 11) 3086-2338
E-mail: [email protected] E-mail: [email protected]
www.elipse.com.br
kb.elipse.com.br
forum.elipse.com.br
www.youtube.com/elipsesoftware
[email protected]