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 di ArcGIS Notebooks
- Attività di pulizia eseguite dal sito
- Eventi di gestione del sito eseguiti dagli amministratori, ad esempio l'aggiunta o la rimozione di runtime di notebook, la creazione di directory sul server o configurazione delle impostazioni di sicurezza.
- Eventi di sicurezza, ad esempio l'accesso al sito da parte degli utenti o importazioni ed esportazioni di certificati SSL
Alcuni eventi non vengono memorizzati nei log ArcGIS Notebook Server. Tra questi, le operazioni di federazione tra il sito e un portale. Gli eventi che si verificano all'interno di ArcGIS Notebooks(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: messaggi comuni generati dall'uso del portale, ad esempio 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.
Codici dei log
Gli intervalli di codici log sono associati ad alcuni tipi di messaggi. La seguente tabella descrive gli intervalli di codici log e il relativo tipo di contenuto.
| Intervallo di codici log | Contenuto dei messaggi |
|---|---|
1000-4999 | Framework ArcGIS Notebook Server di base |
5000-6999 | SDK Docker e contenitore correlato |
7000-7200 | Appunti |
7200-7299 | Strumenti Web di notebook |
7300-7399 | Snapshot di notebook |
7400-7499 | Frammenti di codice di notebook |
Log delle interrogazioni in Manager
A partire dalla versione 10.8 di ArcGIS Notebook Server, Manager include una pagina Log. Su questa pagina, è possibile interrogare tutti i log per il sito ArcGIS Notebook Server.
- Effettuare l'accesso al portale ArcGIS Enterprise come amministratore e aprire ArcGIS Notebook Server Manager.
- Apre la pagina Log.
- I parametri di filtro delle interrogazioni si trovano in cima alla pagina. Utilizzare uno dei parametri per limitare o espandere la ricerca.
- Livello di log: il livello di log minimo per cui eseguire interrogazioni (consultare la sezione precedente). Restituisce solo le registrazioni con un livello dei log pari o superiore a questo livello. Il livello predefinito è WARNING.
- Tempo di log: il tempo per cercare log. È possibile limitare un'interrogazione agli ultimi 15 minuti, l'ultima ora, le ultime sei o 24 ore, l'ultima settimana o gli ultimi 30 giorni, oppure mostrare tutti i log sin dalla creazione del sito.
Suggerimento:
Usare la Administrator Directory per interrogare i log se si desidera specificare una data/ora di fine diversa da quella presente, come ad esempio log tra i tre e i due giorni precedenti.
- Computer: limitare l'interrogazione ai log di uno dei computer ArcGIS Notebook Server o mostrare i log di tutti i computer.
- ID richiesta: gli ID richiesta separati da virgole di una o più richieste server di cui si desidera interrogare i log. Alcuni messaggi dei log sono correlati all'azione di una specifica richiesta.
- Utenti: il nome utente di uno o più utenti (separati da virgole) di cui si desidera interrogare i log correlati. Alcuni messaggi dei log sono correlati all'azione di un utente specifico.
- Codici di log: uno o più codici di log assegnati a un messaggio di log. Se lasciato vuoto, vengono mostrati tutti i codici dei log.
- Fare clic su Cerca per eseguire l'interrogazione. Nella tabella risultante saranno mostrati tutti i log corrispondenti ai parametri di interrogazione.
Cambiare le impostazioni dei log in Manager
È anche possibile usare ArcGIS Notebook Server Manager per cambiare le impostazioni dei log per il sito.
- Effettuare l'accesso al portale ArcGIS Enterprise come amministratore e aprire ArcGIS Notebook Server Manager.
- Aprire la pagina Impostazioni e fare clic su Log.
- È possibile cambiare le seguenti impostazioni:
- Directory di log: la posizione su disco della directory dei log. Se sul sito ci sono più computer, verificare che questo percorso sia una condivisione UNC.
- Livello di log: il livello di log più dettagliato che verrà scritto dal sito. Se è impostato su FINE, ad esempio, il sito non conserva i log ai livelli VERBOSE o DEBUG.
- Giorni di conservazione dei log: il numero di giorni dopo di che i messaggi di log verranno eliminati. Considerare la memoria disponibile nell'unità della directory dei log e l'impostazione Livello di log scelta, nonché il livello di attività sul sito. Ad esempio, se si cambia il livello dei log per iniziare a scrivere a un livello più dettagliato, potrebbe essere necessario diminuire il numero di giorni in cui i log vengono mantenuti.
- Fare clic su Salva per confermare le modifiche.
Interrogare i log del server nella Administrator Directory
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. L'URL è formattato https://notebookserver.domain.com:11443/arcgis/admin o 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.
Visualizza i log del contenitore di Docker con Manager ArcGIS Notebook Server
Puoi visualizzare i log specifici dei contenitori Docker del tuo sito usando ArcGIS Notebook Server Manager.
- Accedere a ArcGIS Notebook Server Manager del portale come amministratore. Il formato dell'URL è https://webadaptorhost.domain.com/webadaptorname/home/notebook/manager.html.
- Passare alla scheda Contenitori.
- Fare clic sul pulsante Visualizza log per visualizzare i log del contenitore della macchina scelta.
Visualizzare i log del contenitore Docker con la riga di comando Docker
Puoi visualizzare i log specifici dei container del tuo sito Docker usando l'interfaccia a riga di comando Docker come segue.
- Accedere all'Administrator Directory. L'URL è formattato https://notebookserver.domain.com:11443/arcgis/admin o https://notebookserver.domain.com/<webadaptorname>/admin.
- Navigare fino a System > Containers. Individua il contenitore di cui vuoi visualizzare i log e clicca sul suo ID.
- Apri la vista JSON della pagina informativa 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.
- Individua il contenitore containerId e registrare il suo valore.
- Apri un terminale come utente con privilegi Docker.
- Eseguire il comando docker logs <containerId> usando il valore registrato. Questo restituirà i log Docker specifici di quel contenitore.