ArcGIS Notebook Server registra tutti gli eventi che si verificano in un sito e gli eventuali errori legati a tali evento, in appositi log. Questi log sono a disposizione degli amministratori del sito.
I log sono importanti per il monitoraggio e la risoluzione dei problemi del sito ArcGIS Notebook Server. Le informazioni contenute nei log consentono di individuare gli errori e forniscono contesto per risolvere i problemi e correggere gli errori. I log fungono anche da sistema di registrazione per gli eventi che si verificano nel sito.
Ad esempio, nei log vengono memorizzati i seguenti eventi:
- Eventi di installazione e aggiornamento, come autorizzazioni software e creazione di siti
- Apertura e chiusura delle sessioni di ArcGIS Notebook
- Attività di pulizia eseguite dal sito
- Eventi di gestione del sito eseguiti dagli amministratori, come aggiunta o rimozione di runtime, la creazione di directory sul server o configurazione delle impostazioni di sicurezza.
- Eventi di sicurezza, come accessi al sito da parte degli utenti o importazioni e esportazioni di certificati SSL.
Alcuni eventi non vengono memorizzati nei log ArcGIS Notebook Server. Tra questi, le operazioni di federazione e annullamento della federazione tra il sito e un portale. Gli eventi che si verificano all'interno delle sessioni di ArcGIS Notebook(aggiunta di contenuti, esecuzione di celle e così via) non vengono registrati. Non vengono registrati nemmeno gli eventi che si verificano all'interno dei contenitori Docker del computer; per visualizzare i log specifici dei contenitori, consultare la sezione Visualizzare i log dei contenitori Docker, di seguito.
Livelli di registrazione disponibili
Ogni log prevede un livello di dettaglio che può essere uno dei seguenti, ordinati dal meno dettagliato al più dettagliato:
- Grave: problemi gravi che richiedono attenzione immediata.
- Avvertenza: problemi moderati che richiedono attenzione.
- Informazioni: comuni messaggi amministrativi del sito di Notebook Server, compresi i messaggi sulla creazione e l'avvio dei servizi.
- Specifico: comuni messaggi generati dall'uso del portale, come il nome delle operazioni e le richieste ricevute.
- Dettagliato: messaggi contenenti dettagli su come il portale esegue le operazioni e risponde alle richieste.
- Debug: messaggi molto dettagliati destinati agli sviluppatori e ai tecnici dell'assistenza che vogliono conoscere meglio le condizioni del server per la risoluzione dei problemi. Non consigliato nei sistemi di produzione, a causa della grande quantità di log creati.
Nell'Administrator Directory di ArcGIS Notebook Server è possibile specificare il livello di registrazione più dettagliato da creare. Ad esempio, se si sceglie il Specifico, il sito del server registrerà i messaggi con livello di dettaglio Grave, Avvertenza, Informazioni e Specifico.
Accedere ai log del server e interrogarli
L'Administrator Directory di ArcGIS Notebook Server consente di interrogare, visualizzare, configurare ed eliminare i log del server.
Per accedere ai log, procedere come segue:
- Accedere all'Administrator Directory. Il formato dell'URL è https://notebookserver.domain.com:11443/arcgis/admino https://notebookserver.domain.com/<webadaptorname>/admin.
- Fare clic su Interrogazione > log per interrogare e visualizzare i log attuali. I filtri, nella pagina, consentono di limitare gli eventi in base alla categoria, come l'intervallo temporale o il livello di registrazione.
- Fare clic su Impostazioni > log per gestire le impostazioni dei log, come il livello di azione predefinito (come spiegato sopra), il tempo di conservazione dei log su disco e il percorso in cui i log vengono scritti.
- Fare clic su Cancella log per eliminare tutti i file dei log dal sito ArcGIS Notebook Server.
Visualizzare i log del contenitore Docker
È possibile visualizzare i log specifici dei contenitori Docker del proprio sito utilizzando l'interfaccia della riga di comando di Docker come segue.
- Accedere all'Administrator Directory. Il formato dell'URL è https://notebookserver.domain.com:11443/arcgis/admino https://notebookserver.domain.com/<webadaptorname>/admin.
- Passare a Contenitori > sistema. Individuare il contenitore di cui visualizzare i log e fare clic sull'ID corrispondente.
- Aprire la vista JSON della pagina delle informazioni del contenitore aggiungendo ?f=pjson al suo URL, in modo che il formato dell'URL sia https://notebookserver.arcgis.com/<webadaptorname>/admin/system/containers/<container>?f=pjson.
- Individuare il contenitore containerId e registrarne il valore.
- Accedere al prompt dei comandi come utente con privilegi Docker.
- Eseguire il comando docker logs <containerId> usando il valore registrato. Si otterranno così i log Docker specifici per quel contenitore.