Utilizzare i log dell'organizzazione

Il monitoraggio dei log dell'organizzazione è utile per individuare gli errori e risolvere i problemi dell'organizzazione. Utilizzare la directory di amministratore di ArcGIS Portal per visualizzare, interrogare, configurare ed eliminare i log dell'organizzazione. La directory di Portal Administrator aggrega i messaggi dei log in una tabella consultabile e modificabile.

Gli eventi registrati per ogni componente dell'organizzazione sono accessibili dalla directory di amministratore di Portal. Potrebbe ancora essere necessario usare ArcGIS Server Manager per specificare le impostazioni di log del server, eliminare i log del server e usare tutte le opzioni di filtro.

Le sezioni di questo argomento descrivono i log dell'organizzazione e come utilizzarli per risolvere eventuali problemi.

• Acquisire, interrogare e visualizzare eventi
• Utilizzare i filtri evento nelle interrogazioni per limitare i risultati della ricerca
• Eliminare i log

Acquisire, interrogare e visualizzare eventi

Quando nell'organizzazione si verifica un evento, questo viene acquisito e registrato nei log. Per visualizzare i messaggi associati all'evento, interrogare i log. Per interrogare e visualizzare i messaggi correnti dell'organizzazione, attenersi alla procedura seguente:

1. Aprire Portal Administrator Directory e accedere come amministratore. In genere l'URL è disponibile in https://webadaptorhost.example.com/webadaptorname/portaladmin.
2. Fare clic su Log > Interrogazione.
3. Lasciare tutte le impostazioni predefinite e fare clic su Interrogazione.

Vengono restituiti alcuni messaggi con ulteriori informazioni. Ad esempio, se un utente immette troppe volte la password errata e il suo account viene bloccato, si visualizzeranno i seguenti messaggi:

Nello scenario precedente, l'utente john_cho sta tentando di accedere inserendo una password errata. Dopo cinque tentativi, l'account è stato bloccato in base ai criteri vigenti. Ciò potrebbe anche indicare il tentativo di danneggiamento di accedere all'organizzazione.

Tutti gli eventi registrano le informazioni specificate in precedenza, come il livello dei log, l'ora in cui l'evento si è verificato, il componente originario che ha determinato la registrazione, il computer su cui l'evento si è verificato, l'utente associato all'evento, il codice log, l'ID processo e l'ID richiesta. Tutte queste informazioni possono essere utili per risolvere i problemi dell'organizzazione in modo più efficiente. Per una spiegazione dettagliata di queste informazioni, vedere Conoscere i log.

Quando si sospetta un'anomalia

Se si sospetta l'esistenza di un problema con l'organizzazione o se un utente segnala un problema, acquisire l'evento con i log, interrogare i log per ottenere informazioni sull'evento, quindi utilizzare le informazioni contenute nel log per contribuire a risolvere il problema causato dall'evento.

Se si sospetta l'esistenza di un problema o se viene comunicato un problema, utilizzare il seguente albero decisionale per acquisire meglio l'evento mediante i log:

• Provare a riprodurre il problema:
  • Se il problema può essere riprodotto, esaminare i log ed esaminare i messaggi per ottenere informazioni sul problema:
    1. Se nessuna informazione è presente, innalzare il livello dei log. Riprodurre di nuovo il problema, interrogare i log ed esaminare i messaggi.
    2. Se i messaggi di log contengono informazioni, esaminarle per semplificare la risoluzione del problema.
  • Se il problema non può essere riprodotto, prendere nota dello scenario che ha condotto al problema nel caso in cui si ripresenti.

Suggerimento:

Se si sospetta che il problema riguardi più componenti, si consiglia di selezionare i server federati durante l'interrogazione dei layer. I log del server e i log ArcGIS Data Store possono fornire ulteriori informazioni utili per la risoluzione dei problemi.

Di seguito sono riportati alcuni esempi di acquisizione di eventi, interrogazione e individuazione degli eventi mediante i log.

• L'utente non può aggiungere un allegato al feature service
• L'utente ha specificato un nome utente o una password non validi.
• L'elemento è stato spostato in un'altra cartella
• L'organizzazione è impostata in sola lettura

L'utente non può aggiungere un allegato al feature service

In questo esempio, un utente riferisce di non poter aggiungere un allegato a un feature service. L'utente ha effettuato numerosi tentativi e non è possibile caricare il file. Per acquisire questo tipo di evento si deve prima impostare il livello di log del portale su INFO:

Una volta che il portale registra i messaggi a livello INFO, completare la procedura seguente:

1. Chiedere all'utente di riprodurre il problema e di registrare i passaggi e il periodo di tempo occorso per riprodurre il problema.
2. Aprire Portal Administrator Directory e accedere come amministratore. In genere l'URL è disponibile in https://webadaptorhost.example.com/webadaptorname/portaladmin.
3. Fare clic su Log > Interrogazione.
   1. Specificare i valori orari ottenuti dall'utente. Il formato è yyyy-mm-ddThh:mm:ss. Ad esempio, l'ora di inizio è2015-05-10T14:05:00 e l'ora di fine è 2015-05-10T14:03:00.
   2. Specificare l'interrogazione per ottenere messaggi al livello dei log INFO.
   3. Nel campo Utenti, specificare il nome utente del membro. Ad esempio, jchoper John Cho.
   4. Fare clic su Interrogazione.
4. Esaminare il campo Messaggio per verificare se contiene messaggi correlati al problema.

Viene visualizzato il seguente messaggio:

Failed to add attachment. File size limit of 20 MB exceeded for feature service '/gis/rest/services/Hosted/parks3k_19/FeatureServer/0/1/addAttachment'.

Ora è chiaro che l'utente ha tentato di caricare un file che supera il limite per la dimensione dei file. Invitare l'utente a ridurre la dimensione del file a meno di 20 MB.

L'utente ha specificato un nome utente o una password non validi.

Per acquisire questo tipo di evento si deve prima impostare il livello di log del portale su AVVERTENZA o su un livello inferiore.

Una volta che il portale registra i messaggi a livello AVVERTENZA, completare la procedura seguente:

1. Aprire la directory di Portal Administrator e accedere come amministratore. In genere l'URL è disponibile in https://webadaptorhost.example.com/webadaptorname/portaladmin.
2. Fare clic su Log > Interrogazione.
3. Controllare che il livello di log sia impostato sul livello AVVERTENZA. Ignorare tutti gli altri campi perché l'operazione comporta la restituzione di messaggi di livello "avviso" per tutti gli utenti.
4. Esaminare il campo Messaggio per verificare se contiene messaggi correlati al problema.

Viene visualizzato il seguente messaggio:

Sign in error: Invalid username or password specified for 'asmith'.

Questo messaggio comunica che l'utente asmith (Ashley Smith) ha specificato un nome utente o una password non validi nel tentativo di accedere all'organizzazione. Monitorare questi eventi per impedire tentativi di accesso non autorizzato.

L'elemento è stato spostato in un'altra cartella

Per acquisire questo tipo di evento si deve prima impostare il livello di log del portale su INFO:

Una volta che il portale registra i messaggi a livello INFO, completare la procedura seguente:

1. Aprire la directory di Portal Administrator e accedere come amministratore. In genere l'URL è disponibile in https://webadaptorhost.example.com/webadaptorname/portaladmin.
2. Fare clic su Log > Interrogazione.
3. Controllare che il livello di log sia impostato su INFO. Ignorare tutti gli altri campi perché l'operazione comporta di messaggi di livello "info" per tutti gli utenti dal momento in cui si imposta il livello.
4. Fare clic su Interrogazione.
5. Esaminare il campo Messaggio per verificare se contiene messaggi correlati al problema.

Viene visualizzato il seguente messaggio:

Item moved from folder 'jcho/(Home)' to folder 'jcho/(Home)/Utilities'. Item ID is 'b7557bd2691b4e74bc4ce3e373402cc6'.

Questo messaggio comunica che l'utente jcho (John Cho) ha spostato un elemento (con ID b7557bd2691b4e74bc4ce3e373402cc6) dalla propria cartella principale (Home) alla una sottodirectory delle cartella denominata Utilities.

L'organizzazione è impostata in sola lettura

Per acquisire cosa accade in tutti i componenti quando s'imposta l'organizzazione in modalità di sola lettura, si deve prima impostare il livello di log per i componenti su INFO o su un livello inferiore. Vedere Specificare le impostazioni di log del portale e Specificare le impostazioni di log del server per ulteriori informazioni.

Una volta che i componenti registrano i messaggi al livello INFO o inferiore e l'organizzazione è impostata in modalità di sola lettura, completare la seguente procedura:

1. Aprire la directory di Portal Administrator e accedere come amministratore. In genere l'URL è disponibile in https://webadaptorhost.example.com/webadaptorname/portaladmin.
2. Fare clic su Log > Interrogazione.
3. Controllare che il livello di log sia impostato su INFO e fare clic su Interrogazione.
4. Individuare il messaggio indicante che l'organizzazione è stata impostata in sola lettura e annotare l'ID di richiesta di quel messaggio.

   Successfully set the organization to read-only mode

5. Fare clic su Interrogazione per tornare ai messaggi di log dell'interrogazione.
6. Immettere l'ID di richiesta annotato al passaggio 4 nel campo RequestIDs.
7. Seleziona Tutti nel campo Server federati.
8. Fare clic su Interrogazione e rivedere i log in tutti i componenti correlati al posizionamento dell'organizzazione in modalità di sola lettura.

Utilizzo dei filtri evento in un'interrogazione per limitare i risultati della ricerca

Per limitare gli eventi e a visualizzare messaggi più pertinenti, è possibile eseguire interrogazioni basate sul livello di log, sul componente di origine, sull'ora, su uno specifico codice log o un intervallo di codici, uno specifico utente o un elenco di utenti e sull'ID richiesta. In un'interrogazione è possibile combinare un numero qualsiasi di questi filtri.

Per interrogare tutti i messaggi di log dell'organizzazione, è possibile selezionare i server federati. Ora e ID richiesta possono essere usati per filtrare i messaggi di log tra i componenti mentre gli altri parametri filtrano solo i log del portale. Per ulteriori opzioni di filtraggio dei log del server, è possibile usare ArcGIS Server Manager.

Per accedere a questi filtri, effettuare l'accesso a Portal Administrator Directory e fare clic su Home > Log > Interrogazione.

Livello dei log

Il livello di dettaglio degli eventi varia da Grave (indicativo di un problema che richiede attenzione immediata) a Dettagliato: quest'ultimo evento consiste in un messaggio informativo dettagliato generato dall'uso regolare del portale. Selezionare il livello desiderato dall'elenco a discesa Livello log. Per il riepilogo dettagliato dei singoli livelli, vedere Tipo di log.

Origine

Origini da cui gli eventi registrati vengono generati (componenti software per la condivisione o l'amministrazione e componenti software del portale). Ad esempio:

• Gli eventi correlati alla pubblicazione e agli utenti sono classificati come Condivisione.
• Gli eventi correlati alla sicurezza e all'indicizzazione sono classificati come Amministrazione portale.
• Gli eventi correlati all'installazione del software sono classificati come Portale.

Per impostazione predefinita, vengono interrogate tutte le origini (opzione Tutto dell'elenco a discesa). Per filtrare gli eventi del portale in base a un'origine specifica, selezionare l'origine desiderata dall'elenco a discesa Origine.

Tempo

Per filtrare gli eventi di uno specifico intervallo di tempo, indicare i valori orari desiderati mediante i campi Ora di inizio e Ora di fine (il formato è yyyy-mm-ddThh:mm:ss). L'ora di inizio è quella più recente e l'ora di fine è quella meno recente. Ad esempio:

• Per definire un intervallo di tempo di quindici minuti, l'ora di inizio è 2015-05-01T13:15:00 e l'ora di fine è 2015-05-01T13:00:00.
• Per definire un intervallo di tempo di un'ora, l'ora di inizio è 2015-05-01T14:00:00 e l'ora di fine è 2015-05-01T13:00:00.
• Per definire un intervallo di tempo di un giorno, l'ora di inizio è2015-05-02T12:00:00 e l'ora di fine è2015-05-01T12:00:00.
• Per interrogare tutti i log, lasciare vuoti i campi dell'ora.

Se l'ora di inizio è specificata e quella di fine non lo è, vengono restituiti tutti i log più vecchi, fino all'ora di inizio specificata. Viceversa, se l'ora di inizio non è specificata e quella di fine è specificata, vengono restituiti tutti i log più recenti, fino all'ora di fine specificata.

Se selezionati, vengono filtrati anche gli eventi registrati per i server federati.

Codici dei log

Ogni messaggio è associato a un codice log. I codici sono organizzati in varie categorie. È possibile filtrare i logo del portale in base a uno specifico codice o a un intervallo di codici, ad esempio:

• Per filtrare in base a un singolo codice, specificare il relativo valore (ad esempio,204028).
• Per filtrare in base a specifici codici, separarli mediante una virgola (,) (ad esempio, 204028, 212015, 219114).
• Per filtrare in base a un intervallo di codici, ad esempio tutti i codici della categoria "sicurezza", specificare il codice iniziale e quello finale separati da un trattino (-) (ad esempio,204000–205999).
• Per filtrare in base a un intervallo di codici e a codici singoli, specificare il codice iniziale e quello finale (separati da un trattino) e separare i codici singoli mediante una virgola (ad esempio,204000–205999, 212015, 219114).

Utenti

Per filtrare gli eventi del portale in base a uno specifico utente, indicare il nome utente desiderato nel campo Utenti, ad esempio:

• Per filtrare in base a uno specifico utente, indicare il nome utente (ad esempio jcho per John Cho).
• Per filtrare in base a più utenti, separare i nomi utente mediante una virgola (,) (ad esempio jcho, asmith per John Cho e Ashley Smith).

Nota:

L'uso dei caratteri jolly (*) non è supportato.

ID richiesta

La stringa dell'ID univoco collegato a ogni richiesta effettuata, nell'intero ciclo di vita della richiesta nel sistema. Selezionare uno o tutti i server federati se si filtra per ID richiesta per un'operazione che interessa più componenti.

Conteggio messaggi

Numero di messaggi da visualizzare quando si effettua un'interrogazione. I messaggi sono visualizzati su una pagina Web singola. Se necessario, scorrere la pagina verso il basso per visualizzare tutti i messaggi.

Server federati

Per risolvere i problemi od ottenere approfondimenti sulle operazioni che interessano più componenti di ArcGIS Enterprise, includere i log del server nell'interrogazione selezionando uno o tutti i server federati. Quando si interrogano i log del server di hosting, vengono inclusi anche i log di ArcGIS Data Store.

Eliminare i log

Per eliminare i log, fare clic su Home > Log > Pulisci > Pulisci log. In questo modo vengono eliminati tutti i messaggi dal computer del portale. Quando si esegue il debug di uno specifico scenario che causa problemi del portale, eliminare i log può contribuire a isolare il problema. In questo modo, vengono cancellati tutti gli altri eventi, consentendo all'utente di concentrarsi sul debug del problema corrente.

Per eliminare i log del server, utilizzare ArcGIS Server Manager.