Configurare la registrazione diagnostica in SharePoint Server

 

**Si applica a:**SharePoint Server 2016

**Ultima modifica dell'argomento:**2017-07-31

Riepilogo: informazioni sulla configurazione della registrazione diagnostica in SharePoint Server 2013 e SharePoint Server 2016 dal sito Web Amministrazione centrale SharePoint o mediante Windows PowerShell.

Contenuto dell'articolo:

• Prima di iniziare

• Procedure consigliate per l'impostazione della registrazione diagnostica

• Configurare la registrazione diagnostica mediante Amministrazione centrale

• Configurare la registrazione diagnostica mediante Windows PowerShell

Prerequisiti

L'account utente utilizzato per eseguire queste procedure da Amministrazione centrale deve essere un membro del gruppo Amministratori farm di SharePoint.

Procedure consigliate per l'impostazione della registrazione diagnostica

È possibile che nell'ambiente SharePoint Server sia necessaria la configurazione delle impostazioni di registrazione diagnostica in seguito alla distribuzione iniziale, all'aggiornamento e in caso di modifiche apportate all'ambiente, ad esempio l'aggiunta o la rimozione di un server. Le linee guida contenute nell'elenco seguente consentono di individuare le procedure consigliate per l'ambiente specifico.

• Modificare l'unità in cui il server scrive i log.

  Per impostazione predefinita, SharePoint Server scrive i log diagnostici nella stessa unità e nella stessa partizione in cui è stata eseguita l'installazione. Dal momento che la registrazione diagnostica può comportare l'utilizzo di una grande quantità di spazio nell'unità e comprometterne le prestazioni, è necessario configurare SharePoint Server in modo che esegua la scrittura in un'altra unità in cui non è installato SharePoint Server. È inoltre necessario valutare la velocità di connessione in riferimento all'unità in cui SharePoint Server scrive i log. Se è stata configurata una registrazione con livello dettagliato, il server registrerà una grande quantità di dati e una connessione lenta potrebbe pertanto comportare una riduzione delle prestazioni della registrazione.

• Limitare lo spazio su disco utilizzato per i log.

  Per impostazione predefinita, la quantità di spazio su disco che può essere utilizzato dalla registrazione diagnostica è illimitata. È pertanto necessario limitare lo spazio su disco utilizzato dalla registrazione, in particolar modo se la registrazione è configurata per la scrittura degli eventi con livello dettagliato. Quando il disco raggiunge il limite massimo consentito, prima di registrare i nuovi dati di registrazione SharePoint Server rimuove i log precedenti.

• Utilizzare l'impostazione Dettagliato solo in casi particolari.

  È possibile configurare la registrazione diagnostica per gli eventi con livello dettagliato. In questo caso SharePoint Server registrerà qualsiasi azione eseguita. La registrazione con livello dettagliato può comportare un notevole utilizzo dello spazio sull'unità nonché compromettere le prestazioni dell'unità e del server. È possibile utilizzare la registrazione con livello dettagliato per registrare una maggiore quantità di dettagli durante l'esecuzione di modifiche critiche e, dopo tali modifiche, riconfigurare la registrazione solo per gli eventi di livello superiore.

• Eseguire regolarmente il backup dei log.

  I log diagnostici contengono dati importanti. È pertanto necessario eseguire regolarmente il backup dei log per garantire la conservazione dei dati. Se si limita l'utilizzo dello spazio sull'unità per la registrazione o se i log vengono conservati solo per qualche giorno, al raggiungimento della soglia SharePoint Server elimina automaticamente i file di log, partendo dai meno recenti.

• Abilitare la protezione da attacchi flood al registro eventi.

  Quando viene abilitata questa impostazione, SharePoint Server rileva gli eventi ripetuti nel registro eventi di Windows e ne impedisce la visualizzazione fino a quando non vengono ripristinate le condizioni normali.

È possibile impostare il livello di registrazione diagnostica per il registro eventi e per il log di traccia in modo da limitare i tipi e la quantità di informazioni scritte in ogni log. Nelle tabelle seguenti vengono definiti i livelli di registrazione disponibili per il registro eventi e per il log di traccia.

Livelli del registro eventi

