Monitor de Saúde

Parent page: Manutenção

O Enterprise Server inclui um sistema abrangente de monitorização do estado de funcionamento que permite aos Administradores determinar e analisar rapidamente a condição, ou “saúde”, de um Enterprise Server. O monitor de estado está disponível na secção Admin da interface do navegador do Workspace (a página Server Health), ou como uma ferramenta executável autónoma incluída na instalação do Enterprise Server no PC anfitrião (a ferramenta Server Health Monitor).

A funcionalidade de estado fornece um resumo visual do estado da configuração e dos serviços do Enterprise Server, informações sobre os recursos do sistema da máquina anfitriã e também acesso a relatórios de estado e ficheiros de registo. Isto fornece uma visão imediata do estado do Enterprise Server, permitindo aos administradores detetar e resolver preventivamente quaisquer problemas que possam afetar os utilizadores do Workspace.

Cada abordagem à monitorização da saúde e do estado do Enterprise Server tem a sua própria vantagem distinta:

• Server Health page – como parte da interface do navegador do Workspace do Enterprise Server, a página Server Health está disponível para os administradores através da rede local, o que oferece a conveniência do acesso remoto.
• Server Health Monitor tool – o executável autónomo Health Monitor (avhealth.exe) está acessível independentemente do estado do Enterprise Server e, por isso, fornecerá dados e informações cruciais na eventualidade improvável de o Enterprise Server não estar totalmente funcional.

Página Server Health

Na interface do navegador do Workspace, selecione Admin – Health no menu principal para aceder à página de relatório Server Health, que indicará o estado geral da instalação do Enterprise Server na referência temporal apresentada na secção superior Status da página (Updated at: <timestamp>).

A página Server Health fornece uma visão instantânea do estado do Enterprise Server e da sua infraestrutura de suporte.

As informações da página Server Health são atualizadas periodicamente (conforme indicado pelo carimbo temporal do Estado), mas pode ser desencadeada uma atualização a pedido através da ligação refresh status associada.

Clique na ligação de atualização para atualizar as informações de estado do Enterprise Server.

Erros e Avisos

Como visão geral destacada do estado do Enterprise Server, a página Server Health fornece ícones distintos de aviso/erro e descrições associadas para entradas de estado que suscitam preocupação. Os alertas comuns incluem cópias de segurança de dados em atraso, expiração iminente de licenças, uma conta de utilizador admin/admin ativa ou entradas de erro detetadas num ficheiro de registo:

• OK  – as métricas detetadas estão dentro de um intervalo ou condição aceitável.
• Warning  – o Enterprise Server e a sua infraestrutura de suporte estão a funcionar corretamente, mas recomenda-se uma alteração para resolver um problema potencial ou futuro.
• Error  – parte do Enterprise Server ou da sua infraestrutura de suporte não está a funcionar ou configurada corretamente e requer atenção imediata.

Correção de Problemas Comuns

Embora quaisquer problemas de Desempenho e de Sistema provavelmente sejam resolvidos através da melhoria dos recursos e da infraestrutura disponíveis no PC anfitrião do Enterprise Server, os problemas na secção Environment and configuration da página Server Health podem geralmente ser resolvidos utilizando as funcionalidades e ferramentas disponíveis para os administradores do Workspace:

• Admin password – crie uma ou mais contas específicas de administrador na página Users, caso ainda não o tenha feito, e altere a Palavra-passe (e, de preferência, o Nome de utilizador) da conta predefinida admin.
• Log level – se necessário, altere o nível de registo do Enterprise Server editando a entrada LogLevel= na secção General do ficheiro LocalVault.ini, localizado na pasta de instalação do Enterprise Server no PC anfitrião. As entradas de nível permitidas são Info (a predefinição) e Warn. Com a última opção, as informações gerais de estado (chamadas de API, arranque e paragem de serviços, etc.) não serão incluídas nos ficheiros de registo – os erros são sempre incluídos.
• Licenses – um erro de expiração iminente da licença do Enterprise Server é tratado através da página Licenses da interface do navegador (Admin – Licenses). Uma licença já expirada pode ser resolvida acedendo à interface do navegador na máquina anfitriã do Enterprise Server.
• Backups – uma cópia de segurança do Workspace pode ser concluída utilizando a ferramenta avbackup.exe, disponível na pasta Tools\BackupTool da instalação do Enterprise Server no PC anfitrião.

Relatórios e Registos

O desempenho do Enterprise Server e do PC anfitrião é testado e resumido (nas secções Performance e System), sendo disponibilizados registos de relatórios para geração e transferência:

• Logs – os Registos do Enterprise Server são transferidos como um arquivo zip para a localização predefinida de transferências do navegador (Download all logs). Estes incluem registos em texto simples de todos os serviços alojados pelo Enterprise Server, em que o ficheiro de registo de cada serviço inclui eventos baseados no tempo (e erros) desde que o Enterprise Server foi instalado, ou desde que os registos foram limpos (Clear logs).
• Reports – o Relatório de Estado do Enterprise Server é transferido como um arquivo zip para a localização predefinida de transferências do navegador (invocado pela ligação Generate na secção superior Status da página). Este relatório apresenta o estado da condição e a configuração de todos os elementos centrais do Enterprise Server. Destinados a servir como informação essencial para as equipas de suporte da Altium, os relatórios incluem também informações de estado e desempenho sobre a infraestrutura de suporte do PC anfitrião.

Ferramenta Health Monitor

