Monitoraggio dello stato di salute

Parent page: Manutenzione

Enterprise Server include un sistema completo di monitoraggio dello stato di salute che consente agli Amministratori di verificare e analizzare rapidamente la condizione, o “salute”, di un Enterprise Server. Il monitor dello stato di salute è disponibile nella 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 di salute fornisce un riepilogo visivo dello stato della configurazione e dei servizi di Enterprise Server, informazioni sulle risorse di sistema della macchina host e offre inoltre 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 di salute e dello stato operativo di Enterprise Server presenta un 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 caso in cui 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 riferimento al timestamp mostrato nella sezione superiore Status della pagina (Updated at: <timestamp>).

La pagina Server Health fornisce una visualizzazione 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 link refresh status.

Fare clic sul link di aggiornamento per aggiornare le informazioni sullo stato di salute 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 funzionalità e gli strumenti disponibili per gli amministratori del Workspace:

• Admin password – creare uno o più account amministratore specifici nella pagina Users, se non è già stato 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 vengono sempre inclusi.
• Licenses – un errore dovuto a una 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 backup del Workspace 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) – qui può essere segnalato un errore di password per membri esistenti del Workspace quando i repository SVN sono stati abilitati e/o aggiunti – vedere l’esempio. Questo impedirà inoltre di eseguire aggiornamenti aggiuntivi 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 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 dei report vengono 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 dall’ultima 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 link 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 sistemi che lo ospitano 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.

L’interfaccia GUI Dashboard di Health Monitor fornisce una visualizzazione immediata dello stato di Enterprise Server e della relativa infrastruttura di supporto, oltre a link per 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, ulteriori dettagli sono disponibili (nella maggior parte dei casi) facendo clic sulla voce di stato di quell’elemento.

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

Link reattivi

Molte delle condizioni di Errore/Avviso rilevate da Health Monitor offrono link 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 link 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 link 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 link Fix It nelle informazioni associate accede direttamente alla pagina di accesso di Enterprise Server tramite l’interfaccia browser, dove è possibile correggere i profili utente Administrator.

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 link Open file  oppure fare semplicemente doppio clic sulla voce stessa.

Le voci evento cumulative nell’elenco sono suddivise per data e includono tutti gli eventi di Errore/Avviso disponibili in 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 filtro dinamico () per cercare parole chiave nelle colonne Subsystem e Message.

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

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

Report di stato

La schermata Report di stato di Health Monitor, accessibile tramite la 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 appropriato per gli eventi 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.