Explorando a Central de Diagnóstico Protheus: Uma Nova Abordagem para Monitoramento e Diagnóstico Eficiente

Descubra a Central de Diagnóstico Protheus, uma poderosa ferramenta que consolida dados sobre o ambiente Protheus, simplificando o gerenciamento e garantindo a otimização do software. Este guia abrangente destaca as características inovadoras dessa central, representando uma evolução da antiga tela de ‘Diagnóstico’ para uma abordagem mais clara e abrangente.

Pré-Requisitos

Antes de explorar a Central de Diagnóstico, certifique-se de ter os seguintes pré-requisitos:

• Central de Atualizações versão 2.0.0 ou superiores.
• Appserver versões 20.3.2.0 ou superiores.
• Dbaccess versões 22.1.1.5 ou superiores.
• LIB versão 20230807.

Configuração adicional

Chave App_Environment configurada na sessão GENERAL do appserver.ini. Seção – [General] – Chave App_Environment.

Exemplo:

[GENERAL]

app_environment=environment

Esta funcionalidade está disponível a partir do release 12.1.2310 ou superiores.

 

Como acessar a Central de Diagnóstico?

Acesse a Central de Diagnóstico utilizando o atalho Shift + F6, uma alternativa avançada à antiga tela de diagnóstico.

Ao tentar acessar a rotina da Central de Diagnóstico, será verificada a presença de todos os pré-requisitos no ambiente. Caso algum artefato do pré-requisito esteja ausente, a tela antiga do Shift + F6 será automaticamente aberta.

Funcionalidades

Explore as funcionalidades inovadoras da Central de Diagnóstico para uma visão abrangente do ambiente Protheus:

1. Monitoramento e atualização de artefatos:

• Centraliza informações sobre Appserver, Smartclient e Dbaccess.
• Apresenta a conformidade com a última versão homologada, assegurando a saúde do ambiente.

2. Gerenciamento de parâmetros de rotina:

• Visualização completa e edição direta dos parâmetros associados a uma rotina.
• Flexibilidade e agilidade na manutenção de rotinas conforme as necessidades.

3. Monitoramento e gerenciamento de pontos de entrada:

• Lista abrangente de pontos de entrada, indicando status de compilação e atividade.
• Desativação direta na interface online para controle preciso.

4. Monitoramento de consumo de hardware:

• Análise detalhada do consumo de CPU e memória do servidor.
• Identificação precoce de possíveis gargalos para garantir operação eficiente.

5. Integração com CAROL:

• Inovação na integração com a inteligência artificial de suporte, CAROL.
• Acione a CAROL para assistência em tempo real, aumentando eficiência e produtividade.

A Central de Diagnóstico vai além do monitoramento, sendo um centro de controle que capacita os usuários a tomar ações imediatas e manter o Protheus em pleno funcionamento.

Informações atuais

Acesse detalhes cruciais na tela de “Informações Atuais”:

 

 

 

 

 

 

 

 

1. Informações do Usuário:

• Código, usuário, nome completo e e-mail associado.
• 1 Papel de Trabalho: Detalhes do papel de trabalho atribuído, se aplicável.

2. Recursos do Sistema:

• Menu Funcional
• Painel Online
• Browser de Internet
• Painel Transparente
• Navegador Interno para o Smart View
• Refresh no Browse
• Detalhes do Browse
• Extrato das Informações

3. Informações de Ambiente:

• Ambiente atual do Protheus
• Release do RPO e Release do Dicionário
• Tipo de dicionário e local de arquivos

4. Dicionário de Dados:

• Lista de tabelas no dicionário de dados com descrições e avaliações de desempenho.
• Atenção: Alerta sobre a possível duração da avaliação de desempenho.

5. Status de Atualizações:

• 1 Central de Atualizações: Estado atualizado ou não.
• 2 Rotina: Nome, status de atualização (Atualizado/Desatualizado/Não configurado) e módulo.
• 3 Módulo: Status de atualização (Atualizado/Desatualizado/Não configurado).

6. Informações do Smartclient:

• 1 Smartclient: Versão atual e status de atualização.
• 2 Broker Proxy: Estado habilitado ou desabilitado.

7. Informações da Lib:

