Âncora
apresentacao apresentacao

Apresentação

O TOTVS Monitor é uma ferramenta de monitoramento do produto Datasul 11 onde é possível verificar informações de acessos ao produto, através de dados tabulares, gráficos interativos e contadores em tempo-real. A ferramenta é dividida em cinco visões diferentes, sendo elas:

1. Usuários *
   Permite a visualização dos usuários conectados e dos programas em execução por estes usuários.
2. Execuções *
   Permite a visualização dos programas em execução (conforme parametrização do item Como habilitar a visualização dos programas em execução) com execução com os respectivos usuários responsáveis pela execução e, se disponíveldisponíveis, informações de estatísticas das tabelas acessadas por cada programa em execução.
   
3. Histórico *
   Permite a visualização dos programas de execuções já encerrados encerradas com os respectivos usuários responsáveis pela execução e, se disponíveldisponíveis, informações de estatísticas das tabelas acessadas por cada programa em execução. Nesta visão é É possível visualizar os programas executados nos as execuções dos últimos três ou sete dias e no do último mês ou ano.
4. Bloqueios
   Permite a visualização das tabelas que estão bloqueadas e o respectivo usuário que a bloqueou.
5. Logs ¹
   Permite a visualização centralizada de logs do produto (necessitam estar em local acessível via rede) e situação atual dos servidores de execução RPW.
6. Configurações
   Permite ligar ou desligar a leitura e gravação das estatísticas de tabelas durante as execuções dos programas.

Image Added

Ao acessar o TOTVS Monitor será possível visualizar alguns gráficos com informações referentes ao consumo de memória da Java Virtual Machine, aos acessos diários e da média de acessos por hora. Estes gráficos encontram-se agrupados, bastando clicar nas setas para alternar a visualização dos gráficos.sua visualização.

1. Utilização de memória
   A cada 30 segundos realiza a análise do estado atual da memória da JVM.
   
   Image Added
   
   
2. Gráfico de acessos diários
   Este gráfico permite visualizar a quantidade de execuções diárias do mês e ano correntes.
   
   Image Modified
   
   
   
3. Gráficos de média de acessos por hora
   Este gráfico permite visualizar a média de acessos por hora do mês e ano correntes.
   
   Image Modified

Ainda na página principal, é possível visualizar dois contadores (atualizados em tempo-realsob solicitação) com a quantidade de usuários conectados e com a quantidade de programas em execução, além de mais dois gráficos contendo as tabelas e os programas mais utilizados no produto.

Esta ferramenta

Âncora
usuarios usuarios

Usuários

Na visão de usuários será possível visualizar todos os usuários conectados ao produto e os programas em execução por cada um destes usuários, além de outras informações como:

• Empresa da qual o usuário conectou-se.
• Nome da máquina.
• e IP de cada usuário conectado.
• Nome do servidor.
• Data, hora e tempo de conexão de cada usuário conectado.

Image Added

Para visualizar quais programas estão em execução com o usuário selecionado, clique no link Atualizar programas em execução.

Image Added

Âncora
execucoes execucoes

Execuções

Na visão de execuções será possível visualizar todos os programas em execução no produto e, se disponíveis, as estatísticas das tabelas acessadas por cada um destes programas, além de outras informações como:

• O usuário responsável pela execução do programa.
• Código do programa.
• Data e hora de conexão.
• Nome da máquina.
• IP do programa em execução.
• Nome do servidor.
• Exclusão de programas já finalizados mas ainda encontra-se exibido como se estivesse em execução.

Image Added

Nesta visão é possível remover programas "perdidos" (que encontram-se finalizados, porém são exibidos como se ainda estivessem em execução). Esta situação normalmente é encontrada no encerramento inadequado de uma sessão (encerramento do navegador inesperadamente, por exemplo). Para isto clique no botão com o ícone de uma lixeira e será exibida a mensagem para confirmar a ação. Esta ação irá remover o programa da lista de execuções atual, porém não irá finalizar o programa caso o mesmo encontra-se ainda em execução.

Image Added

Para visualizar as estatísticas das tabelas acessadas pelo programa selecionado, clique no link Atualizar estatísticas desta execução (caso não sejam exibidos resultados, verifique o item Configurações).

Image Added

Âncora
historico historico

Histórico

Na visão de histórico será possível visualizar o histórico de execuções dos programas já encerrados e, se disponíveis, as estatísticas das tabelas acessadas por cada um destes programas, além de outras informações como:

• O usuário responsável pela execução do programa.
• Nome da máquina e IP de cada programa em execução.
• Nome do servidor.
• Data, hora e tempo de conexão de cada programa em execução.
• Histórico de execuções dos últimos três ou sete dias, mês e ano.

Image Added

