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 tramite la sezione della linea di comando di Docker.
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 |
Registrazioni delle interrogazioni in ArcGIS Notebook Server 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 registrazione: il livello di registrazione 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 6 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 registrazione 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.
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.
- Aprire il Prompt dei comandi come utente con privilegi Docker.
- Eseguire il comando docker logs <containerId> usando il valore registrato. Questo restituirà i log Docker specifici di quel contenitore.