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 verificar 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 seu 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 proporciona 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 para monitorizar a saúde e o 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 com referência ao carimbo temporal apresentado na secção superior Status da página (Updated at: <timestamp>).

A página Server Health fornece uma visão imediata do estado do Enterprise Server e da respetiva infraestrutura de suporte.

As informações da página Server Health são atualizadas periodicamente (conforme indicado pelo carimbo temporal do Estado), mas a atualização também pode ser acionada 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 pendente 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 respetiva 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 respetiva 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 sejam provavelmente 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, em geral, ser resolvidos através das 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 esta última opção, as informações gerais de estado (chamadas 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 pendente 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 dentro da instalação do Enterprise Server no PC anfitrião.

• Project Sharing (reportado na ferramenta Health Monitor) – pode ser aqui reportado um erro de palavra-passe para membros existentes do Workspace quando os repositórios SVN tiverem sido ativados e/ou adicionados – ver exemplo. Isto também impedirá a realização de atualizações adicionais a estes perfis de utilizador. Para sincronizar os utilizadores existentes com o repositório SVN, edite o perfil de cada membro, introduzindo novamente a respetiva palavra-passe e confirmando com o botão Update. As credenciais serão atualizadas no ficheiro SVN passwd do sistema (normalmente encontrado na pasta C:\ProgramData\Altium\Altium365Data\Repository) para registar estes utilizadores no repositório SVN.

Relatórios e Registos

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

• Logs – os Registos do Enterprise Server são transferidos como um arquivo zip para a localização de transferência predefinida do navegador (Download all logs). Estes incluem registos em texto simples para todos os serviços alojados pelo Enterprise Server, sendo 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 de transferência predefinida 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 da configuração de todos os elementos principais do Enterprise Server. Destinados a servir de informação essencial para as equipas de suporte da Altium, os relatórios também incluem 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 abrangente ferramenta On-Prem Enterprise Server Health Monitor, que permite aos Administradores verificar 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, além de informações e caminhos para localizações importantes e ficheiros de registo.

O Health Monitor apresenta informações de estado do Enterprise Server através de uma GUI simples e, em termos gerais, cobre 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 respetivo desempenho.
• Enterprise Server Backend – o estado da base de dados, do armazenamento de ficheiros e do repositório que suportam o 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. Tenha em atenção 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 respetivos sistemas de alojamento para preencher o ecrã principal Dashboard do Health Monitor – conforme selecionado (por predefinição) nos separadores superiores. Clique no botão Refresh () para voltar a acionar o processo e atualizar o ecrã.

A GUI Dashboard do Health Monitor fornece uma visão imediata do estado do Enterprise Server e da respetiva 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 um ícone associado:

• OK  – as métricas detetadas estão dentro de um intervalo ou condição aceitável.
• Warning  – o Enterprise Server e a respetiva 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 respetiva infraestrutura de suporte não está a funcionar corretamente e requer atenção imediata.

Passe o cursor do rato sobre o estado de um item para obter mais informações. No caso de 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 reativas

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 não foi efetuada uma cópia de segurança do Enterprise Server. As informações associadas fornecem uma ligação para a documentação que ajudará a resolver a situação.

O ecrã de exemplo à direita (acima) indica que as credenciais de início de sessão predefinidas 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 do 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 visualizar o ficheiro de registo que contém a entrada do evento, selecione a ligação Open file associada ou faça simplesmente duplo clique na própria entrada.

As entradas de eventos cumulativas na lista são agrupadas 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 concentrar-se em eventos de interesse utilizando um período de tempo selecionável e a filtragem por palavras-chave.

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

Relatório de Estado

O ecrã Relatório de Estado do Health Monitor, 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 de tempo de eventos adequado no menu pendente Include Logs, introduza os seus dados de contacto e selecione o acordo de partilha, e depois inicie o processo com o botão .

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