Ao entrar na visão de histórico, são exibidas as execuções dos últimos 3 dias, para visualizar outros períodos, selecione-o no botão Histórico. Ao selecionar um período muito longo, são exibidas as 50 primeiras execuções, caso houver mais, o resultado é dividido entre páginas.

Image Added

Para visualizar as estatísticas das tabelas acessadas pelo programa selecionado, clique no link Atualizar estatísticas desta execução  (caso não sejam exibidos resultados, verifique o item Configurações).

Image Added

Âncora
bloqueios bloqueios

Bloqueios

Na visão de bloqueios é possível visualizar todas as tabelas bloqueadas no produto e o usuários responsável por cada um destes bloqueios, além de outras informações como:

• Nome do banco de dados e da tabela bloqueada
• Tipo do bloqueio
• Número do registro bloqueado

Image Added

Informações
A atualização dos bloqueios de tabelas pode demorar alguns minutos.

Âncora
logs logs

Logs

Na visão centralizada de logs é possível analisar as execuções dos recursos do produto visando identificar erros ou pontos críticos do produto. Nesta visão é possível verificar as informações dos logs do JBoss, AppServer e WebSpeed que devem ter seus caminhos configurados e é necessário que, para que as saídas necessárias para análise do log sejam realizadas, seja habilitada as saídas do log de execução na visão Configurações. Informações apresentadas nessa visão:

Image Added

• Recurso executado (método Java ou procedure Progress)
• Usuário executor (obs: WebSpeed não provê essa informação)
• Data da execução (a ordenação da tabela é realizada inicialmente por este campo em ordem decrescente)
• Duração em segundos da execução
• Data de término da execução
• Informações de memória da JVM
• Informações da execução no AppServer ao clicar em Carregar detalhes do log do AppServer quando tratar-se de recurso Java com utilização de AppServer (ex: metadados)
  
  

Image Added

Image Added

A listagem dos recursos executados podem ser apresentadas consolidadas ou filtradas pela sua origem (JBoss, AppServer ou WebSpeed). Também é possível filtrar as ocorrências para que seja apresentado somente as últimas 24h, 48h, 72h ou última semana.

Já na listagem dos servidores de execução é possível visualizar os servidores disponíveis e seus respectivos estados que podem ser Ativo, Inativo ou Bloqueado. Detalhando um servidor é possível visualizar outras informações como número de pedidos na fila e número do pedido em execução.

Âncora
configuracoes configuracoes

Configurações

Nesta visão é possível habilitar a leitura e gravação das estatísticas de tabelas durante as execuções dos programas, possibilitando a visão destas estatísticas na visão de Execuções e Histórico.

Image Added

Ao ligar este parâmetro (Habilita a leitura e gravação das estatísticas de tabelas?) tenha em mente que serão realizadas diversas leituras nas tabelas de sistema do banco de dados e inserções nas tabelas de histórico de execução, o que poderá ocasionar diretamente a performance nas execuções dos programas no produto.

Image Added

Ao habilitar as saídas do log de execução serão gerados no log do JBoss e do AppServer informações pertinentes a visão Logs para análise das execuções. Nos campos da seção "Caminhos dos logs" são informados os arquivos de log de cada uma das tecnologias (JBoss, AppServer e WebSpeed) que será utilizado na visão centralizada de logs para análise. Obs: as saídas de log do JBoss são de nível INFO, não sendo então geradas caso o nível do log do JBoss esteja com nível ERROR, onde sugerimos a criação de um novo appender.

Informações
title Sugestão
Caso deseje-se habilitar as saídas do log de execução, sugerimos criar um appender no log do JBoss específico para estas saídas. No diretório conf da instância do JBoss encontra-se do arquivo jboss-log4j.xml, onde encontra-se a configuração responsável para os registros das saídas de log. Neste arquivo, sugere-se criar um appender a exemplo de: <appender name="MONITOR" class="org.jboss.logging.appender.RollingFileAppender"> <errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/> <param name="File" value="${jboss.server.log.dir}/monitor.log"/> <param name="Append" value="true"/> <param name="MaxFileSize" value="100MB"/> <layout class="org.apache.log4j.PatternLayout"> <param name="ConversionPattern" value="%d %-5p [%c] %m%n"/> </layout> </appender> Criado o novo appender, é necessário criar uma nova categoria de log para que as saídas correspondentes ao log de execução utilizado para análise das execuções (é obrigatório a inclusão da nova categoria exatamente conforme abaixo, com exceção do nome do appender que deve corresponder ao appender criado): <logger name="TOTVSMonitor" additivity="false"> <level value="debug"/> <appender-ref ref="MONITOR"/> </logger>

Âncora
hab_vis_execucao hab_vis_execucao

Habilitando a visualização de programas em execução

Para que seja possível visualizar os programas em execução é necessário habilitar o LOG de execução de cada programa que deseja-se monitorar. Esta opção está disponível em Manutenção de Programas no campo Log Exec.

Image Added