A instalação do Enterprise Server inclui a ferramenta abrangente On-Prem Enterprise Server Health Monitor, que permite aos Administradores determinar e analisar rapidamente, a nível local, a condição, ou “saúde”, do Enterprise Server. Fornecido como uma aplicação autónoma e independente com a instalação do Enterprise Server, o Health Monitor apresenta um resumo visual do estado da máquina anfitriã e da configuração e dos serviços do Enterprise Server. A sua interface inclui também sugestões relacionadas com o contexto, bem como informações e caminhos para localizações e ficheiros de registo importantes.

O Health Monitor apresenta informações de estado do Enterprise Server através de uma GUI simples e, em termos gerais, abrange as seguintes áreas críticas:

• Enterprise Server Environment – o estado do hardware do PC anfitrião, como os discos rígidos, memória, CPU e a adequação do seu desempenho.
• Enterprise Server Backend – o estado da base de dados, do armazenamento de ficheiros e do repositório de suporte do Enterprise Server.
• Enterprise Server Services – o estado do conjunto de serviços do Enterprise Server, alojados como IIS Application Pools, como os serviços Identity, Authorization, License Manager e Network Installation.

Acesso à Ferramenta

Numa instalação predefinida do Enterprise Server, a ferramenta Health Monitor pode ser encontrada na pasta \Program Files (x86)\Altium\Altium365\Tools\HealthMonitor como o executável avhealth.exe. Note que a pasta também inclui uma ferramenta simplificada de linha de comandos: avConsoleHealth.exe.

Quando a ferramenta GUI Health Monitor (avhealth.exe) é executada, o programa interroga imediatamente o Enterprise Server e os seus sistemas de alojamento para preencher o ecrã principal Dashboard do Health Monitor – tal como selecionado (por predefinição) nos separadores superiores. Clique no botão Refresh () para voltar a desencadear o processo e atualizar o ecrã.

A GUI Dashboard do Health Monitor fornece uma visão instantânea do estado do Enterprise Server e da sua infraestrutura de suporte, bem como ligações para mais informações.

Erros e Avisos

O estado de cada item no Dashboard é indicado por uma mensagem e ícone associado:

• OK  – as métricas detetadas estão dentro de um intervalo ou condição aceitável.
• Warning  – o Enterprise Server e a sua infraestrutura de suporte estão a funcionar corretamente, mas recomenda-se uma alteração para resolver um problema potencial ou futuro.
• Error  – parte do Enterprise Server ou da sua infraestrutura de suporte não está a funcionar corretamente e requer atenção imediata.

Passe o rato sobre o estado de um item para obter mais informações. Para um Erro ou Aviso apresentado no Dashboard, estão disponíveis mais detalhes (na maioria dos casos) clicando na entrada de estado desse item.

Passe o cursor sobre uma entrada de estado para aceder a informações mais detalhadas.

Ligações interativas

Muitas das condições de Erro/Aviso detetadas pelo Health Monitor oferecem ligações destinadas a ajudar a resolver a situação. Estas estão incluídas nas informações detalhadas do item, disponíveis ao clicar na respetiva entrada de estado.

    
Quando ocorrem problemas comuns de eventos, as informações associadas fornecem mais detalhes e ligações para ajudar a resolver a condição em causa.

No ecrã de exemplo acima, à esquerda, o Health Monitor detetou que o Enterprise Server não foi alvo de cópia de segurança. As informações associadas fornecem uma ligação para documentação que ajudará a resolver a situação.

O ecrã de exemplo à direita (acima) indica que as credenciais predefinidas de início de sessão admin/admin do Enterprise Server ainda existem, o que representa um risco de segurança significativo. A ligação Fix It nas informações associadas acede diretamente à página de início de sessão do Enterprise Server através da interface do navegador, onde os perfis de Utilizador Administrador podem ser corrigidos.

Navegador de Registos

O ecrã Log Browser do Health Monitor, acedido através do separador Log Browser, apresenta entradas de Erro e Aviso de todos os ficheiros de registo disponíveis do Enterprise Server – normalmente localizados na pasta C:\ProgramData\Altium\Altium365Data\logs. Para ver o ficheiro de registo que contém a entrada do evento, selecione a ligação associada Open file  ou faça simplesmente duplo clique na própria entrada.

As entradas cumulativas de eventos na lista são divididas por data e incluirão todos os eventos de Erro/Aviso disponíveis em todos os ficheiros de registo. Para encontrar eventos específicos, escolha um período de tempo no menu pendente Show logs e/ou utilize o campo de filtro dinâmico () para procurar palavras-chave nas colunas Subsystem e Message.

A interface Log Browser permite-lhe localizar eventos de interesse utilizando um período de tempo selecionável e filtragem por palavras-chave.

Selecione o botão para remover as entradas de registo acumuladas da lista do Log Browser – isto arquivará e depois eliminará todos os ficheiros de registo existentes.

Relatório de Estado

O ecrã Relatório de Estado do Monitor de Saúde, acedido pelo separador Status Report, é utilizado para criar e apresentar ficheiros de relatório de estado do Enterprise Server. Os relatórios gerados reúnem toda a informação de depuração de eventos num único arquivo Zip (*.zip), que pode ser enviado, quando necessário, para os Programadores da Altium.

Para criar um relatório, selecione um período temporal de eventos adequado no menu pendente Include Logs, introduza os seus dados de contacto e selecione o acordo de partilha e, em seguida, inicie o processo com o botão .

Utilize o ecrã Status Report para gerar ficheiros de relatório de Log consolidados para fins de depuração.