Visualizzare i log diagnostici in SharePoint

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

È possibile risolvere i problemi della farm utilizzando i dati dei log del Servizio di registrazione unificato in SharePoint Server. I registri del Servizio di registrazione unificato raccolgono dati a vari livelli in base alle impostazioni di registrazione. Utilizzare PowerShell per filtrare i dati, visualizzarli in diversi modi e organizzarli in una griglia tramite la quale filtrare, ordinare, raggruppare ed esportare i dati in Excel 2016.

Visualizzare e filtrare gli eventi di log tramite PowerShell

È possibile utilizzare PowerShell per visualizzare e filtrare gli eventi nei registri. Non è possibile eseguire queste operazioni tramite il sito Web Amministrazione centrale SharePoint.

Per visualizzare e filtrare gli eventi di log 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.

    Nota

    [!NOTA] Se non si dispone delle autorizzazioni, richiederle all'amministratore per l'installazione o all'amministratore di SQL Server. Per ulteriori informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

  1. Andare a Management Shell di SharePoint.

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

  • Tutti gli eventi di traccia:
Get-SPLogEvent
  • Per livello:
Get-SPLogEvent | Where-Object {$_.Level -eq "Information" }
  • Per area:
Get-SPLogEvent | Where-Object {$_.Area -eq <Area>}

Dove <Area> è il valore della proprietà Area .

  • Per categoria:
Get-SPLogEvent | Where-Object {$_.Category -eq <Category>

Dove <Category> è il valore della proprietà Category .

  • Per ID evento:
Get-SPLogEvent | Where-Object {$_.EventID -eq <EventID>}

Dove <EventID> è il valore della proprietà EventID .

  • Per testo del messaggio:
Get-SPLogEvent | Where-Object {$_.Message -like "<string>"}

Dove <stringa> è la stringa trovata nel messaggio di evento.

  • Per processo:
Get-SPLogEvent | Where-Object {$_.Process -like "<Process>"}

Dove <Process> è il valore della proprietà Process .

Per impostazione predefinita, il comando recupera i dati dalla cartella predefinita dei registri ULS. Per visualizzare e filtrare gli eventi di traccia che si trovano in una cartella condivisa in rete, utilizzare il parametro Directory del cmdlet Get-SPLogEvent.

Per visualizzare altri dettagli su ogni evento di traccia, usare il cmdlet Format-List alla fine del comando. Ad esempio,

Get-SPLogEvent | Where-Object {$_.Area -eq "SharePoint Foundation"} | Format-List

Per ulteriori informazioni, vedere Get-SPLogEvent.

Visualizzare ed esportare i log di diagnostica usando il cmdlet Out-GridView di PowerShell

PowerShell offre una funzionalità potente e facile da usare che visualizza i dati tabulari risultanti dai comandi di PowerShell in una griglia di dati filtrabile e ricercabile in una finestra separata. È possibile utilizzare questa griglia per visualizzare eventi dei registri ed eseguire le operazioni seguenti sui dati:

  • Ordinare i dati in base a qualunque colonna.

  • Visualizzare i dati in gruppi.

  • Filtrare i dati in base a livello, area, categoria, messaggio, ID evento o timestamp.

  • Cercare qualunque stringa nei dati.

  • Esportare dati non elaborati, ordinati o filtrati in un foglio di calcolo.

Nota

[!NOTA] Non è possibile utilizzare il cmdlet Out-GridView con i cmdlet che utilizzano il verbo Format. Il cmdlet Out-GridView riceve gli oggetti, mentre i cmdlet che utilizzano il verbo Format restituiscono solo testo formattato. > È possibile visualizzare un subset dei dati usando il cmdlet Where-Object che filtra e passa i risultati al cmdlet Out-GridView . Ad esempio, Get-SPLogEvent | Where-Object {$_.Area -eq "SharePoint Foundation"} | Out-GridView. > Se la griglia visualizza più di diverse centinaia di righe, l'esecuzione potrebbe essere lenta, soprattutto se si eseguono operazioni di filtro complesse. Per ottenere prestazioni più veloci, esportare i dati in Excel 2016.

Per visualizzare e filtrare i log diagnostici tramite 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 per il server in cui vengono eseguiti i cmdlet diPowerShell.

    Un amministratore può utilizzare il cmdlet Add-SPShellAdmin per concedere le autorizzazioni.

    Nota

    [!NOTA] Se non si dispone delle autorizzazioni, richiederle all'amministratore per l'installazione o all'amministratore di SQL Server. Per ulteriori informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

  1. Andare a Management Shell di SharePoint.

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

Get-SPLogEvent | Out-GridView
  1. Per ordinare le colonne, fare clic sull'intestazione di colonna.

  2. Per cercare una stringa specifica, digitarla nella casella Filtro. La ricerca viene effettuata in tutte le righe e le colonne. Per cancellare la ricerca, fare clic su X.

  3. Per filtrare i dati in base a un solo criterio, digitare la stringa seguente nella casella Ricerca: <nome proprietà>:<valore>. Ad esempio, per cercare tutte le voci di log generate da SharePoint Foundation 2013, digitare: Area:SharePoint Foundation. Per cancellare il filtro, fare clic su X.

  4. Per filtrare i dati utilizzando più criteri, criteri con operatori "contiene, inizia con, termina con" o altri metodi:

  5. Fare clic sul pulsante Aggiungi criteri.

  6. Fare clic sulla casella di controllo relativa alle proprietà in base alle quali impostare il filtro e fare clic su Aggiungi.

  7. Fare clic su contiene per utilizzare un metodo di filtro diverso. I metodi disponibili sono contiene, non contiene, inizia con, è uguale a, è diverso da, termina con, è vuoto e non è vuoto.

  8. Digitare un valore nella casella di testo.

  9. Ripetere i passaggi "c" e "d" per ogni proprietà selezionata nel passaggio "b".

  10. Dopo aver specificato tutti i criteri di filtro, verranno visualizzati i dati che soddisfano i criteri.

  11. Per cancellare un filtro specifico, fare clic sul pulsante X.

  12. Per cancellare tutti i filtri, comprimere la visualizzazione della query e quindi fare clic sul pulsante Cancella tutto.

Per esportare i data della griglia in un foglio di calcolo

  1. Selezionare le righe da esportare. Se si desidera selezionare più righe, tenere premuto MAIUSC e trascinare per selezionare un blocco di righe, tenere premuto CTRL e fare clic per selezionare righe specifiche oppure utilizzare CTRL+A per selezionare tutte le righe.

    È inoltre possibile filtrare e ordinare i risultati prima di copiare i dati in un foglio di calcolo. Quando si ordinano o filtrano i dati, vengono copiati solo i dati risultanti visualizzabili.

  2. Copiare le righe selezionate utilizzando CTRL+C.

  3. Aprire la pagina del foglio di calcolo e incollare le righe copiate utilizzando CTRL+V.

Per altre informazioni, vedere Out-GridView e Out-GridView Revisited.