Skip To Content

Lavorare con i log ArcGIS Notebook Server

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 logContenuto 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.

  1. Effettuare l'accesso al portale ArcGIS Enterprise come amministratore e aprire ArcGIS Notebook Server Manager.
  2. Apre la pagina Log.
  3. 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.

  4. 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.

  1. Effettuare l'accesso al portale ArcGIS Enterprise come amministratore e aprire ArcGIS Notebook Server Manager.
  2. Aprire la pagina Impostazioni e fare clic su Log.
  3. È 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.

  4. 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:

  1. Accedere all'Administrator Directory. L'URL è formattato https://notebookserver.domain.com:11443/arcgis/admin o https://notebookserver.domain.com/<webadaptorname>/admin.
  2. 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.
  3. 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.
  4. 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.

  1. Accedere a ArcGIS Notebook Server Manager del portale come amministratore. Il formato dell'URL è https://webadaptorhost.domain.com/webadaptorname/home/notebook/manager.html.
  2. Passare alla scheda Contenitori.
  3. 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.

  1. Accedere all'Administrator Directory. L'URL è formattato https://notebookserver.domain.com:11443/arcgis/admin o https://notebookserver.domain.com/<webadaptorname>/admin.
  2. Navigare fino a System > Containers. Individua il contenitore di cui vuoi visualizzare i log e clicca sul suo ID.
  3. 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.
  4. Individua il contenitore containerId e registrare il suo valore.
  5. Apri un terminale come utente con privilegi Docker.
  6. Eseguire il comando docker logs <containerId> usando il valore registrato. Questo restituirà i log Docker specifici di quel contenitore.