Conceito

O TOTVS Discovery 2.0 é a nova versão do Discovery. Além das ferramentas de monitoramento de ambientes, o TOTVS Discovery passa a ter papel ativo na gestão do ciclo de vida do Protheus, através da integração com o recurso Gestão de Ambientes.

O TOTVS Discovery pode:

  • Auxiliar na detecção de problemas de Hardware/Software nos ambientes de produção, desenvolvimento e de testes.

  • Indicar problemas de performance nos ambientes.

  • Verificar se algum item de boa prática na configuração do ambiente não está sendo seguido.

  • Aplicar pacotes de atualização em uma esteira de produção (Trilha)


Para utilização do TOTVS Discovery 2.0, é necessário que os ambientes Protheus monitorados tenham LIB com versão igual ou superior a 20210217.



Itens monitorados

O TOTVS Discovery monitora os softwares que compõem a instalação básica do Protheus além do Banco de Dados, abrangendo assim os seguintes itens:

  • AppServer

  • DBAccess

  • License Server

  • Banco de Dados


O ponto central do monitoramento são os serviços AppServer, sendo a comunicação com os demais itens efetuada a partir dos mesmos.

Topologia















  • Ao instalar o TOTVS Discovery, ele se tornará um servidor Web para a exibição das páginas de monitoramento e servidor REST para as respostas ao navegador.

  • O Servidor de Licenças fornecerá o IP e Porta de todos os serviços dos AppServers em execução em que o ambiente esteja utilizando esse Servidor de Licenças.

  • Ao monitorar o ambiente, será monitorado o DBAccess configurado no ambiente.

  • O DBAccess executará o monitoramento do Banco de dados que está configurado no ambiente.

Bancos de dados

O monitoramento do banco de dados é efetuado por padrão nos seguintes produtos  

  • MSSQL

  • Oracle

  • Postgres


O monitoramento é feito através do disparo de consultas ao próprio banco de dados. Para monitorar bancos de dados não listados acima, deve-se utilizar o ponto de entrada TDDBSTAT.

O ponto de entrada TDDBSTAT tem como um retorno um array na seguinte estrutura:

  • Informações obrigatórias

    • aRet[ i , 1 ](C) = Título

    • aRet[ i , 2 ](C) = Descrição

    • aRet[ i , 3 ](X) = Valor

    • aRet[ i , 4 ](A) = Array de saúde não obrigatório

  • A saúde não é obrigatória

    • aRet[ 1 , 4 , j , 1 ](N) = Saúde - Status ( 1 , 2 , 3 , 4 ) --Atualmente o 3 e 4 estão sendo tratados da mesma forma

    • aRet[ 1 , 4 , j , 2 ](C) = Saúde - Descrição

    • aRet[ 1 , 4 , j , 3 ](C) = Saúde - Detalhe

    • aRet[ 1 , 4 , j , 4 ](C) = Saúde - Link


Abaixo um exemplo do mesmo:

Include 'protheus.ch'
User Function TDDBSTAT()
Local aDeArray As Array
aDeArray := {}
aAdd( aDeArray , { "idTesteMonitor" , "Item monitorado" , "Meu valor monitorado" , { { 1 , "Saúde" , "Tudo OK" , Nil } } } )
Return aDeArray

Requisitos mínimos

Para o completo monitoramento do ambiente são necessários os seguintes requisitos:

  • Binário do ERP, versão Build 7.00.191205P ou superior

  • Binários DbAccess Build 20200606-20201110 ou superior

  • LIB data 17/02/2021 ou superior

  • License Server Virtual, 3.00.001 ou superior

  • Navegadores de internet compatíveis com o PO-UI: https://po-ui.io/guides/browser-support


Instalação


Versão Windows

Requerimentos:

- Java JRE Versão 8 ou superior

Download:

