Visualizzare i dati nel database di registrazione di SharePoint 2010 (SharePoint Foundation 2010)

SharePoint 2010
 

Si applica a: SharePoint Foundation 2010

Ultima modifica dell'argomento: 2016-11-30

In questo articolo viene presentato il database di registrazione di Prodotti Microsoft SharePoint 2013 e viene spiegato come visualizzare le informazioni di monitoraggio all'interno del database di registrazione di SharePoint Foundation 2010, il cui nome predefinito è WSS_Logging. Viene inoltre illustrato come utilizzare le visualizzazioni personalizzate nel database di registrazione e come esportare le informazioni di monitoraggio in Microsoft Excel.

Contenuto dell'articolo:

Per monitorare i server di SharePoint Foundation 2010 e i servizi eseguiti sui server, è possibile accedere direttamente a diversi registri, ad esempio il registro eventi di Windows Server, i registri ULS (Universal Logging System) di SharePoint (noti anche come registri di traccia) o i registri dei dati di utilizzo. È anche possibile passare ad Amministratore centrale di SharePoint Foundation 2010 per esaminare diversi report. I report dell'analizzatore dell'integrità contengono le regole di SharePoint Foundation 2010 relative a server o servizi. I report amministrativi (diagnostica) contengono informazioni correlate alle ricerche. I report Web Analytics contengono invece le metriche di Web Analytics. Per ulteriori informazioni sui report, vedere Viewing reports and logs (SharePoint Foundation 2010).

Tutti i metodi di monitoraggio menzionati in precedenza presentano delle limitazioni. Ad esempio, i registri eventi di Windows Server, i registri ULS di SharePoint e i registri dei dati di utilizzo non vengono archiviati in un'unica posizione. È quindi necessario cercare i registri correlati in posizioni diverse. Analogamente, sebbene i report di Amministrazione centrale contengano le metriche e le informazioni di monitoraggio più comuni, non è possibile aggiungere ulteriori informazioni di monitoraggio a questi report perché sono predefiniti e non sono possono essere modificati.

Per eseguire il monitoraggio in modo più efficiente, è possibile utilizzare il database di registrazione in SharePoint Foundation 2010. Il database di registrazione è un archivio a livello di farm delle informazioni di monitoraggio di SharePoint Foundation 2010 inviate da ogni server della farm. Questo database consente di scegliere di visualizzare e personalizzare diverse informazioni di monitoraggio in un'unica posizione. Questo è inoltre l'unico database di SharePoint Foundation 2010 per il quale è possibile personalizzare i report modificando direttamente il database.

NotaNote
Per ulteriori informazioni sui database di SharePoint Foundation 2010, vedere Database types and descriptions (SharePoint Foundation 2010).
NotaNote
Il nome predefinito del database è WSS_Logging. È possibile cambiare il nome predefinito e il percorso del server database di SharePoint utilizzando Windows PowerShell. Per ulteriori informazioni sul nome del database di registrazione e sul percorso del server database, vedere Configure usage and health data collection (SharePoint Foundation 2010).

