Condividi tramite


Configurare la registrazione diagnostica in SharePoint Server

SI APPLICA A:yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint in Microsoft 365

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 di diagnostica nella stessa unità e partizione in cui è stato installato. Poiché la registrazione diagnostica può usare una grande quantità di spazio su disco e compromettere le prestazioni dell'unità, è necessario configurare SharePoint Server per scrivere in un'altra unità in cui SharePoint Server non è installato. È anche consigliabile considerare la velocità di connessione all'unità in cui SharePoint Server scrive i log. Se la registrazione a livello dettagliato è configurata, il server registra una grande quantità di dati. Pertanto, una connessione lenta potrebbe causare prestazioni di log scarse.

  • 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 registro di traccia. Ciò limita i tipi e la quantità di informazioni scritte in ogni log. Le tabelle seguenti definiscono i livelli di registrazione disponibili per il log eventi e 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. Tuttavia, possono fornire dati preziosi 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.
Alta
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.
Medio
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 PowerShell Set-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:

  4. Selezionare la casella di controllo Tutte le categorie.

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

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

  7. Selezionare le caselle relative alle categorie desiderate.

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

  9. 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):

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

  11. Selezionare la casella di controllo della sottocategoria.

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

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

  14. Selezionare la casella di controllo Tutte le categorie.

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

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

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

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

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

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

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

Configurare la registrazione diagnostica tramite PowerShell

È possibile utilizzare PowerShell per configurare la registrazione diagnostica.

Per configurare la registrazione diagnostica tramite 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 per il server in cui vengono eseguiti i cmdlet diPowerShell.

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

    Nota

    [!NOTA] Se non si dispone delle autorizzazioni, richiederle all'amministratore per l'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
  1. Per visualizzare il livello di registrazione corrente, al prompt dei comandi di PowerShell digitare il seguente comando:

    Get-SPLogLevel
    
  2. 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
  1. 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.

Vedere anche

Concetti

Panoramica del monitoraggio in SharePoint Server 2016