Baixe o instalador no Portal do Cliente (http://suporte.totvs.com)
- Acesse a opção Downloads
- Em Lista de Produtos, selecione Protheus
- Em Software, selecione TOTVSTEC-FRAMEWORK > INSTALADORES
- Procure pelo arquivo que tenha a descrição "Instalador Discovery - Windows"

Se preferir, link direto: https://suporte.totvs.com/portal/p/10098/download?e=711064

Passo-a-passo:

Após o Download do instalador, execute o mesmo, selecione o idioma do produto e clique em OK.




A primeira tela apresenta as informações iniciais do TOTVS Discovery. Clique em Próximo.




Leia o Contrato de Licenciamento de Usuário Final (EULA) e clique em Próximo.




Selecione o caminho para instalação, e clique em Próximo.




Serão exibidas as informações de espaço em disco (disponível e requerido). Clique em Próximo.




Nesta tela, é necessário informar os IPs e Portas que o TOTVS Discovery irá utilizar para se comunicar.
- IP do License Server: indique o endereço IP do servidor onde o License Server está instalado
- Porta do License Server: indique a porta em que o License Server está em execução
- Porta para o AppServer do TOTVS Discovery: porta reservada para o uso de conexão com o TOTVS Discovery via SmartClient
- IP da máquina: endereço IP deste servidor onde o TOTVS Discovery está sendo instalado. Será utilizado para o serviço de HTTP
- Porta para o HTTP: número da porta que será utilizada para exibição da página do TOTVS Discovery. Recomendamos o uso de uma porta diferente de 80, que é padrão do sistema operacional, para evitar possíveis conflitos.
- Porta para o REST: número da porta do serviço REST que é iniciado junto com o TOTVS Discovery

Após terminar a configuração de IPs e Portas, clique em Próximo.




Ao final do processo de instalação, clique em Próximo.




No último passo, clique em Sair. A instalação está completa. O TOTVS Discovery estará configurado como um Serviço do Windows.

Para confirmar a instalação, abra o navegador e digite, na barra de endereços, o endereço e porta configurados no Passo 5 da instalação (Exemplo: http://10.0.2.15:8070, ou http://localhost:8070, se estiver no mesmo servidor).




Versão Linux

Requerimentos:

- Java JDK versão 8 (sudo apt-get install openjdk-8-jdk)
- Java JDK versão 11 (sudo apt install openjdk-11-jdk)

Download:

Baixe o instalador no Portal do Cliente (http://suporte.totvs.com)
- Acesse a opção Downloads
- Em Lista de Produtos, selecione Protheus
- Em Software, selecione TOTVSTEC-FRAMEWORK > INSTALADORES
- Procure pelo arquivo que tenha a descrição "Instalador Discovery - Linux"

Se preferir, link direto: https://suporte.totvs.com/portal/p/10098/download?e=743784

Passo-a-passo:

Após o Download do instalador, execute-o como Administrador (root), utilizando o comando abaixo:
sudo java -jar totvsdiscoveryinstaller.jar




Será exibido o Contrato de Licenciamento de Usuário Final (EULA), leia-o e pressione a tecla 1 para Aceitar o termo e continuar.




Digite o caminho para instalação (Exemplo: /totvs/totvsdiscovery/), tecle Enter, então pressione a tecla 1 para Confirmar. Caso a pasta não exista, ela será criada.




O pacote do TOTVS Discovery será selecionado automaticamente. Pressione 1 para continuar.




Serão solicitadas as informações de conexão (portas e endereços IP), conforme abaixo. Digite as informações solicitadas.
- IP do License Server: indique o endereço IP do servidor onde o License Server está instalado
- Porta do License Server: indique a porta em que o License Server está em execução
- Porta para o AppServer do TOTVS Discovery: porta reservada para o uso de conexão com o TOTVS Discovery via SmartClient
- IP da máquina: endereço IP deste servidor onde o TOTVS Discovery está sendo instalado. Será utilizado para o serviço de HTTP
- Porta para o HTTP: número da porta que será utilizada para exibição da página do TOTVS Discovery. Recomendamos o uso de uma porta diferente de 80, que é padrão do sistema operacional, para evitar possíveis conflitos.
- Porta para o REST: número da porta do serviço REST que é iniciado junto com o TOTVS Discovery

Após digitar todas as informações, pressione 1 para confirmar.




Os arquivos serão instalados, e ao final, será exibida uma mensagem "Console installation done".




Logo após a instalação, o servidor TOTVS Discovery já vai estar iniciado, e já pode ser acessado por um navegador, digitando na barra de endereços, o endereço e porta configurados na instalação (Exemplo: http://10.0.2.15:8070).

Contudo, se precisar iniciar o serviço posteriormente, isso pode ser feito através do comando sudo ./ discovery.sh start


Importante

O instalador vem com a Versão 19 do binário Protheus, e no sistema operacional Linux, é necessário fazer uma configuração de variável de ambiente para que ele inicie adequadamente, conforme instruções do link abaixo:
Application Server - LIBBTMONITOR



Uso

Para a utilização do TOTVS Discovery é necessário o cadastramento de um usuário no Servidor de licenças, maiores detalhes verifique a documentação http://tdn.totvs.com/display/framework/TOTVS+License+Server+Virtual


Acesse o link conforme configurado durante a instalação. Exemplo: http://10.0.2.15:8070

  • Utilize o usuário criado no Servidor de Licenças.

  • O usuário deve possuir uma senha, não é permitido senha vazia.

  • Em alguns casos, se o Servidor de Licenças for reinstalado ou o servidor sofrer alguma alteração (Porta, IP, outros motivos) será gerado um novo ID, devendo ser selecionado o ID atual.



Após o login, a página inicial irá exibir todos os ambientes que estão utilizando o Servidor de Licenças monitorado.



Abaixo iremos detalhar cada um dos menus do TOTVS Discovery:

Cadastro de Stages

Gestão de Ambientes

Trilhas

Eventos

Log de Operações

Configurações



Links adicionais do TOTVS Discovery