Anzeigen von Daten in der SharePoint 2010-Protokollierungsdatenbank (SharePoint Server 2010)

 

Gilt für: SharePoint Server 2010

Letztes Änderungsdatum des Themas: 2016-11-30

Dieser Artikel enthält eine Einführung in die Microsoft SharePoint 2010-Produkte-Protokollierungsdatenbank und eine Beschreibung zum Anzeigen von Überwachungsinformationen in der SharePoint Server 2010-Protokollierungsdatenbank (standardmäßig als WSS_Logging bezeichnet). Zudem wird in diesem Artikel beschrieben, wie Sie benutzerdefinierte Ansichten in der Protokollierungsdatenbank verwenden und wie Sie Überwachungsinformationen nach Microsoft Excel exportieren.

Inhalt dieses Artikels:

  • Einführung in die Protokollierungsdatenbank

  • Vordefinierte SQL-Ansichten in der Protokollierungsdatenbank

  • Benutzerdefinierte SQL-Ansichten in der Protokollierungsdatenbank

Einführung in die Protokollierungsdatenbank

Wenn Sie SharePoint Server 2010-Server und die auf den Servern ausgeführten Dienste überwachen möchten, können Sie direkt auf verschiedene Protokolle zugreifen, beispielsweise auf Windows Server-Ereignisprotokolle, SharePoint ULS-Protokolle (Universal Logging System, auch bekannt als Ablaufverfolgungsprotokolle) oder Verwendungsdatenprotokolle. Sie können auch die Zentraladministration von SharePoint Server 2010 aufrufen, um verschiedene Berichte zu überprüfen. Integritätsanalyseberichte enthalten SharePoint Server 2010-Regeln für Server oder Dienste. Administrations- bzw. Diagnoseberichte enthalten Informationen, die sich auf Suchvorgänge beziehen. Web Analytics-Berichte beinhalten Web Analytics-Metriken. Weitere Informationen zu Berichten finden Sie unter Anzeigen von Berichten und Protokollen (SharePoint Server 2010).

Alle zuvor aufgeführten Überwachungsmethoden unterliegen Einschränkungen. Beispielsweise werden Windows Server-Ereignisprotokolle, SharePoint ULS-Protokolle sowie Verwendungsdatenprotokolle nicht unter einem zentralen Verzeichnis gespeichert. Daher müssen Sie bei der Suche nach zugehörigen Protokollen zu unterschiedlichen Speicherorten navigieren. Obwohl Berichte aus der Zentraladministration die am häufigsten verwendeten Metriken und Überwachungsinformationen enthalten, ist gleichermaßen das Hinzufügen weiterer Überwachungsinformationen zu diesen Berichten nicht möglich, weil sie vordefiniert sind und nicht geändert werden können.

Mithilfe der Protokollierungsdatenbank in SharePoint Server 2010 können Sie die Überwachungseffizienz steigern. Bei der Protokollierungsdatenbank handelt es sich um ein farmweites Repository mit SharePoint Server 2010-Überwachungsinformationen von allen Servern in der Farm. Die Protokollierungsdatenbank bietet die Möglichkeit, verschiedene Überwachungsinformationen zentral anzuzeigen und anzupassen. Darüber hinaus ist die Protokollierungsdatenbank die einzige SharePoint Server 2010-Datenbank, für die Sie Berichte durch eine direkte Änderung der Datenbank anpassen können.

Hinweis

Weitere Informationen zu den SharePoint Server 2010-Datenbanken finden Sie unter Datenbanktypen und -beschreibungen (SharePoint Server 2010).

Hinweis

Der Standardname der Datenbank lautet "WSS_Logging". Mithilfe von Windows PowerShell können Sie den Standardnamen und das Verzeichnis des SharePoint-Datenbankservers ändern. Weitere Informationen zum Namen der Protokollierungsdatenbank und zum Verzeichnis des Datenbankservers finden Sie unter Konfigurieren der Erfassung von Verwendungs- und Integritätsdaten (SharePoint Server 2010).

Die zentrale Speicherung verschiedener Überwachungsinformationen hilft Ihnen bei der effizienten Überwachung von SharePoint Server 2010-Servern und -Diensten. Noch wichtiger ist jedoch die Tatsache, dass Sie basierend auf Tabellen innerhalb der Protokollierungsdatenbank Ihre eigenen Berichte für eindeutige Anforderungen an die Überwachung, Berichterstellung und Problembehandlung erstellen können. In diesem Artikel wird das Erstellen von Berichten mithilfe von vorhandenen Tabellen und Ansichten beschrieben. Möglicherweise möchten Sie eigene Anbieter zum Erstellen neuer Tabellen schreiben. Weitere Informationen zum Schreiben neuer Anbieter für die Erstellung neuer Tabellen und Ansichten innerhalb der Protokollierungsdatenbank finden Sie unter SharePoint 2010 (https://go.microsoft.com/fwlink/?linkid=224502&clcid=0x407, möglicherweise in englischer Sprache).

Hinweis

Bei einer SQL-Ansicht handelt es sich um eine virtuelle Tabelle. Ein Unterschied zwischen einer Tabelle und einer SQL-Ansicht besteht darin, dass Sie die Daten zwar innerhalb einer Tabelle, nicht jedoch innerhalb einer SQL-Ansicht ändern können.

Mithilfe der SharePoint Server 2010-Zentraladministration können Sie Protokolle konfigurieren, die in die Protokollierungsdatenbank importiert wurden. Weitere Informationen zum Konfigurieren von Protokollkategorien, Protokollstufen und zum Pfad des Ablaufverfolgungsprotokolls (ULS) finden Sie unter Konfigurieren der Diagnoseprotokollierung (SharePoint Server 2010). Weitere Informationen zum Aktivieren der Inhalte, die in die Protokollierungsdatenbank geschrieben werden, finden Sie unter Konfigurieren der Erfassung von Verwendungs- und Integritätsdaten (SharePoint Server 2010). Weitere Informationen zum Angeben des Protokollierungsdatenbankservers, -namens und der Datenbank-Authentifizierungsinformationen, der in die Protokollierungsdatenbank zu schreibenden Ereignisse und der Häufigkeit, mit der Protokolle in die Protokollierungsdatenbank geschrieben werden (das heißt Zeitgeberaufträge bezüglich des Imports von Verwendungsdatenbanken) finden Sie unter Konfigurieren von Zeitgeberaufträgen der SharePoint-Integritätsanalyse (SharePoint Server 2010).

Bei den Verfahren in diesem Artikel wird SQL Server Management Studio zum Zugreifen auf die Protokollierungsdatenbank verwendet. Management Studio ist eine Komponente von Microsoft SQL Server 2008.

Hinweis

Für den Zugriff auf die Protokollierungsdatenbank benötigen Sie eine Windows-Authentifizierung (empfohlen) oder eine SQL-Authentifizierung. Die Datenbank-Authentifizierungsinformationen werden in der SharePoint Server 2010-Zentraladministration konfiguriert. Weitere Informationen zu den Authentifizierungsmethoden finden Sie unter Konfigurieren der Erfassung von Verwendungs- und Integritätsdaten (SharePoint Server 2010).

Vordefinierte SQL-Ansichten in der Protokollierungsdatenbank

Dieser Abschnitt enthält eine Beschreibung der Partitionstabellen und SQL-Ansichten innerhalb der SharePoint Server 2010-Protokollierungsdatenbank und die folgenden drei Verfahren:

  • So greifen Sie mit SQL Server Management Studio auf die Protokollierungsdatenbank zu

  • So zeigen Sie die Protokollierungsinformationen in Standardansichten an

  • So exportieren Sie die Protokollierungsdaten nach Excel und zeigen sie mit Excel an

Die Protokollierungsdatenbank verwendet für alle Kategorien eine separate Partitionstabelle für die täglichen Daten. Beispielsweise werden die Verwendungsdaten für Zeitgeberaufträge für den ersten Tag in die Tabelle dbo.TimerJobUsage_Partition0 geschrieben, während die Daten für 32 Tage danach in die Tabelle dbo.TimerJobUsageUsage_Partition31 geschrieben werden. An ein und demselben Tag erstellte Protokolle werden in eine einzelne Partitionstabelle geschrieben. Demnach dient jede Partitionstabelle der Speicherung der Protokolle eines bestimmten Tages (für alle Protokollkategorien).

Hinweis

Die Zuordnung zwischen einer Partitionstabelle und dem exakten Datum ist von der Beibehaltungsdauer der Protokollierungsdatenbank und vom Startdatum zum Schreiben von Protokollen in die Protokollierungsdatenbank abhängig. Sie können die Zuordnung abrufen, indem Sie die Zeitinformationen innerhalb der einzelnen Tabellen überprüfen. Wenn die Beibehaltungsdauer beispielsweise 14 Tage beträgt und die Protokolle des aktuellen Tages in Partitionstabelle 2 geschrieben werden, werden die Protokolle des folgenden Tages in Partitionstabelle 3 geschrieben usw. Nach 14 Tagen werden alle Protokolle gelöscht, und beginnend mit Partitionstabelle 0 werden neue Protokolle in diese Partitionstabellen geschrieben.

Mithilfe der vordefinierten SQL-Ansichten in Management Studio können Sie alle Überwachungsinformationen zentral anzeigen. In allen vordefinierten Ansichten werden die Daten aus allen 32 Partitionstabellen für die spezielle Protokollkategorie gesammelt. So können Sie beispielsweise die Überwachungsinformationen in 32 Tabellen von dbo.TimerJobUsage_Partition0 bis dbo.TimerJobUsageUsage_Partition31 anzeigen.

Für den Zugriff auf die vordefinierten Ansichten müssen Sie auf die SharePoint Server 2010-Protokollierungsdatenbank zugreifen. In der Protokollierungsdatenbank können Sie anschließend die Überwachungsinformationen anzeigen.

So greifen Sie mit Management Studio auf die Protokollierungsdatenbank zu

  1. Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Alle Programme, klicken Sie auf Microsoft SQL Server 2008 oder auf die neueste Version von Microsoft SQL Server, die installiert ist, und klicken Sie dann auf SQL Server Management Studio.

    Hinweis

    Wenn Management Studio nicht auf Ihrem Server installiert ist, installieren Sie SQL Server 2008 erneut, und fügen Sie die Management Studio-Komponente hinzu. Weitere Informationen dazu finden Sie unter Installieren von SQL Server (in englischer Sprache) (möglicherweise in englischer Sprache).

  2. Wählen Sie im Dialogfeld Verbindung mit dem Server herstellen die Option Datenbankmodul aus. Geben Sie anschließend den Servernamen an, beispielsweise ServerName\SharePoint. Wählen Sie den Authentifizierungstyp aus (Windows-Authentifizierung oder SQL Server-Authentifizierung), den Sie über die SharePoint Server 2010-Zentraladministration konfiguriert haben. Wenn es sich dabei um die SQL Server-Authentifizierung handelt, geben Sie die Anmeldeinformationen für den Datenbankadministrator an. Nachdem Sie die Informationen festgelegt haben, klicken Sie auf Verbinden.

  3. Wechseln Sie zur Ansicht Objekt-Explorer, indem Sie auf Ansicht und anschließend auf Objekt-Explorer klicken. Erweitern Sie Datenbanken, um die Protokollierungsdatenbank mit dem Standardnamen WSS_Logging oder mit einem Namen anzuzeigen, den Sie in der SharePoint Server 2010-Zentraladministration konfiguriert haben.

  4. Optional können Sie die Protokollierungsdatenbank erweitern, um Tabellen und Ansichten anzuzeigen.

So zeigen Sie die Protokollierungsinformationen in Standardansichten an

  1. Wechseln Sie in Management Studio mithilfe des zuvor beschriebenen Verfahrens zum Knoten der Protokollierungsdatenbank.

  2. Erweitern Sie den Knoten Ansichten der Datenbank, um die Standardansichten anzuzeigen. Klicken Sie mit der rechten Maustaste auf die Ansicht, beispielsweise auf dbo.RequestUsage, und wählen Sie die Option Oberste 1000 Zeilen auswählen aus.

    Der Vorgang Oberste 1000 Zeilen auswählen entspricht dem folgenden T-SQL-Abfrageskript:

    /****** 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]
    

    Die obersten 1.000 Zeilen der Tabellenkategorie Verwendung anfordern werden im Ergebnisfenster angezeigt.

  3. Sie können die T-SQL-Abfrage im Fenster des SQL-Editors ändern. Wenn die Tabellen beispielsweise mehr als 1.000 Zeilen enthalten, können Sie die obersten 5.000 Zeilen anzeigen. Ändern Sie dazu das Skript, indem Sie den Eintrag OBERSTE 1000 AUSWÄHLEN durch OBERSTE 5000 AUSWÄHLEN ersetzen, und klicken Sie dann auf Ausführen.

Wenn Sie Protokolle nicht mit Management Studio, sondern mit anderen Tools anzeigen möchten, können Sie die Überwachungsinformationen aus den Ansichten extrahieren und als Text- oder CSV-Datei speichern. Im folgenden Verfahren wird Microsoft Excel als Beispiel verwendet.

So exportieren Sie die Protokollierungsdaten mit Excel und zeigen sie in Excel an

  1. Wechseln Sie in Management Studio zum Knoten der Protokollierungsdatenbank.

  2. Erweitern Sie den Knoten Ansichten, klicken Sie mit der rechten Maustaste auf die Ansicht, aus der Sie Daten extrahieren möchten, und klicken Sie dann auf Oberste 1000 Zeilen auswählen.

  3. Klicken Sie im Ergebnisfenster mit der rechten Maustaste, und klicken Sie dann auf Alles markieren. Klicken Sie dann mit der rechten Maustaste, und klicken Sie dann auf Ergebnisse speichern unter.

  4. Geben Sie im Fenster Rasterergebnisse speichern den Ordner an, in dem Sie die Datei speichern möchten. Geben Sie unter Dateityp CSV (Trennzeichen-getrennt) an, und geben Sie dann einen geeigneten Dateinamen an.

  5. Öffnen Sie die CSV-Datei, indem Sie sie in Excel per Doppelklick auswählen.

Benutzerdefinierte SQL-Ansichten in der Protokollierungsdatenbank

Mithilfe der Protokollierungsdatenbank in SharePoint Server 2010 haben Sie zwei Möglichkeiten zum Erstellen benutzerdefinierter Berichte. Sie können durch Kombinieren zugehöriger Informationen aus vorhandenen Tabellen neue Ansichten generieren, oder Sie können Anbieter schreiben, um innerhalb der Protokollierungsdatenbank neue Partitionstabellen zu generieren. Die Beispiele in diesem Abschnitt verdeutlichen nur die erste Methode.

In Verwendungstabellen und den ULSTraceLog-Tabellen ist die CorrelationId ein wichtiger Parameter für die Problembehandlung, weil jede Fehlermeldung eine eindeutige CorrelationId enthält. CorrelationId ist eine GUID zur Verknüpfung von allen zugehörigen Informationen bezüglich einer Anforderung. Anhand des folgenden Verfahrens wird die Erstellung einer benutzerdefinierten Ansicht veranschaulicht, in der mehrere Protokollkategorien mithilfe der CorrelationId verknüpft werden.

So erstellen Sie eine benutzerdefinierte SQL-Ansicht, für die vorhandene Tabellen verwendet werden

  1. Wechseln Sie in Management Studio zum Knoten der Protokollierungsdatenbank.

  2. Erweitern Sie in der Protokollierungsdatenbank den Knoten Ansichten. Wählen Sie eine der Ansichten aus, für die Sie Informationen sammeln möchten. Klicken Sie mit der rechten Maustaste auf die Ansicht, und klicken Sie dann auf Neue Ansicht.

  3. Wählen Sie im Fenster Tabelle hinzufügen die hinzuzufügenden Tabellen aus. Wenn Sie beispielsweise für einen einzelnen Tag Informationen zu Websiteanforderungen für die Featureverwendung abrufen möchten, können Sie dbo.FeatureUsage_Partion1 und dbo.RequestUsage_Partion1 hinzufügen.

    Die T-SQL-Abfrage stellt automatisch eine innere Verknüpfung mit dem eindeutigen Schlüssel PartionId in diesen Tabellen her.

    SELECT     
    FROM   dbo.FeatureUsage_Partition1 INNER JOIN
        dbo.RequestUsage_Partition1 ON dbo.FeatureUsage_Partition1.PartitionId = dbo.RequestUsage_Partition1.PartitionId
    
  4. Trennen Sie die beiden Tabellen, indem Sie mit der rechten Maustaste auf die Verknüpfung zwischen diesen Tabellen klicken und Entfernen auswählen.

  5. Wenn Sie mithilfe der CorrelationId eine innere Verknüpfung für die beiden Tabellen herstellen möchten, klicken Sie in einer Tabelle auf die Spalte CorrelationId, und bewegen Sie den Cursor zu der Spalte CorrelationId in einer anderen Tabelle. Alternativ dazu können Sie die SQL-Abfrage direkt im Abfrage-Editor ändern.

    SELECT  
    FROM   dbo.FeatureUsage_Partition1 INNER JOIN
        dbo.RequestUsage_Partition1 ON dbo.FeatureUsage_Partition1.CorrelationId = dbo.RequestUsage_Partition1.CorrelationId 
    
  6. Wählen Sie in den einzelnen Tabellen die Spalten aus, die Sie in der neuen Ansicht anzeigen möchten.

  7. Klicken Sie mit der rechten Maustaste, und wählen Sie die Option SQL ausführen aus. Die Ergebnisse werden im Ergebnisfenster angezeigt.