Monitoraggio dello stato di salute

Enterprise Server include un sistema completo di monitoraggio dello stato che consente agli Amministratori di verificare e analizzare rapidamente la condizione, o “salute”, di un Enterprise Server. Il monitor dello stato è disponibile dalla sezione Admin dell’interfaccia browser del Workspace (la pagina Server Health), oppure come strumento eseguibile standalone incluso nell’installazione di Enterprise Server sul PC host (lo strumento Server Health Monitor).

La funzione di monitoraggio dello stato fornisce un riepilogo visivo dello stato della configurazione e dei servizi di Enterprise Server, informazioni sulle risorse di sistema della macchina host e offre anche accesso a report di stato e file di log. Questo fornisce una panoramica immediata dello stato di Enterprise Server, consentendo agli amministratori di rilevare e risolvere in modo proattivo eventuali problemi che potrebbero influire sugli utenti del Workspace.

Ciascun approccio al monitoraggio dello stato e della salute di Enterprise Server presenta un proprio vantaggio specifico:

• Server Health page – come parte dell’interfaccia browser del Workspace di Enterprise Server, la pagina Server Health è disponibile agli amministratori sulla rete locale, offrendo la comodità dell’accesso remoto.
• Server Health Monitor tool – l’eseguibile standalone Health Monitor (avhealth.exe) è accessibile indipendentemente dallo stato di Enterprise Server e fornirà quindi dati e informazioni cruciali nell’improbabile eventualità che Enterprise Server non sia pienamente funzionante.

Pagina Server Health

All’interno dell’interfaccia browser del Workspace, selezionare Admin – Health nel menu principale per accedere alla pagina di report Server Health, che indicherà lo stato complessivo dell’installazione di Enterprise Server in corrispondenza del riferimento temporale mostrato nella sezione superiore Status della pagina (Updated at: <timestamp>).

La pagina Server Health fornisce una vista immediata dello stato di Enterprise Server e della relativa infrastruttura di supporto.

Le informazioni della pagina Server Health vengono aggiornate periodicamente (come indicato dal timestamp dello stato), ma è possibile forzare un aggiornamento su richiesta tramite il relativo collegamento refresh status.

Fare clic sul collegamento di aggiornamento per aggiornare le informazioni sullo stato di Enterprise Server.

Errori e avvisi

Come panoramica evidenziata dello stato di Enterprise Server, la pagina Server Health fornisce icone distinte di avviso/errore e descrizioni associate per le voci di stato che richiedono attenzione. Gli avvisi comuni includono backup dei dati scaduti, scadenze di licenza imminenti, un account utente admin/admin attivo oppure voci di errore rilevate in un file di log:

• OK  – le metriche rilevate rientrano in un intervallo o in una condizione accettabile.
• Warning  – Enterprise Server e la relativa infrastruttura di supporto funzionano correttamente, ma si consiglia una modifica per risolvere un problema potenziale o futuro.
• Error  – una parte di Enterprise Server o della relativa infrastruttura di supporto non funziona o non è configurata correttamente e richiede attenzione immediata.

Correzione dei problemi comuni

Sebbene eventuali problemi di prestazioni e di sistema possano probabilmente essere risolti migliorando le risorse e l’infrastruttura disponibili del PC host di Enterprise Server, i problemi nella sezione Environment and configuration della pagina Server Health possono generalmente essere risolti utilizzando le funzioni e gli strumenti disponibili per gli amministratori del Workspace:

• Admin password – creare uno o più account amministratore specifici nella pagina Users, se non lo si è già fatto, e modificare la Password (e preferibilmente anche lo Username) dell’account predefinito admin.
• Log level – se necessario, modificare il livello di logging di Enterprise Server intervenendo sulla voce LogLevel= nella sezione General del file LocalVault.ini, situato nella cartella di installazione di Enterprise Server sul PC host. I valori di livello consentiti sono Info (predefinito) e Warn. Con quest’ultima opzione, le informazioni generali di stato (chiamate API, avvio e arresto dei servizi, ecc.) non verranno incluse nei file di log; gli errori sono sempre inclusi.
• Licenses – un errore dovuto alla scadenza imminente della licenza di Enterprise Server viene gestito tramite la pagina Licenses dell’interfaccia browser (Admin – Licenses). Una licenza già scaduta può essere risolta accedendo all’interfaccia browser sulla macchina host di Enterprise Server.
• Backups – un Workspace backup può essere eseguito utilizzando lo strumento avbackup.exe, disponibile nella cartella Tools\BackupTool all’interno dell’installazione di Enterprise Server sul PC host.

• Project Sharing (segnalato nello strumento Health Monitor tool) – qui può essere segnalato un errore di password per membri esistenti del Workspace quando i SVN repositories sono stati abilitati e/o aggiunti – vedere l’esempio di errore. Questo impedirà anche di eseguire aggiunte di aggiornamento a questi profili utente. Per sincronizzare gli utenti esistenti con il repository SVN, modificare ciascun profilo membro reinserendo la relativa password e confermando con il pulsante Update. Le credenziali verranno aggiornate nel file SVN passwd del sistema (in genere presente nella cartella C:\ProgramData\Altium\Altium365Data\Repository) per registrare correttamente questi utenti nel repository SVN.

Report e log

Le prestazioni sia di Enterprise Server sia del PC host vengono testate e riepilogate (nelle sezioni Performance e System) e i log di report sono resi disponibili per la generazione e il download:

• Logs – i log di Enterprise Server vengono scaricati come archivio zip nella posizione di download predefinita del browser (Download all logs). Includono log in testo semplice per tutti i servizi ospitati da Enterprise Server, in cui il file di log di ciascun servizio include eventi basati sul tempo (ed errori) dall’installazione di Enterprise Server o dalla cancellazione dei log (Clear logs).
• Reports – il report di stato di Enterprise Server viene scaricato come archivio zip nella posizione di download predefinita del browser (richiamato tramite il collegamento Generate nella sezione superiore Status della pagina). Questo report descrive lo stato e la configurazione di tutti gli elementi principali di Enterprise Server. Pensati come informazioni chiave per i team di supporto Altium, i report includono anche informazioni su stato e prestazioni dell’infrastruttura di supporto del PC host.

Strumento Health Monitor

L’installazione di Enterprise Server include il completo strumento On-Prem Enterprise Server Health Monitor che consente agli Amministratori di verificare e analizzare rapidamente, a livello locale, la condizione o “salute” di Enterprise Server. Fornito come applicazione standalone e indipendente insieme all’installazione di Enterprise Server, Health Monitor offre un riepilogo visivo dello stato della macchina host e della configurazione e dei servizi di Enterprise Server. La sua interfaccia include anche suggerimenti contestuali, oltre a informazioni e percorsi verso posizioni importanti e file di log.

Health Monitor presenta le informazioni sullo stato di Enterprise Server tramite una semplice GUI e, in termini generali, copre le seguenti aree critiche:

• Enterprise Server Environment – lo stato dell’hardware del PC host, come dischi rigidi, memoria, CPU e l’adeguatezza delle relative prestazioni.
• Enterprise Server Backend – lo stato del database di supporto, dell’archiviazione file e del repository di Enterprise Server.
• Enterprise Server Services – lo stato della gamma di servizi di Enterprise Server, ospitati come IIS Application Pool, come i servizi Identity, Authorization, License Manager e Network Installation.

Accesso allo strumento

In un’installazione predefinita di Enterprise Server, lo strumento Health Monitor si trova nella cartella \Program Files (x86)\Altium\Altium365\Tools\HealthMonitor come eseguibile avhealth.exe. Si noti che la cartella include anche uno strumento semplificato da riga di comando: avConsoleHealth.exe.

Quando viene eseguito lo strumento GUI Health Monitor (avhealth.exe), il programma interroga immediatamente Enterprise Server e i relativi sistemi host per popolare la schermata principale Dashboard di Health Monitor, selezionata (per impostazione predefinita) nelle schede superiori. Fare clic sul pulsante Refresh () per riattivare il processo e aggiornare la schermata.