L'utilizzo di un'unica posizione in cui archiviare diverse informazioni di monitoraggio consente di monitorare in modo efficiente server e servizi di SharePoint Foundation 2010. Ancor più importante, è possibile creare report personalizzati per speciali esigenze di monitoraggio, creazione di report e risoluzione dei problemi sulla base di tabelle incluse nel database di registrazione. In questo articolo viene descritto come creare report utilizzando tabelle e visualizzazioni esistenti. Potrebbe essere necessario scrivere provider personalizzati per creare nuove tabelle. Per ulteriori informazioni sulla scrittura di nuovi provider per creare nuove tabelle e visualizzazioni nel database di registrazione, vedere SharePoint 2010 (le informazioni potrebbero essere in lingua inglese) (http://go.microsoft.com/fwlink/?linkid=224502&clcid=0x410) (le informazioni potrebbero essere in lingua inglese).

NotaNote
Una visualizzazione SQL è una tabella virtuale. Una delle differenze tra una tabella e una visualizzazione SQL è data dal fatto che è possibile modificare i dati all'interno di una tabella ma non all'interno di una visualizzazione SQL.

Per configurare i registri importati nel database di registrazione, viene utilizzato Amministrazione centrale di SharePoint Foundation 2010. Per ulteriori informazioni su come configurare le categorie e i livelli del registro, nonché i percorsi del registro di traccia (ULS), vedere Configure diagnostic logging (SharePoint Foundation 2010). Per ulteriori informazioni su come abilitare i dati scritti nel database di registrazione, vedere Configure usage and health data collection (SharePoint Foundation 2010). Per ulteriori informazioni su come specificare il server database di registrazione, il nome e le informazioni per l'autenticazione del database, gli eventi da scrivere nel database di registrazione e la frequenza con cui i registri vengono scritti nel database, ovvero i processi timer correlati all'importazione dei database di utilizzo, vedere Configure SharePoint Health Analyzer timer jobs (SharePoint Foundation 2010).

Per accedere al database di registrazione, nelle procedure di questo articolo viene utilizzato SQL Server Management Studio. Management Studio è un componente di Microsoft SQL Server 2008.

NotaNote
Per accedere al database di registrazione, è necessario utilizzare l'autenticazione di Windows (scelta consigliata) oppure l'autenticazione SQL. Le informazioni per l'autenticazione del database vengono configurate in Amministrazione centrale di SharePoint Foundation 2010. Per ulteriori informazioni sui metodi di autenticazione, vedere Configure usage and health data collection (SharePoint Foundation 2010).

In questa sezione sono descritte le tabelle di partizione e le visualizzazioni SQL del database di registrazione di SharePoint Foundation 2010 e sono include le tre procedure seguenti:

  • Per accedere al database di registrazione utilizzando SQL Server Management Studio

  • Per visualizzare le informazioni di registrazione dalle visualizzazioni predefinite

  • Per esportare i dati di registrazione e visualizzarli utilizzando Excel

Nel database di registrazione viene utilizzata una tabella di partizione distinta per i dati giornalieri di ogni categoria. Ad esempio, i dati di utilizzo del processo timer per il primo giorno vengono scritti nella tabella dbo.TimerJobUsage_Partition0, mentre quelli di 32 giorni dopo vengono scritti nella tabella dbo.TimerJobUsageUsage_Partition31. I registri di un unico giorno vengono scritti in un'unica tabella di partizione. Questo significa che per ogni categoria del registro in ogni tabella di partizione vengono archiviati i registri di un unico giorno specifico.

NotaNote
Il mapping tra una tabella di partizione e la data esatta dipende dal periodo di conservazione del database di registrazione e dalla data di inizio per la scrittura dei registri nel database. Il mapping è evidente osservando le informazioni relative all'ora all'interno di ogni tabella. Ad esempio, se il periodo di conservazione è pari a 14 giorni e i registri di oggi vengono scritti nella tabella di partizione 2, i registri di domani verranno scritti nella tabella di partizione 3 e così via. Dopo 14 giorni tutti i registri verranno eliminati e i nuovi registri verranno scritti in queste tabelle di partizione a partire dalla tabella 0.

È possibile utilizzare le visualizzazioni SQL predefinite in Management Studio per visualizzare in un'unica posizione tutte le informazioni di monitoraggio. Ogni visualizzazione predefinita raccoglie i dati di tutte le 32 tabelle di partizione per la categoria di registro specifica. Ad esempio, è possibile visualizzare le informazioni di monitoraggio nelle 32 tabelle comprese tra dbo.TimerJobUsage_Partition0 e dbo.TimerJobUsageUsage_Partition31.

Per accedere alle visualizzazioni predefinite, è necessario accedere al database di registrazione di SharePoint Foundation 2010. Sarà quindi possibile visualizzare le informazioni di monitoraggio dal database di registrazione.

Per accedere al database di registrazione utilizzando Management Studio
  1. Sulla barra delle applicazioni fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft SQL Server 2008 oppure la versione installata più recente di Microsoft SQL Server e quindi SQL Server Management Studio.

    NotaNote
    Se nel server non è presente Management Studio, reinstallare SQL Server 2008 e aggiungere il componente Management Studio. Per ulteriori informazioni, vedere Installazione di SQL Server (le informazioni potrebbero essere in lingua inglese).
  2. Nella finestra di dialogo Connetti al server fare clic su Motore di database. Specificare quindi il nome del server, ad esempio NomeServer\SharePoint. Selezionare il tipo di autenticazione (Autenticazione di Windows o Autenticazione di SQL Server) configurato tramite Amministrazione centrale di SharePoint Foundation 2010. Se si tratta di Autenticazione di SQL Server, specificare le credenziali dell'amministratore del database. Dopo aver impostato le informazioni, fare clic su Connetti.

  3. Passare alla visualizzazione Esplora oggetti facendo clic su Visualizza e quindi su Esplora oggetti. Espandere Database per visualizzare il database di registrazione con il nome predefinito WSS_Logging oppure con il nome configurato in Amministrazione centrale di SharePoint Foundation 2010.

  4. Facoltativamente, espandere il database di registrazione per visualizzare tabelle e visualizzazioni.

Per visualizzare le informazioni di registrazione dalle visualizzazioni predefinite
  1. In Management Studio passare al nodo del database di registrazione utilizzando la procedura precedente.

  2. Espandere il nodo Visualizzazioni del database per visualizzare le visualizzazioni predefinite. Fare clic con il pulsante destro del mouse sulla visualizzazione, ad esempio dbo.RequestUsage, e quindi scegliere Seleziona le prime 1000 righe.

    L'operazione Seleziona le prime 1000 righe corrisponde allo script di query T-SQL seguente:

    /****** Script for SelectTopNRows command from SSMS  ******/
    SELECT TOP 1000 [PartitionId]
          ,[RowId]
          ,[LogTime]
          ,[MachineName]
          ,[FarmId]
          ,[SiteSubscriptionId]
          ,[UserLogin]
          ,[CorrelationId]
          ,[WebApplicationId]
          ,[ServerUrl]
          ,[SiteId]
          ,[SiteUrl]
          ,[WebId]
          ,[WebUrl]
          ,[DocumentPath]
          ,[ContentTypeId]
          ,[QueryString]
          ,[BytesConsumed]
          ,[HttpStatus]
          ,[SessionId]
          ,[ReferrerUrl]
          ,[ReferrerQueryString]
          ,[Browser]
          ,[UserAgent]
          ,[UserAddress]
          ,[RequestCount]
          ,[QueryCount]
          ,[QueryDurationSum]
          ,[ServiceCallCount]
          ,[ServiceCallDurationSum]
          ,[OperationCount]
          ,[Duration]
          ,[RequestType]
          ,[Title]
          ,[RowCreatedTime]
      FROM [WSS_Logging].[dbo].[RequestUsage]
    

    Le prime 1000 righe della categoria di tabella RequestUsage vengono visualizzate nella finestra dei risultati.

  3. È possibile modificare la query T-SQL nella finestra dell'editor SQL. Ad esempio, se le tabelle contengono più di 1000 righe, è possibile scegliere di visualizzare le prime 5000 righe. A tale scopo, modificare lo script sostituendo “SELECT TOP 1000” con ”SELECT TOP 5000” e quindi fare clic su Esegui.

Se si desidera visualizzare i registri utilizzando strumenti diversi da Management Studio, è possibile estrarre le informazioni di monitoraggio dalle visualizzazioni e salvarle come file di testo o CSV. Nella procedura seguente come esempio viene utilizzato Microsoft Excel.

Per esportare i dati di registrazione e visualizzarli utilizzando Excel
  1. In Management Studio passare al nodo del database di registrazione.

  2. Espandere il nodo Visualizzazioni, fare clic con il pulsante destro del mouse sulla visualizzazione da cui estrarre i dati e quindi scegliere Seleziona le prime 1000 righe.

  3. Nel finestra dei risultati fare clic con il pulsante destro del mouse e quindi scegliere Seleziona tutto. Fare clic con il pulsante destro del mouse e quindi scegliere Salva risultati con nome.

  4. Nella finestra Salva risultati della griglia scegliere la cartella in cui salvare il file, selezionare CSV (delimitato dal separatore di elenco) in Tipo file e quindi specificare un nome file appropriato.

  5. Aprire il file CSV facendovi sopra doppio clic in Excel.

Nel database di registrazione di SharePoint Foundation 2010 è possibile creare report personalizzati in due diversi modi. È possibile generare nuove visualizzazioni combinando informazioni correlate di tabelle esistente oppure scrivere provider per generare nuove tabelle di partizione all'interno del database di registrazione. Negli esempi di questa sezione viene illustrato solo il primo approccio.

Nelle tabelle di utilizzo e nelle tabelle ULSTraceLog il parametro CorrelationId è fondamentale per la risoluzione dei problemi. Ogni messaggio di errore contiene infatti un valore CorrelationId univoco. CorrelationId è un GUID che collega tutte le informazioni correlate rispetto a una richiesta. Nella procedura seguente viene spiegato come creare una visualizzazione personalizzata per collegare più categorie di registro tramite il parametro CorrelationId.

Per creare una visualizzazione di SQL personalizzata che utilizza tabelle esistenti
  1. In Management Studio passare al nodo del database di registrazione.

  2. Nel database di registrazione espandere il nodo Visualizzazioni. Scegliere una delle visualizzazioni per le quali raccogliere informazioni. Fare clic con il pulsante destro del mouse sulla visualizzazione e scegliere Nuova visualizzazione.

  3. Nella finestra Aggiungi tabella scegliere le tabelle da aggiungere. Ad esempio, per ottenere informazioni sulle richieste del sito relative all'utilizzo delle caratteristiche di un unico giorno, è possibile aggiungere dbo.FeatureUsage_Partion1 e dbo.RequestUsage_Partion1.

    La query T-SQL esegue automaticamente l'inner join della chiave univoca PartionId in queste due tabelle.

    SELECT     
    FROM   dbo.FeatureUsage_Partition1 INNER JOIN
        dbo.RequestUsage_Partition1 ON dbo.FeatureUsage_Partition1.PartitionId = dbo.RequestUsage_Partition1.PartitionId
    
    
  4. Annullare il join delle due tabelle facendo clic sul collegamento tra di esse e selezionando rimozione.

  5. Per eseguire l'inner join delle due tabelle utilizzando CorrelationId, fare clic sulla colonna CorrelationId in una tabella e spostare il cursore sulla colonna CorrelationId nell'altra tabella. In alternativa, è possibile modificare la query SQL direttamente dall'editor di query.

    SELECT  
    FROM   dbo.FeatureUsage_Partition1 INNER JOIN
        dbo.RequestUsage_Partition1 ON dbo.FeatureUsage_Partition1.CorrelationId = dbo.RequestUsage_Partition1.CorrelationId 
    
    
  6. Selezionare le colonne di ogni tabella che si desidera visualizzare nella nuova visualizzazione.

  7. Fare clic con il pulsante destro del mouse e scegliere Esegui SQL. I risultati verranno visualizzati nella finestra dei risultati.

Mostra: