Visualizzare i log diagnostici in SharePoint
SI APPLICA A:2013 2016 2019 Subscription Edition SharePoint 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
- 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.
Andare a Management Shell di SharePoint.
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 powershell Out-GridView
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
- 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.
Andare a Management Shell di SharePoint.
Al prompt dei comandi di PowerShell digitare il comando seguente:
Get-SPLogEvent | Out-GridView
Per ordinare le colonne, fare clic sull'intestazione di colonna.
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.
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.
Per filtrare i dati utilizzando più criteri, criteri con operatori "contiene, inizia con, termina con" o altri metodi:
Fare clic sul pulsante Aggiungi criteri.
Fare clic sulla casella di controllo relativa alle proprietà in base alle quali impostare il filtro e fare clic su Aggiungi.
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.
Digitare un valore nella casella di testo.
Ripetere i passaggi "c" e "d" per ogni proprietà selezionata nel passaggio "b".
Dopo aver specificato tutti i criteri di filtro, verranno visualizzati i dati che soddisfano i criteri.
Per cancellare un filtro specifico, fare clic sul pulsante X.
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
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.
Copiare le righe selezionate utilizzando CTRL+C.
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.