Livello	Definizione
Nessuno	Non viene eseguita alcuna registrazione.
Critico	Questo tipo di messaggio indica un errore grave che ha determinato un problema serio nella soluzione.
Errore	Questo tipo di messaggio indica una condizione urgente. È necessario analizzare approfonditamente tutti gli eventi di errore.
Avviso	Questo tipo di messaggio indica un potenziale problema che può richiedere attenzione. È consigliabile esaminare i messaggi di avviso e tenerne traccia per individuare eventuali schemi nel tempo.
Informazioni	I messaggi informativi non richiedono alcuna azione, ma possono tuttavia fornire dati utili per il monitoraggio dello stato della soluzione.
Dettagliato	Questo livello del registro eventi corrisponde a eventi o messaggi estesi.

Livelli del log di traccia

Livello	Definizione
Nessuno	Non viene scritto alcun evento nel log di traccia.
Evento imprevisto	Questo livello registra messaggi relativi a eventi che comportano l'interruzione dell'elaborazione delle soluzioni. Se impostato su questo livello, il log includerà eventi con livelli Evento imprevisto, Eccezione, Asserzione e Critico.
Evento monitorabile	Questo livello registra messaggi relativi a eventi irreversibili che limitano la funzionalità della soluzione ma non comportano l'interruzione dell'applicazione. Se impostato su questo livello, il log includerà anche eventi registrati dall'impostazione Evento imprevisto.
Alto	Questo livello registra eventi imprevisti che tuttavia non interrompono l'elaborazione di una soluzione. Se impostato per la registrazione a questo livello, il log includerà anche tutti gli eventi registrati dall'impostazione Evento monitorabile.
Media	Quando è impostato su questo livello, il log di traccia include tutti i messaggi, tranne quelli con livello Dettagliato e Dettagliato esteso. Questo livello registra tutte le informazioni di livello elevato relative alle operazioni che sono state eseguite. Questo livello fornisce dettagli sufficienti per creare il flusso di dati e la sequenza delle operazioni. Questo livello di registrazione può essere utilizzato dagli amministratori o dal personale di supporto tecnico per la risoluzione dei problemi. Se impostato su questo livello, il log includerà anche tutti gli eventi registrati dall'impostazione Alto.
Dettagliato	Quando è impostato su questo livello, il log include quasi tutte le azioni. La traccia con livello dettagliato genera numerosi messaggi di log. Questo livello in genere viene utilizzato solo per il debug in un ambiente di sviluppo. Se impostato per la registrazione a questo livello, il log includerà anche tutti gli eventi registrati dall'impostazione Medio.
VerboseEx	Questo livello è supportato solo dal cmdlet PowerShellSet-SPLogLevel e include dati di diagnostica di livello molto basso. È consigliabile utilizzare questo livello solo in un ambiente di sviluppo. Se impostato su questo livello, il log includerà anche eventi registrati dall'impostazione Dettagliato.

Configurare la registrazione diagnostica mediante Amministrazione centrale

È possibile utilizzare il sito Web Amministrazione centrale SharePoint per configurare la registrazione diagnostica.

Per configurare la registrazione diagnostica mediante Amministrazione centrale

1. Nella home page di Amministrazione centrale fare clic su Monitoraggio.

2. Nella sezione Report della pagina Monitoraggio fare clic su Configura registrazione diagnostica.