• 1 Versão da Lib: Versão atual da biblioteca.
• 2 Commit ID: Identificador específico do código LIB.

8. Informações do AppServer:

• 1 AppServer – Build: Versão de build do AppServer.
• 2 AppServer – Versão: Versão específica do AppServer.
• 3 Porta Conexão: Número da porta TCP de conexão.

 

9. Informações do DBAccess:

• 1 DBAccess 4.2 Server Started – Build: Versão de build do DBAccess.
• 2 Versão MultiDB: Detalhes sobre a versão “STANDALONE MultiDB”.

Explore cada seção para garantir um ambiente Protheus otimizado e atualizado.

Parâmetros

Explore a aba de parâmetros, uma funcionalidade essencial para fornecer uma visão completa e detalhada dos parâmetros associados a rotinas específicas. Descubra como esta ferramenta permite não apenas a consulta, mas também a manutenção dos parâmetros para atender às necessidades operacionais, impactando diretamente o desempenho das rotinas no ambiente Protheus.

 

 

 

 

 

 

 

 

Conteúdo da Tabela de Parâmetros:

Saiba quais parâmetros serão listados na tabela:

• Filial: Indica se o parâmetro é exclusivo ou compartilhado.
• Parâmetro: Nome do parâmetro no ambiente.
• Descrição: Informação descritiva do parâmetro.
• Conteúdo: Apenas para administradores – mostra o conteúdo atual do parâmetro.
• Documento: Link direto para consulta do parâmetro.
• Editar: Abre um modal para a edição online do parâmetro.

Importante:

• Nomes em azul indicam parâmetros não criados no ambiente.
• Conteúdo visível apenas para usuários do grupo administradores.

Ações Disponíveis:

Filtro

Descubra como o filtro de parâmetros pode tornar a navegação eficiente em rotinas com grande quantidade de informações. Refine a exibição com base em módulo, rotina e parâmetros específicos, ajustando os filtros conforme necessário para resultados precisos.

Acesso ao Filtro de Parâmetros:

Siga estas etapas:

1. Navegue até “Parâmetros da rotina” em “Informações atuais”.
2. Clique no botão de ‘funil’ para acessar o filtro.

Ao acionar o filtro de parâmetros, saiba que:

• O filtro de programa tem prioridade sobre o filtro de módulo.
• O contador de opções indica o número de filtros ativos.
• Há flexibilidade para ajustar filtros conforme necessário, considerando os aspectos de módulo, programa (rotina) e parâmetros (código).

Detalhamento do Parâmetro:

Explore a funcionalidade de detalhamento de parâmetros para obter informações específicas sobre um parâmetro:

1. Navegue até “Parâmetros de rotina” no sistema.
2. Clique sobre o nome do parâmetro desejado.

Detalhes Exibidos:

• Nome do parâmetro;
• Programas relacionado;
• Data de ativação;
• Módulos associados.

Edição do Conteúdo do Parâmetro:

Usuários administradores podem editar o conteúdo dos parâmetros para manter as informações atualizadas:

1. Clique na célula ‘Editar’ correspondente ao parâmetro desejado.
2. Faça as alterações necessárias no modal.
3. Clique em ‘Aplicar’ e, em seguida, ‘Salvar’ para confirmar as alterações.

Otimize seu ambiente Protheus com a habilidade de gerenciar e ajustar os parâmetros de maneira eficiente.

Pontos de Entrada

Descubra a funcionalidade da aba de pontos de entrada, uma ferramenta crucial para oferecer aos usuários uma visão completa e detalhada dos pontos de entrada associados a rotinas específicas no ambiente Protheus. Este guia visa orientar os usuários sobre o uso eficaz da aba de pontos de entrada, destacando recursos e capacidades disponíveis para consulta e manutenção, atendendo às necessidades operacionais.

 

 

 

 

 

 

 

 

Tabela de Pontos de Entrada:

Saiba quais pontos de entrada serão listados na tabela:

• Ponto de Entrada: Nome, por exemplo, “A012BRWT”.
• Descrição: Breve descrição, caso documentado.
• Status: Inexistente, Compilado ou Desativado.
• Ação: Desativar ou Ativar, dependendo do status.
• Documento: Links ou informações de documentos relevantes no TDN.

Ações Disponíveis:

Filtro

Descubra como o filtro de pontos de entrada pode tornar a navegação eficiente em rotinas com grande quantidade de informações. Refine a exibição com base em módulo, rotina e pontos de entrada específicos para focar nas informações relevantes.

Siga estas etapas:

1. Navegue até “Pontos de Entrada” em “Informações atuais”.
2. Clique no botão ‘funil’ para acessar o filtro.

Ao acionar o filtro de parâmetros, saiba que:

• O filtro de programa tem prioridade sobre o filtro de módulo.
• O contador de opções indica o número de filtros ativos.
• Há flexibilidade para ajustar filtros conforme necessário, considerando os aspectos de módulo, programa (rotina) e parâmetros (código).

Detalhamento do Ponto de Entrada

Explore a funcionalidade de detalhamento dos pontos de entrada para obter informações específicas:

1. Navegue até “Pontos de Entrada” no sistema.
2. Clique sobre o nome do ponto de entrada desejado.

Detalhes Exibidos:

• Nome do ponto de entrada;
• Programas relacionados;
• Data de ativação;
• Módulos associados.

Otimize suas rotinas no Protheus entendendo os detalhes dos pontos de entrada e aproveitando as funcionalidades disponíveis para consulta e manutenção eficientes.

Diagnóstico

Descubra como a rotina de Diagnóstico de Dicionários pode ser uma ferramenta fundamental para otimizar a execução de rotinas no Protheus, como o UPDDISTR, identificando potenciais erros e garantindo a integridade do seu sistema.

Recursos e Pré-requisitos:

• Disponível a partir da LIB versão 20230109 com dicionário no banco de dados.
• Ativação necessária no arquivo appserver.ini.

Configuração no appserver.ini:

[General]

App_Environment={nome-do-ambiente-utilizado}

[Drivers]

MULTIPROTOCOLPORT=1

[WEBAPP]

Port={porta-http-desejada => Ex.:4322}

Enable=1

Para obter detalhes sobre a configuração para execução de Apps no Protheus, consulte:

• Configurando nativamente o Application Server como servidor Web
• Abrindo aplicativos Web no Prtoheus

Como Iniciar o Diagnóstico:

1. Pressione Shift+F6 em qualquer tela do sistema;
2. Na janela de informações, clique em “Avançar”;
3. Na tela 2, clique no botão “Diagnóstico” na seção de “Dicionário de Dados”.

Tela principal

Na tela principal, temos os seguintes itens:

Operação:

Possui as seguintes opções de operações para executar, podendo aplicar mais de uma:

Integridade SX3 (campos) x SXG (grupo de campos):

Problemas de cadastro entre SX3 e SXG.

Integridade SX1 (perguntas) x SXG (grupo de campos):

Problemas de cadastro entre SX1 e SXG.

Integridade SX3 x tabela física:

Diferenças entre campos em SX3 e tabelas físicas.

Integridade SX3 (campos) x SIX (índices):

 Divergências entre campos e índices.

Integridade SIX (índices) x tabela física:

Diferenças entre índices em SIX e tabelas físicas.

Configuração Detalhada:

DICIONÁRIO DE:

Escolha o dicionário inicial.

DICIONÁRIO ATÉ:

Escolha o dicionário final.

PERGUNTA DE:

Escolha a pergunta inicial (para operação envolvendo SX1).

PERGUNTA ATÉ:

Escolha a pergunta final (para operação envolvendo SX1).

BOTÃO PROCESSAR:

• Configure dicionários e parâmetros;
• Clique em “Processar” para iniciar o diagnóstico.

 

Tela de Resultado de Diagnóstico:

Esta tela exibe os resultados da busca com parâmetros selecionados, incluindo colunas de Operação, Chave, Descrição e Resultado.

Colunas – Operação, Chave, Descrição e Resultado:

Apresentam informações dos resultados da busca.

Botão Carregar Mais Resultados:

Se azul, há mais resultados disponíveis para carregar; se cinza, todos os resultados estão na tela.

Caixa de Pesquisar:

Permite buscar uma string em todas as colunas, carregando automaticamente mais resultados conforme necessário.

Busca Avançada:

Similar à pesquisa, permite combinar colunas para resultados mais precisos.

Botão Exportar:

Exporta resultados para uma planilha, oferecendo opções de exportação parcial (Grid) ou completa (TODOS).

O Diagnóstico de Dicionários no Protheus é uma ferramenta indispensável para garantir a integridade e o desempenho eficiente do seu sistema. Utilize essas orientações para otimizar suas rotinas e prevenir problemas em sua base de dados.

Pilha de Chamada

A funcionalidade da Pilha de Chamada é crucial para revelar todas as funções e fontes que foram ativadas, desde o ponto inicial até chegar à tela acionada pelo atalho Shift + F6. Essa informação proporciona uma compreensão completa do trajeto que o sistema percorreu, destacando as ações executadas tanto pelo sistema quanto pelo usuário.

No exemplo fornecido abaixo, a pilha oferece uma visão detalhada do percurso até a abertura do browse da rotina ATFA012:

 

 

 

 

 

 

 

 

Monitoramento eficiente do Appserver no Protheus

A aba “Appserver” no Protheus é uma ferramenta crucial que possibilita aos usuários monitorar de perto os recursos em uso pelo servidor de aplicação (Appserver). Esta seção oferece insights valiosos por meio de gráficos e informações disponíveis na interface, proporcionando uma visão abrangente do desempenho do sistema.

 

 

 

 

 

 

 

 

 

Principais Informações do Appserver:

1. Versão da Build;
2. Status “Atualizado” ou “Desatualizado“;
3. Versão do Appserver;
4. Tipo de Execução: Console (Serviço), ISAPI (Web), FAT (Gráfico);
5. IP e Porta de Conexão;
6. Latência entre SmartClient, Appserver e DBAccess.

Detalhes do Hardware:

1. Nome do Servidor;
2. Esquema de Energia: Economy, Balanced e High Performance;
3. Versão do S.O (Sistema Operacional);
4. Arquitetura do Processador;
5. Quantidade de Núcleos;
6. Velocidade de Processamento.

Ao surgirem dúvidas, clique no botão designado para ser redirecionado à página principal do Appserver no TDN.

Monitoramento da Memória:

1. Memória Física:

• Total disponível de RAM;
• Quantidade em uso e livre;
• Status de consumo, classificado em OK, Atenção e Perigo.

2. Memória de Paginação:

• Total disponível de memória de paginação;
• Quantidade em uso e livre;
• Status de consumo, classificado em OK, Atenção e Perigo.

3. Memória Appserver:

• Consumo em MB e percentual em relação à memória total;
• Detalhes sobre Serviço de Endereçamento de Memória e Serviço de Memória Residente.

Desempenho do Processador:

1. Percentual de Utilização do Processador na Execução do Appserver;
2. Percentual Total de Utilização do Processador;
3. Status de Consumo Geral do Processador:

• Consumo OK (0,01% a 75,00%)
• Atenção (75,01% a 85,00%)
• Perigo (85,01% a 100,00%)

Ao adotar uma abordagem centrada no monitoramento eficiente do Appserver no Protheus, os usuários podem otimizar o desempenho do sistema, garantindo uma experiência fluida e sem contratempos.

Maximize o Desempenho com o DBAccess

A funcionalidade “DBAccess” oferece aos usuários do Protheus uma poderosa ferramenta para monitorar de perto os recursos do servidor de banco de dados (DBAccess). Através de gráficos e informações intuitivas fornecidas pela interface, os usuários podem otimizar a operação do DBAccess, garantindo eficiência e performance.

 

 

 

 

 

 

 

Informações Essenciais do DBAccess:

1. Detalhes da Aplicação: Build, modo de execução, versão do SMARTHEAP, versão DBAccess;
2. Status de Atualização da Aplicação: Atualizado e Desatualizado;
3. Informações sobre a DBAPI;
4. Status de Atualização da DBAPI: Atualizado e Desatualizado;
5. Detalhes Adicionais: Nome do servidor, Esquema de energia (Economy, Balanced, High-Performance), Versão do sistema operacional e Banco de dados utilizado no Protheus;
6. Dúvidas: ao clicar no botão de dúvidas, os usuários são redirecionados para a página principal do DBAccess no TDN.