La GUI Dashboard di Health Monitor fornisce una vista immediata dello stato di Enterprise Server e della relativa infrastruttura di supporto, oltre a collegamenti a ulteriori informazioni.

Errori e avvisi

Lo stato di ciascun elemento nel Dashboard è indicato da un messaggio e da un’icona associata:

• OK  – le metriche rilevate rientrano in un intervallo o in una condizione accettabile.
• Warning  – Enterprise Server e la relativa infrastruttura di supporto funzionano correttamente, ma si consiglia una modifica per risolvere un problema potenziale o futuro.
• Error  – una parte di Enterprise Server o della relativa infrastruttura di supporto non funziona correttamente e richiede attenzione immediata.

Passare il mouse sullo stato di un elemento per ulteriori informazioni. Per un errore o un avviso mostrato nel Dashboard, nella maggior parte dei casi sono disponibili ulteriori dettagli facendo clic sulla voce di stato di quell’elemento.

Passare il mouse su una voce di stato per accedere a informazioni più dettagliate.

Collegamenti reattivi

Molte delle condizioni di errore/avviso rilevate da Health Monitor offrono collegamenti pensati per aiutare a risolvere la situazione. Questi sono inclusi nelle informazioni dettagliate dell’elemento, disponibili facendo clic sulla relativa voce di stato.

    
Quando si verificano problemi comuni relativi agli eventi, le informazioni associate forniscono ulteriori dettagli e collegamenti per aiutare a risolvere la condizione segnalata.

Nell’esempio di schermata sopra a sinistra, Health Monitor ha rilevato che non è stato eseguito il backup di Enterprise Server. Le informazioni associate forniscono un collegamento alla documentazione che aiuterà a risolvere la situazione.

La schermata di esempio a destra (sopra) indica che le credenziali di accesso predefinite admin/admin di Enterprise Server esistono ancora, il che comporta un rischio significativo per la sicurezza. Il collegamento Fix It nelle informazioni associate accede direttamente alla pagina di accesso di Enterprise Server tramite l’interfaccia browser, dove i profili utente Administrator possono essere corretti.

Browser dei log

La schermata Log Browser di Health Monitor, accessibile tramite la scheda Log Browser, presenta le voci di errore e avviso da tutti i file di log disponibili di Enterprise Server, normalmente situati nella cartella C:\ProgramData\Altium\Altium365Data\logs. Per visualizzare il file di log che contiene la voce dell’evento, selezionare il relativo collegamento Open file  oppure fare semplicemente doppio clic sulla voce stessa.

Le voci cumulative degli eventi nell’elenco sono suddivise per data e includono tutti gli eventi di Errore/Avviso disponibili provenienti da tutti i file di log. Per trovare eventi specifici, scegliere un intervallo di tempo dal menu a discesa Show logs e/o utilizzare il campo di filtro dinamico () per cercare parole chiave nelle colonne Subsystem e Message.

L’interfaccia Log Browser consente di individuare rapidamente gli eventi di interesse utilizzando un intervallo di tempo selezionabile e il filtro per parole chiave.

Selezionare il pulsante per rimuovere le voci di log accumulate dall’elenco del Log Browser: questa operazione archivierà e poi eliminerà tutti i file di log esistenti.

Report di stato

La schermata Report di stato di Health Monitor, accessibile dalla scheda Status Report, viene utilizzata per creare e visualizzare i file di report sullo stato di Enterprise Server. I report generati raccolgono tutte le informazioni di debug degli eventi in un unico archivio Zip (*.zip) che può essere inviato, quando necessario, agli sviluppatori di Altium.

Per creare un report, selezionare un intervallo di tempo degli eventi appropriato dal menu a discesa Include Logs, inserire i propri dati di contatto e selezionare l’accordo di condivisione, quindi avviare il processo con il pulsante .

Utilizzare la schermata Status Report per generare file di report dei log aggregati a scopo di debug.