3. Nella sezione Limitazione eventi della pagina Registrazione diagnostica configurare la limitazione degli eventi come segue:

   Per configurare la limitazione degli eventi per tutte le categorie:

   1. Selezionare la casella di controllo Tutte le categorie.

   2. Selezionare il livello del registro eventi nell'elenco Evento meno critico da includere nel registro eventi.

   3. Selezionare il livello del log di traccia nell'elenco Evento meno critico da includere nel log di traccia.

   Per configurare la limitazione degli eventi per una o più categorie:

   1. Selezionare le caselle relative alle categorie desiderate.

   2. Selezionare il livello del registro eventi nell'elenco Evento meno critico da includere nel registro eventi.

   3. Selezionare il livello del log di traccia nell'elenco Evento meno critico da includere nel log di traccia.

   Per configurare la limitazione degli eventi per una o più sottocategorie (è possibile espandere una o più categorie e selezionare una sottocategoria):

   1. Fare clic sul segno più (+) accanto alla categoria per espanderla.

   2. Selezionare la casella di controllo della sottocategoria.

   3. Selezionare il livello del registro eventi nell'elenco Evento meno critico da includere nel registro eventi.

   4. Selezionare il livello del log di traccia nell'elenco Evento meno critico da includere nel log di traccia.

   Per ripristinare le impostazioni predefinite della limitazione degli eventi per tutte le categorie:

   1. Selezionare la casella di controllo Tutte le categorie.

   2. Selezionare Ripristina impostazioni predefinite nell'elenco Evento meno critico da includere nel registro eventi.

   3. Selezionare Ripristina impostazioni predefinite nell'elenco Evento meno critico da includere nel log di traccia.

4. Nella sezione Protezione da attacchi flood al registro eventi selezionare la casella di controllo Abilita protezione da attacchi flood al registro eventi.

5. Nella sezione Log di traccia della casella Percorso digitare il percorso della cartella in cui si desidera scrivere i log.

6. Nella casella Numero di giorni di archiviazione dei file di log digitare il numero di giorni (1-366) per cui si desidera conservare i log. Al termine di questo periodo, i log verranno eliminati automaticamente.

7. Per limitare la quantità di spazio su disco utilizzata dai log, selezionare la casella di controllo Limita utilizzo spazio su disco per i log di traccia e digitare il numero massimo di gigabyte (GB) per i file di log. Al raggiungimento di questo valore, i log meno recenti verranno eliminati automaticamente.

8. Dopo aver apportato le modifiche desiderate nella pagina Registrazione diagnostica, fare clic su OK.

Configurare la registrazione diagnostica mediante Windows PowerShell

È possibile utilizzare PowerShell per configurare la registrazione diagnostica.

Per configurare la registrazione diagnostica mediante Windows PowerShell

1. Verificare di essere membri dei ruoli e dei gruppi seguenti:

   • Ruolo predefinito del server securityadmin nell'istanza di SQL Server.

   • Ruolo predefinito del database db_owner in tutti i database da aggiornare.

   • Gruppo Administrators nel server in cui si eseguono i cmdlet di PowerShell.

   Un amministratore può utilizzare il cmdlet Add-SPShellAdmin per concedere le autorizzazioni per l'utilizzo dei cmdlet di PowerShell.

   Nota

   Se non si dispone delle autorizzazioni, richiederle all'amministratore dell'installazione o all'amministratore di SQL Server. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

2. Da SharePoint Management Shell, cambiare l'unità in cui il server scrive log.

3. Al prompt dei comandi di PowerShell digitare il comando seguente:

   Set-SPDiagnosticConfig -LogLocation D:\DiagnosticLogs
   

4. Per limitare la quantità di spazio su disco utilizzata dai log, al prompt dei comandi di PowerShell digitare il comando seguente:

   Set-SPDiagnosticConfig -LogMaxDiskSpaceUsageEnabled
   

   In alternativa, assegnare ai log la quantità massima consentita di spazio su disco:

   Set-SPDiagnosticConfig -LogDiskSpaceUsageGB 500
   

5. Per visualizzare il livello di registrazione corrente, al prompt dei comandi di PowerShell digitare il seguente comando:

   Get-SPLogLevel
   

6. Per modificare il livello di registrazione, al prompt dei comandi di PowerShell digitare il comando seguente:

   Set-SPLogLevel -TraceSeverity Monitorable
   

   Per ripristinare i valori predefiniti per tutte le categorie, al prompt dei comandi di PowerShell digitare il comando seguente e quindi premere INVIO:

   Clear-SPLogLevel
   

7. Per abilitare la protezione da attacchi flood al registro eventi, al prompt dei comandi di PowerShell digitare il comando seguente:

   Set-SPDiagnosticConfig -EventLogFloodProtectionEnabled
   

Per altre informazioni, vedere Set-SPDiagnosticConfig, Set-SPLogLevel e Get-SPLogLevel.

See also

Panoramica del monitoraggio in SharePoint Server 2016