Monitor de Saúde

O Enterprise Server inclui um sistema abrangente de monitorização do estado 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 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 à monitorização do estado e da situação 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 no improvável caso 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 base 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 imediata do estado do Enterprise Server e da sua infraestrutura de suporte.

A informação na página Server Health é atualizada periodicamente (como indicado pelo carimbo temporal de Estado), mas pode ser acionada uma atualização a pedido através da ligação refresh status associada.

Clique na ligação de atualização para atualizar a informação 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 preocupantes. 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 Sistema sejam provavelmente resolvidos melhorando os recursos e a infraestrutura disponíveis do 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 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 iminente da licença do Enterprise Server é resolvido 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 (comunicado na ferramenta Health Monitor) – pode ser aqui comunicado um erro de palavra-passe para membros existentes do Workspace quando os repositórios SVN tiverem sido ativados e/ou adicionados – ver exemplo de erro. 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 cada perfil de membro voltando a introduzir 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 corretamente 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), e os registos de relatório ficam disponíveis 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ências predefinida do navegador (Download all logs). Estes incluem registos de texto simples para 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 de transferências predefinida do navegador (invocado pela ligação Generate na secção superior Status da página). Este comunica o estado da condição e a configuração de todos os elementos centrais 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 ferramenta abrangente 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 serviços do Enterprise Server. A sua interface também inclui sugestões contextuais, bem como informações e caminhos para localizações importantes e ficheiros de registo.

O Health Monitor apresenta informações sobre o 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, a memória, o CPU e a adequação do seu desempenho.
• Enterprise Server Backend – o estado da base de dados de suporte, do armazenamento de ficheiros e do repositório do Enterprise Server.
• Enterprise Server Services – o estado do conjunto de serviços do Enterprise Server, alojados como IIS Application Pools, tais 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 analisa 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 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 sua infraestrutura de suporte, além de 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 responsivas

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, a informação associada fornece 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. A informação associada fornece 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 de Utilizador Administrador podem ser corrigidos.

Navegador de Registos

O ecrã Log Browser do Health Monitor, acedido pelo separador Log Browser, apresenta entradas de Erro e Aviso de todos os ficheiros Log 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 associada Open file ou simplesmente faça duplo clique na própria entrada.

As entradas cumulativas de eventos na lista estão divididas por data e incluem todos os eventos de Erro/Aviso disponíveis em todos os ficheiros de registo. Para localizar 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 identificar com precisão os eventos de interesse através de um período temporal selecionável e da 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 temporal de eventos apropriado 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.