Monitoramento de Memória:

1. Memória Física:

• Total disponível de RAM;
• Quantidade em uso e livre;
• Status de consumo (OK, Atenção, Perigo).

2. Memória de Paginação:

• Total disponível de memória de paginação;
• Quantidade em uso e livre;
• Status de consumo, classificado em OK, Atenção e Perigo.

3. Memória do DBAccess:

• Consumo em MB e percentual em relação à memória total;
• Detalhes do consumo e status (OK, Atenção, Perigo).

Desempenho do Processador:

Percentual Total de Utilização do Processador: Status de consumo geral do processador (OK, Atenção, Perigo);

Status DBAccess:

Informações referentes ao log de utilização do DBAccess.

Estatísticas do Banco de Dados:

A aba de estatísticas no final da página oferece dados essenciais sobre a utilização do banco de dados no Protheus, incluindo o tamanho em megabytes do banco e índice, nome do SGBD, servidor de hospedagem, área de tabelas do sistema Protheus e campo de pesquisa para obter informações detalhadas sobre tabelas específicas.

Com uma abordagem focada no monitoramento eficiente do DBAccess, os usuários podem melhorar significativamente a performance do sistema, garantindo uma operação suave e livre de contratempos.

Otimizando o Desempenho com LogProfiler e Replay no Protheus

Descubra como maximizar a eficiência e solucionar questões de desempenho no Protheus com as poderosas ferramentas LogProfiler e Replay. Essas opções oferecem uma visão abrangente e soluções práticas para aprimorar a execução de programas AdvPL.

LogProfiler: Monitorando a Execução de Programas AdvPL

A opção LogProfiler é sua aliada na análise do tempo de execução de programas AdvPL. Essa ferramenta é vital para identificar pontos críticos que podem causar lentidão nas rotinas. Para sua utilização, você possui duas opções:

1. Configuração no Ambiente (AppServer): Siga as instruções apresentadas no aplicativo para configurar diretamente no ambiente (AppServer).
2. Chamada Direta pela Ferramenta: Selecione um diretório para salvar o arquivo, que será armazenado no profile do usuário. Após isso, clique em ‘Iniciar log’, execute os passos necessários no sistema e, ao finalizar, abra a tela com Shift + F6 e clique em ‘Finalizar log’.

Replay: Capturando Momentos Cruciais do ERP TOTVS

O Replay é uma ferramenta investigativa que captura instantâneos do ERP TOTVS durante ocorrências, como erros, execuções ou falhas críticas. Essas informações são essenciais para a equipe de suporte da TOTVS analisar o problema sem a necessidade de montar ambientes complexos. Execute-o com facilidade, clicando em “Iniciar” e seguindo os passos dentro do sistema. Para encerrar, abra a central novamente com Shift + F6 e clique em “Finalizar“. Opte por incluir ou não as fontes da lib para ajustar o desempenho.

Atualizações Eficientes no Protheus

A aba de “Atualizações” no Protheus oferece uma maneira eficiente de monitorar e aplicar atualizações em diversos componentes do ambiente. Obtenha uma visão detalhada das versões instaladas em comparação com as homologadas pela TOTVS, mantendo seus ambientes sempre atualizados.

Binário:

• Tipo, Plataforma, Versão do Ambiente, Build do Ambiente;
• Versão Homologada, Build Homologada, Status;
• Documento e ação para download.

Expedição Contínua:

• Módulo, Tipo, Versão do Ambiente;
• Versão Homologada, Status, Documento e ação para download.

Atualizações da rotina:

• Rotina, Versão do Ambiente, Versão Homologada, Status;
• Detalhes do pacote com descrição, versão e tipo.

Gestão de Procedures:

• Processo, Rotina, Descrição, Status da Rotina, Status do Processo;
• Detalhes de status, incluindo Atualizado, Desatualizado, Não Avaliado, Não Instalado, Incompatível, Emergencial e Piloto.

Ao explorar essas ferramentas e atualizações, você garante um ambiente Protheus otimizado, eficiente e sempre alinhado com as últimas melhorias e correções da TOTVS. Mantenha seu sistema atualizado para uma experiência de usuário aprimorada e livre de contratempos.