Problembehandlung für eine SharePoint-Farm mithilfe von "SPDiag"

SPDiag ist ein Tool zum Erfassen, Filtern und Anzeigen von Daten aus einer SharePoint-Farm zu Problembehandlungszwecken. SPDiag ist ein Tool, das nur Daten lesen kann und mit dem keine Änderungen an einer Farm vorgenommen werden können. Mithilfe von SPDiag können Sie Probleme selbst identifizieren oder die Daten erfassen, die Supportmitarbeiter benötigen, um eine Problembehandlung für Ihre Farm durchzuführen.

Bei einigen Informationen in diesem Artikel wird davon ausgegangen, dass Sie SPDiag, Version 2, verwenden, das in SharePoint Administration Toolkit, Version 4 enthalten ist. Weitere Informationen finden Sie unter Neues in SPDiag Version 2.

Die Informationen in diesem Abschnitt sind hilfreich, um zu verstehen, wie Projekte erstellt und importiert, Daten gefiltert und erfasst, Diagramme und Berichte generiert sowie Daten in eine Datei exportiert werden.

Security noteSicherheit Hinweis:

Der Benutzer, der SPDiag ausführt, benötigt die Berechtigungen eines Windows-Serveradministrators auf allen Servern der Farm sowie SharePoint-Farmadministratorberechtigungen und die Berechtigungen db_owner für die SPDiag-Projektdatenbank. Es wird empfohlen, ein vorhandenes Administratorkonto zu verwenden, z. B. das Farmadministratorkonto, statt ein neues zu erstellen. Das Ausführen von SPDiag mit nicht ausreichenden Berechtigungen kann zu einer unvollständigen Datenerfassung sowie zu Verbindungsproblemen oder langsamer Leistung führen.

Die Verwendung von SPDiag zur Problembehandlung für eine Farm umfasst die folgenden allgemeinen Schritte:

  1. Erstellen oder Importieren eines neuen Projekts.

  2. Sicherstellen, dass Protokolldateien und Leistungsindikatordateien für alle Farmserver verfügbar sind, und Notieren der Speicherorte von Protokolldateien für jeden Farmserver.

  3. Auswählen eines Datums- und Uhrzeitbereichs für die zu analysierenden Daten.

  4. Auswählen der Leistungsindikatoren und Protokolldateien für die Analyse.

  5. Erfassen von Daten von den Farmservern.

  6. Anzeigen von Daten in Leistungsindikatordiagrammen und benutzerdefinierten Berichten.

  7. Optionales Exportieren von Daten zur Analyse durch Berater oder Supportmitarbeiter.

  8. Optionales Verwenden der Registerkarte Diagnostics zum Ausführen vorkonfigurierter Regeln, um häufig auftretende Probleme zu prüfen.

    Weitere Informationen zur Verwendung der Registerkarte Diagnostics finden Sie unter SPDiag Diagnostics (Registerkarte).

Inhalt dieses Abschnitts:

  • Erstellen eines neuen Projekts

  • Erfassen und Importieren von Daten mithilfe von "SPDiag" über die Befehlszeile

  • Arbeiten mit Daten

Erstellen eines neuen Projekts

Ein SPDiag-Projekt besteht aus einer Sammlung von Daten, die bis zu sieben aufeinander folgende Tage in IIS-, ULS- und Ereignisprotokollen darstellen, sowie aus Leistungsindikatordaten. Ein Projekt wird in einer SQL Server-Datenbank auf einem Datenbankserver gespeichert, den Sie angeben können. Ein Projekt kann über unbegrenzte Zeit gespeichert werden, und die Daten im Projekt können häufig wiederverwendet werden, um Momentaufnahmen und Berichte auf Grundlage verschiedener Gruppen von Daten zu erstellen, die in der Projektdatenbank gespeichert sind.

Seit SPDiag, Version 2, können Sie die beiden folgenden Optionen im Menü File verwenden, um ein Projekt zu erstellen:

  • New Project: Hiermit erstellen Sie eine leere Projektdatenbank. Anschließend verwenden Sie die SPDiag-Benutzeroberfläche, um anzugeben, welche Daten aus der verbundenen Zielfarm erfasst werden sollen.

  • Import Project: Hiermit können Sie mithilfe von SPDiag im Befehlszeilenmodus aus einer Remotefarm erfassten Daten importieren. Weitere Informationen zum Importieren eines Projekts finden Sie in Erfassen und Importieren von Daten mithilfe von "SPDiag" über die Befehlszeile weiter unten in diesem Thema.

Führen Sie das folgende Verfahren durch, um ein neues Projekt in SPDiag zu erstellen.

Erstellen eines neuen Projekts

  1. Klicken Sie im Menü File auf New Project.

  2. Geben Sie im Dialogfeld New Project im Feld Database Server den Namen des Datenbankservers ein, auf dem das Projekt gespeichert werden soll. Verwenden Sie dabei folgendes Format: <Servername\Datenbankinstanz>.

  3. Geben Sie im Feld Project Name einen Namen für das Projekt ein. Der Name wird dann als Name der Datenbank verwendet. Der Projektname kann nur alphanumerische Zeichen und Unterstriche enthalten.

  4. Im Feld Project Description können Sie optional beschreibenden Text zum Projekt eingeben.

  5. Klicken Sie auf Create, um die Projektdatenbank zu erstellen.

    Eine Meldung mit folgendem Text wird angezeigt: "Creating project, this may take a few minutes".

  6. Klicken Sie auf OK.

Hinweis

Wenn Sie ein neues Projekt erstellen und die IIS-Protokolle auf den Webservern der Farm nicht ordnungsgemäß konfiguriert haben, kann die folgende Warnmeldung angezeigt werden: "The following servers have missing IIS log fields that may result in incomplete SPDiag reports: <Servername(n)>". Wenn diese Warnmeldung angezeigt wird, notieren Sie die Namen der in der Meldung aufgeführten Server. Informationen dazu, wie Sie das Problem beheben können, finden Sie im Abschnitt zu IIS-Protokollen weiter oben in Einrichten und Konfigurieren von "SPDiag".

Erfassen und Importieren von Daten mithilfe von "SPDiag" über die Befehlszeile

In SPDiag, Version 2, können Sie die Befehlszeile verwenden, um Daten von allen Servern einer Farm zu erfassen und anschließend in ein neues Projekt auf einem anderen Computer zu importieren, auf dem SPDiag ausgeführt wird. Dies ist nützlich, wenn Sie das SharePoint Administration Toolkit nicht auf einem Server der Zielfarm installieren möchten, wenn Sie Daten erfassen möchten, die auf einem Remotecomputer oder von einer dritten Person analysiert werden sollen, oder wenn Sie Protokolldaten automatisch als ausgelöstes Ereignis erfassen möchten.

Hinweis

Die Befehlszeilenfunktionalität ist neu in SPDiag, Version 2. SPDiag, Version 1, können Sie nicht über die Befehlszeile verwenden.

Sie können SPDiag über die Befehlszeile auf einem Computer ausführen, auf dem SPDiag als Teil des SharePoint Administration Toolkits installiert ist, oder auf dem die erforderlichen Dateien manuell kopiert wurden. Eine Liste der Dateien, die Sie benötigen, um SPDiag ohne Installation des SharePoint Administration Toolkits auszuführen, finden Sie in "Erforderliche Dateien" weiter unten in diesem Abschnitt.

SPDiag kann mit den folgenden Parametern ausgeführt werden:

spdiag.exe -help [<mode>]

Bei der Ausführung von spdiag.exe mit dem –help-Parameter werden die verfügbaren Parameter sowie Verwendungsbeispiele angezeigt. Sie können auch –help <mode> mit einem der zwei in der folgenden Tabelle beschriebenen Modi verwenden, um eine spezifische Hilfe für den betreffenden Modus anzuzeigen.

spdiag.exe -mode <mode> [<parameters>]

Der –mode-Parameter wird zum Erfassen von Daten verwendet. Es sind mehrere zusätzliche Parameter verfügbar, um Folgendes anzugeben: den Zielordner, in dem die erfassten Daten gespeichert werden sollen, die Zeitspanne für die Datenerfassung sowie sekundäre Datenquellspeicherorte.

Über die Befehlszeile sind zwei Datenerfassungsmodi verfügbar, wie in der folgenden Tabelle gezeigt. Es kann immer nur jeweils ein Modusparameter verwendet werden.

Modus Verwendung Parameter Hinweise

snapshot

spdiag.exe -mode snapshot [<Parameter>]

-targetfolder <path>

Im Momentaufnahmemodus erfasst SPDiag Momentaufnahmedaten und schreibt diese in den vom -targetfolder <path>-Parameter angegebenen Zielordner. Hierbei handelt es sich um den einzigen Parameter, der im Momentaufnahmemodus verfügbar ist.

logs

spdiag.exe -mode logs [<Parameter>]

-targetfolder <path>

[-start <"mm/dd/yyyy hh:mm"> -end <"mm/dd/yyyy hh:mm">]

start: Anfangsdatum und -uhrzeit für die Zeitspanne. Erfolgt hier keine Angabe, ist der Standardwert <heute>00:00.

end: Enddatum und -uhrzeit für die Zeitspanne. Erfolgt hier keine Angabe, ist der Standardwert <heute><jetzt>.

[-additionaliislogpath <path1;path2;...>]

[-additionalulslogpath <path1;path2;...>]

[-additionaleventlogpath <path1;path2;...>]

[-additionalperflogpath <path1;path2;...>]

Im Protokollmodus erfasst SPDiag ULS-, IIS-, Ereignis- und Leistungsindikatorprotokolle und schreibt die Daten in den vom -targetfolder <path>-Parameter angegebenen Zielordner.

Standardmäßig werden Daten vom Standardspeicherort für Protokolle auf den einzelnen Farmservern erfasst. Sie können die additional<log type>logpath-Parameter verwenden, um zusätzliche Speicherorte für Protokolldateien anzugeben. Die angegebenen Pfade werden auf jedem Server der Zielfarm überprüft.

Führen Sie das folgende Verfahren durch, um Daten mithilfe von SPDiag über die Befehlszeile zu erfassen.

Erfassen von Daten mithilfe von "SPDiag" über die Befehlszeile

  1. Wenn die erforderlichen Dateien auf dem Zielserver nicht vorhanden sind, installieren Sie SPDiag entweder mit dem SharePoint Administration Toolkit, oder kopieren Sie die erforderlichen Dateien manuell auf den Server.

    Eine Liste der benötigten Dateien finden Sie unter "Erforderliche Dateien" weiter unten in diesem Abschnitt.

  2. Ändern Sie das Verzeichnis an der Eingabeaufforderung in den Ordner, der spdiag.exe enthält.

  3. Um Momentaufnahmedaten zu erfassen, geben Sie spdiag.exe -mode snapshot -targetfolder <Pfad> ein.

  4. Um Protokolldaten zu erfassen, geben Sie spdiag.exe -mode logs -targetfolder <Pfad> -start <"mm/tt/jjjj hh:mm"> -end <"mm/tt/jjjj hh:mm"> ein. Optional können Sie einige oder alle der additional<log type>logpath-Parameter hinzufügen, wenn auf den Servern der Zielfarm weitere Speicherorte vorhanden sind, von denen Sie Daten erfassen möchten.

  5. Nachdem die Befehle ausgeführt wurden, kopieren Sie den angegebenen Zielordner an den gewünschten Netzwerkspeicherort, auf das gewünschte tragbare Medium oder Wechselmedium. Abhängig vom Umfang der Daten kann es ratsam sein, den Ordnerinhalt zu einem komprimierten Archiv hinzuzufügen, z. B. eine ZIP-Datei.

Importieren von erfassten Daten in ein neues Projekt für die Analyse im Offlinemodus

Sie können erfasste Daten über die Befehlszeile zur Analyse im Offlinemodus in ein neues SPDiag-Projekt importieren. Außerdem können Sie aktualisierte Daten später in ein Projekt importieren, um vorhandene Daten zu ergänzen. Wenn Sie SPDiag im Offlinemodus verwenden, sind die meisten SPDiag-Funktionen verfügbar, die Analyse ist jedoch auf die vorhandenen Daten beschränkt.

Importieren von Daten in ein neues Projekt

  1. Öffnen Sie das Tool SPDiag.

  2. Klicken Sie im Menü File auf Import Project.

  3. Geben Sie im Dialogfeld Import Project im Feld Database Server den Namen des Datenbankservers ein, auf dem das Projekt gespeichert werden soll. Verwenden Sie dabei folgendes Format: <Servername\Datenbankinstanz>.

  4. Geben Sie im Feld Project Name einen Namen für das Projekt ein. Der Name wird dann als Name der Datenbank verwendet. Der Projektname kann nur alphanumerische Zeichen und Unterstriche enthalten.

  5. Im Feld Project Description können Sie optional beschreibenden Text zum Projekt eingeben.

  6. Klicken Sie im Feld Log root folder auf die Schaltfläche Browse, um zum Speicherort der erfassten Protokolldateien zu wechseln.

  7. Geben Sie im Feld From die Anfangszeit für die Daten an, die in das Projekt importiert werden sollen.

  8. Geben Sie im Feld To die Endzeit für die Daten an, die in das Projekt importiert werden sollen.

  9. Wählen Sie im Feld Log upload speed einen Wert im Dropdownmenü aus. Die verfügbaren Werte lauten Low, Medium und High. Diese Werte entsprechen den Einstellungen für die Protokolluploadgeschwindigkeit im Abschnitt Installieren von "SPDiag" von Einrichten und Konfigurieren von "SPDiag".

  10. Klicken Sie auf Import, um die Projektdatenbank zu erstellen.

    Eine Meldung mit folgendem Text wird angezeigt: "Importing project, this may take a few minutes".

  11. Klicken Sie auf OK.

Erforderliche Dateien

Die folgenden Dateien im Ordner C:\Programme\Microsoft\SPAdministrationToolkit\SharePoint Diagnostics sind zum Ausführen von SPDiag über die Befehlszeile erforderlich:

  • Microsoft.Office.SharePoint.SPDiag.AnalysisRules.dll

  • Microsoft.Office.SharePoint.SPDiag.dll

  • Microsoft.Office.SharePoint.SPDiag.MSChartWrapper.dll

  • Microsoft.Office.SharePoint.SPDiag.SharePointWrapper.dll

  • PartitionedViewSchema.sql

  • SPDiag.exe

  • SPDiag.exe.config

  • Spdiag.ico

Wenn Sie SPDiag über die Befehlszeile ausführen möchten, ohne das SharePoint Administration Toolkit zu installieren, müssen Sie die erforderlichen Dateien manuell in einen einzelnen Ordner auf dem Zielcomputer kopieren. Sie können die Dateien von einem Computer kopieren, auf dem SPDiag installiert wurde, und sie aus Gründen der Benutzerfreundlichkeit einem Archiv hinzufügen, z. B. einer ZIP-Datei.

Arbeiten mit Daten

SPDiag erfasst verschiedene Arten von Daten und führt die erfassten Daten in Ansichten und Berichten zusammen. Es gibt drei Hauptansichten in SPDiag, Version 2: Snapshot, Trends und Diagnostics.

Hinweis

Der Bereich Diagnostics ist nur in SPDiag, Version 2, verfügbar. Weitere Informationen hierzu finden Sie unter SPDiag Diagnostics (Registerkarte).

Die Ansicht Snapshot wird standardmäßig angezeigt, wenn Sie SPDiag öffnen. Momentaufnahmedaten, die Informationen über die logische Struktur der Farm sowie Details über die Hard- und Software der Farm enthalten, werden erfasst, indem der Bereich Snapshot aktualisiert wird. Momentaufnahmedaten sind statisch, sobald sie von SPDiag erfasst wurden, und werden nicht in Berichten oder Diagrammen des Bereichs Trends verwendet.

Der SPDiag-Momentaufnahmenbereich (Snapshot pane)

In der Ansicht Trends stellt SPDiag Filter bereit, mit denen Sie spezifische Datenpunkte aus Protokolldateien und Ausgabedaten von Leistungsindikatoren auswählen können, die auf den Servern der Farm erfasst wurden. Diese Daten sind nützlich, wenn Sie Daten einer bestimmten Zeitspanne in der Vergangenheit zu beobachteten Leistungsproblemen in Beziehung setzen möchten.

Der SPDiag-Trendbereich (Trends pane)

Sie können auch Live Capture verwenden, um Daten in Echtzeit zu erfassen, indem ein Datensammlersatz auf einem Zielserver der Farm erstellt und ausgeführt wird. Dies ist nützlich, wenn Sie die Ergebnisse von Echtzeitereignissen hinsichtlich der Farmleistung beobachten möchten. Sie können beispielsweise eine Live Capture-Sitzung starten und dann manuell eine Sicherung der Farm beginnen, um die Ergebnisse zu beobachten. Weitere Informationen finden Sie im Abschnitt "Erfassen von Leistungsindikatordaten mit Live Capture" weiter unten in diesem Artikel.

Wichtig

Bevor Sie die zu erfassenden Daten auswählen, sollten Sie sorgfältig erwägen, welche Datenpunkte benötigt werden, um eine effiziente Problembehandlung durchzuführen und das Erfassen von Daten zu vermeiden, die nicht nützlich sind.

SPDiag verwendet eine SQL Server-Datenbank als Repository für die erfassten Daten. Jedes logische Projekt wird in einer einzelnen Datenbank gespeichert, die Daten aus einem Zeitraum von bis zu sieben Tagen enthalten kann. SPDiag kann Leistungsdaten aus IIS-Protokollen und Leistungsindikatoren auf den Farmservern erfassen. Außerdem können Livedaten von den Servern erfasst werden, indem die in Live Capture konfigurierten Datensammlersätze verwendet werden.

Alle erfassten Datenpunkte von Leistungsindikatoren, Protokollen und Berichten werden je nach Bedarf aus der Projektdatenbank abgerufen. Sobald Sie einen spezifischen Datenpunkt ausgewählt haben, der für einen bestimmten Zeitrahmen angezeigt werden soll, werden die betreffenden Daten in der Projektdatenbank gespeichert und nicht erneut von den Farmservern erfasst.

Wenn Sie gespeicherte Daten verwerfen möchten, können Sie die Projektdatenbank bereinigen, indem Sie im Menü Data auf Purge Data klicken. Durch Auswahl des Datumsbereichs für die zu bereinigenden Daten werden alle Daten aus diesem Datenbereich aus der Projektdatenbank entfernt. Daten, die auf den Farmservern gespeichert sind, z. B. von den Datensammlersätzen erstellte BLG-Dateien, werden beim Bereinigen von Daten in SPDiag nicht von den Farmservern entfernt.

Warnung

Die Datenerfassung, die bei jedem Festlegen von Filterparametern erfolgt, kann lange dauern und die Farmleistung erheblich beeinträchtigen, je nach Serverressourcenverfügbarkeit und dem Umfang der erfassten Daten. In einer großen Farmumgebung oder in einer Umgebung, in der die Netzwerkbandbreite oder andere Ressourcen beschränkt sind, kann die Datenerfassung u. U. mehrere Stunden in Anspruch nehmen.

Bei der ersten Verwendung von SPDiag wird empfohlen, anfangs Daten aus einer kurzen Zeitspanne zu erfassen, sodass Sie die Auswirkungen der Datenerfassung auf die Leistung der Farmserver einschätzen können. Anschließend können Sie die Einstellung für die Uploadgeschwindigkeit im Menü Options nach Bedarf ändern.

Details zum Filtern, Erfassen, Anzeigen und Exportieren von Daten finden Sie in den folgenden Abschnitten.

Security noteSicherheit Hinweis:

Der Benutzer, der SPDiag ausführt, benötigt die Berechtigungen eines Windows-Serveradministrators auf allen Servern der Farm, SharePoint-Farmadministratorberechtigungen und die Berechtigungen db_owner für die SPDiag-Projektdatenbank. Es wird empfohlen, ein vorhandenes Administratorkonto zu verwenden, z. B. das Farmadministratorkonto, statt ein neues zu erstellen. Das Ausführen von SPDiag mit nicht ausreichenden Berechtigungen kann zu einer unvollständigen Datenerfassung sowie zu Verbindungsproblemen oder langsamer Leistung führen.

Ansicht "Snapshot"

SPDiag erfasst Informationen über Hardware, Software und logische Struktur der verbundenen Farm und zeigt diese im Bereich Snapshot an.

Sie können die Momentaufnahme in eine XML-Datei exportieren und diese als Datensatz der Farmkonfiguration und -topologie speichern sowie weitere Problembehandlungsdokumentationen und Wartungsaufzeichnungen ergänzen.

Um die Informationen im Bereich Snapshot zu aktualisieren, klicken Sie mit der rechten Maustaste auf ein Objekt in der Strukturansicht, und klicken Sie dann auf Update. Alle Objekte unter dem ausgewählten Objekt werden dann aktualisiert, um die aktuellen Werte widerzuspiegeln.

Nachdem Sie Daten aus der Farm erfasst haben, werden die erfassten Datenpunkte auf der Registerkarte Trends in den entsprechenden Bereichen dargestellt. Sie können auch Daten aus den erfassten Protokolldateien und Leistungsindikatoren auswählen, um diese in einem benutzerdefinierten Bericht im Bereich Custom Reports einzuschließen. Darüber hinaus können erfasste Leistungsindikatordaten im Bereich Performance Monitor angezeigt werden.

Im Bereich Consolidated Logs View wird der Inhalt aller erfassten IIS-, ULS- und Ereignisprotokolldateien nach Objekt angezeigt. Mithilfe der Schiebeleiste am unteren Rand können Sie die unformatierten Protokolleinträge in diesem Bereich lesen.

Im Bereich Performance Monitor werden die ausgewählten Leistungsindikatordaten in einem grafischen Format angezeigt. Sie wählen die anzuzeigenden Daten aus, indem Sie einen Filter festlegen, mit dem Daten aus den erfassten Leistungsindikatordateien extrahiert werden.

Im Bereich Custom Reports können Sie Berichte anzeigen, in denen die Top Sites sowie langsame und fehlgeschlagene Anforderungen bezüglich der erfassten Daten aufgeführt werden. Diese Daten können Sie auf mehrere nützliche Arten filtern.

Das Auswählen und Erfassen von Daten für eine Trendanalyse erfolgt im Bereich Trends. Greifen Sie auf diesen Bereich zu, indem Sie im Hauptfenster von SPDiag auf die Registerkarte Trends klicken.

Die Hauptfilterleiste am oberen Rand des Bereichs Trends bestimmt den Zeitrahmen und Gültigkeitsbereich (die Webserver und Webanwendungen) der Daten, die in allen drei Abschnitten der Ansicht Trends angezeigt werden. Über die Felder der Hauptfilterleiste geben Sie den Zeitrahmen und den Gültigkeitsbereich für die Datenerfassung sowie für die Anzeige von Daten an, die bereits in die Projektdatenbank hochgeladen wurden. Nachdem Sie Änderungen am Zeitrahmen oder Gültigkeitsbereich vorgenommen haben, klicken Sie auf die Schaltfläche Refresh, um die in der Ansicht Trends angezeigten Daten zu aktualisieren.

Hinweis

In SPDiag, Version 2, könne Sie die Maus verwenden, um einen spezifischen Zeitrahmen im Systemmonitordiagramm zu vergrößern. Klicken Sie zum Vergrößern auf den gewünschten Zeitrahmen, und ziehen Sie mit der Maus. Wenn Sie die Maustaste loslassen, wird das Diagramm aktualisiert und zeigt den ausgewählten Zeitrahmen an. Außerdem wird die Zeitspanne auf der Hauptfilterleiste geändert, um die neue Zeitspanne wiederzuspiegeln. Mit dieser Methode können Sie einen Zoom für immer kürzere Zeitrahmen ausführen.

Um den Zeitrahmen zu ändern, können Sie auf der Hauptfilterleiste die Felder From und To ändern und dann auf die Schaltfläche Refresh klicken. Sie können auch mit der rechten Maustaste auf eine beliebige Stelle im Diagramm klicken, um zum letzten Vergrößerungszustand zurückzukehren.

Wählen Sie zunächst auf der Hauptfilterleiste den Zeitrahmen, die Server und die Webanwendungen aus, von denen Sie Daten erfassen möchten.

Die Leiste für den SPDiag-Masterfilter (Master Filter)

Auswählen des Zeitrahmens und des Gültigkeitsbereichs für die Erfassung

  1. Klicken Sie in SPDiag auf die Registerkarte Trends.

  2. Wählen Sie im Kalendersteuerelement Analyzing das Datum für die Erfassung von Daten aus.

    Tipp

    Wenn Sie in einem SPDiag-Projekt erstmals ein Datum auswählen, können Sie ein beliebiges Datum in der Vergangenheit auswählen. Hierdurch wird der Datumsbereich des Projekts auf sieben aufeinander folgende Tage festgelegt, wobei am ersten ausgewählten Datum begonnen wird. Nach dem Festlegen dieses Datumsbereichs werden alle Datumsangaben außerhalb des Datumsbereichs im Kalendersteuerelement Analyzing abgeblendet dargestellt. Wenn Sie Daten aus einer anderen Zeitspanne analysieren möchten, müssen Sie ein neues SPDiag-Projekt erstellen.

  3. Wählen Sie im Steuerelement From die lokale Serverzeit aus, bei der mit dem Erfassen von Daten begonnen werden soll.

  4. Wählen Sie im Steuerelement To die lokale Serverzeit aus, bei der das Erfassen von Daten beendet werden soll.

  5. Klicken Sie auf die Schaltfläche SharePoint Scope, um die Server und Webanwendungen auszuwählen, von denen Daten erfasst werden sollen.

    Im Dialogfeld Select servers and Web applications werden alle Server und Webanwendungen der Farm aufgeführt. Standardmäßig ist All servers and Web applications aktiviert. Verwenden Sie die Kontrollkästchen neben den einzelnen Servern und Webanwendungen, um diejenigen auszuwählen, von denen Daten erfasst werden sollen.

Wählen Sie anschließend die Protokolldateidaten aus, die für den Zeitrahmen und Gültigkeitsbereich erfasst werden sollen, die Sie im vorherigen Verfahren angegeben haben.

Das Dialogfeld für den SPDiag-Protokollfilter (Log Filter)

Auswählen und Erfassen von Protokolldateidaten

  1. Klicken Sie im Bereich Consolidated log view auf die Schaltfläche Filter Logs.

  2. Im Dialogfeld Merged Logs Filter können Sie IIS-, ULS- und Ereignisprotokolle auswählen. Wenn Sie eine der drei Optionen auswählen, erfasst SPDiag diese Protokolle für den angegebenen Zeitrahmen und Gültigkeitsbereich.

  3. Sie können Datensätze aus der Erfassung ausschließen, indem Sie unter den jeweiligen Protokolltypen einen Filter definieren. Verwenden Sie im Abschnitt Hide entries based on this filter unter einem Protokolltyp das Feld And/Or, um anzugeben, ob eine Filteranweisung vorherige Filteranweisungen ergänzt oder ausschließt. Wählen Sie im Feld Field name den Datensatz aus, den Sie dem Filter hinzufügen möchten. Im Feld Operator legen Sie Anweisungsoperatoren fest (z. B. greater than, equals oder contains), und im Feld Value geben Sie den Wert an, der in der Filteranweisung verwendet werden soll.

    Beachten Sie, dass der Filter für zusammengeführte Protokolle als Ausschlusskriterium funktioniert und alle in einem Filter ausgewählten Datensätze aus der Datenerfassung ausgeschlossen werden.

    Hinweis

    Sie können Filter verwenden, um ausgewählte Daten explizit anzuzeigen, indem Sie negative Operatoren verwenden. Wenn Sie beispielsweise IIS ausgewählt haben, um IIS-Protokolle zu erfassen, können Sie Datensätze erfassen, die für die Client-IP-Adresse 192.168.0.32 spezifisch sind, indem Sie folgenden Filter festlegen:

    • Field name: Client IP address

    • Operator: Not Equal

    • Value: 192.168.0.32

    Durch die Verwendung des Operators Not Equal werden alle Datensätze aus der Erfassung ausgeschlossen, in denen die Client-IP-Adresse nicht dem angegebenen Wert entspricht. Sie können dem Filter weitere OR-Anweisungen mit negativen Operatoren hinzufügen, um explizit andere Datensätze anzuzeigen.

  4. Klicken Sie auf Ok, um die ausgewählten Daten zu erfassen, und schließen Sie das Dialogfeld Merged Logs Filter. Sie können auch auf Apply klicken, wenn Sie die Protokolldateidaten erfassen und das Filterdialogfeld geöffnet lassen möchten.

    Hinweis

    Wenn Sie auf Apply klicken, um die ausgewählten Daten zu erfassen, und anschließend auf Ok klicken, werden die Daten erneut von den Farmservern erfasst. Um das Dialogfeld Merged Logs Filter ohne eine Aktualisierung der Daten zu schließen, klicken Sie auf Cancel.

Tipp

In einigen Fällen kann es lange dauern, eine Perfmon-BLG-Datei (von einem Datensammlersatz erstellte binäre Datei) in die Projektdatenbank hochzuladen. Dies kann zutreffen, wenn die BLG-Datei eine große Anzahl Leistungsindikatoren oder viele Daten enthält. Wenn das Hochladen einer BLG-Datei zu lange dauert, können Sie das integrierte Windows Server-Tool Relog.exe verwenden, um die Protokolldatei erneut zusammenzustellen und eine neue Protokolldatei auf Grundlage spezifischer Indikatoren, einer bestimmten Zeitspanne oder einem längeren Erfassungsintervall zu erstellen.

Beispielsweise können Sie den folgenden Befehl verwenden, um eine neue Protokolldatei zu erstellen, die nur die Daten für die gesamte Prozessorzeit enthält:

relog logfile.blg -c "\Processor(_Total)\% Processor Time" -o newlogfile.blg

Wenn Sie Relog.exe verwenden, um eine kleinere BLG-Datei auf einem Farmserver zu erstellen, sollten Sie die ursprüngliche BLG-Datei in einen Ordner verschieben, der nicht von SPDiag gelesen wird. Der Ordner, mit dem SPDiag auf Leistungsindikatordaten für die einzelnen Farmserver zugreift, finden Sie auf der Registerkarte Files. Auf diese greifen Sie zu, indem Sie Tools und dann Options auswählen.

Weitere Informationen zur Verwendung von relog.exe finden Sie unter Two Minute Drill: RELOG.EXE (Kurzübung zu RELOG.EXE; in englischer Sprache) (https://go.microsoft.com/fwlink/?linkid=141333&clcid=0x407).

Wählen Sie als Nächstes Leistungsindikatordaten für den angegebenen Zeitrahmen und Gültigkeitsbereich aus.

Das Dialogfeld für den SPDiag-Leistungsindikatorfilter (Performance Counter Filter)

Auswählen und Erfassen von Leistungsindikatordaten

  1. Klicken Sie im Bereich Performance Monitor auf die Schaltfläche Filter Counter.

  2. Wählen Sie im Dialogfeld Performance Counter im Menü Servers einen Wert aus. Sie können in dem Menü einen Servernamen auswählen, um spezifische Leistungsindikatoren des betreffenden Farmservers anzuzeigen. Außerdem können Sie Farm auswählen, wodurch berechnete farmweite Messungen auf Grundlage von IIS-Protokolldaten angezeigt werden.

    1. Wenn Sie im Menü Servers einen Server ausgewählt haben, wird im Feld darunter eine Liste erweiterbarer Leistungsindikatorkategorien angezeigt. Erweitern Sie eine Kategorie, und wählen Sie in der Liste der verfügbaren Abfragen einen Leistungsindikator aus, indem Sie darauf klicken.

    2. Wenn Sie im Menü Servers die Option Farm ausgewählt haben, wird im Feld darunter eine erweiterbare Struktur mit dem Titel SharePointRequests angezeigt. Erweitern Sie das übergeordnete Element, und wählen Sie in der Liste der verfügbaren Abfragen eine Abfrage aus, indem Sie darauf klicken.

      Das Dialogfeld für den SPDiag-Berechnungszählerfilter (Calculated Counter Filter)

  3. Durch Auswahl einer Abfrage werden die jeweils verfügbaren Instanzen im Bereich Instances of selected object auf der rechten Seite des Dialogfelds angezeigt. Klicken Sie auf die Instanz, die Sie auswählen möchten.

    1. Wenn Sie im Menü Servers einen Server ausgewählt haben und einen Leistungsindikator auswählen, werden die jeweils verfügbaren Instanzen angezeigt, die sich je nach Indikator unterscheiden können. Falls im Bereich Instances of selected object keine Instanzen angezeigt werden, wird das Leistungsindikator-Hauptobjekt verwendet.

    2. Wenn Sie im Menü Servers die Option Farm ausgewählt haben, werden für jede ausgewählte Abfrage die Instanzen _Total und _Master-Filter angezeigt. Durch Auswahl der Instanz _Total werden diese Daten von allen Farmservern erfasst, und durch Auswahl von _Master-Filter werden nur von den Servern Daten erfasst, die derzeit auf der Hauptfilterleiste unter SharePoint Scope aktiviert sind.

  4. Sie können auch eine Farbe für die angezeigten Daten und die Skalierung der Anzeige auswählen und dann auf Add klicken. Die ausgewählte Leistungsindikatorinstanz wird im Bereich Performance Monitor angezeigt.

    Wiederholen Sie diesen Schritt für jeden Leistungsindikator, den Sie der Anzeige hinzufügen möchten.

  5. Nachdem Sie alle Leistungsindikatorinstanzen, die Sie erfassen möchten, ausgewählt und hinzugefügt haben, klicken Sie auf OK, um die Daten von der Farm zu erfassen.

Hinweis

Wenn einige der ausgewählten Daten bereits erfasst wurden, zeigt SPDiag die erfassten Daten an, anstatt diese erneut von der Farm zu erfassen.

Sie können die Leistungsindikatoranzeige ändern, indem Sie Indikatoren ausblenden. Deaktivieren Sie in der Liste der angezeigten Indikatoren in der Spalte Show das Kontrollkästchen für den auszublendenden Indikator. Aktivieren Sie das Kontrollkästchen, um der Anzeige den Indikator wieder hinzuzufügen.

Sie können einen Indikator auch dauerhaft aus der Anzeige entfernen, indem Sie auf die Schaltfläche Remove für den spezifischen Indikator klicken.

Erstellen eines benutzerdefinierten Berichts aus erfassten Daten

Im Bereich Custom Reports können Sie abhängig von den Daten, die über die Filter in den Bereichen Consolidated Logs und Performance Monitor erfasst wurden, drei verschiedene Typen von Berichten generieren. Sie können die folgenden benutzerdefinierten Berichtstypen erstellen:

  • Bericht über Top Sites, in dem die Websites der Farm aufgeführt werden, die in der Zeitspanne, in der Daten erfasst wurden, die meisten Zugriffe aufweisen.

  • Bericht über langsame Anforderungen, in dem die Anforderungen mit den längsten Antwortzeiten aufgelistet werden.

  • Bericht über fehlgeschlagene Anforderungen, in dem alle Anforderungen aufgeführt werden, auf die die Farm nicht geantwortet hat.

Sie können die Daten für den Bericht mithilfe des Filters Custom Reports filtern. Die Filterparameter bleiben innerhalb eines SPDiag-Projekts zwischen den Verwendungen des Dialogfelds Custom Reports Filter bestehen, d. h., wenn Sie ein Projekt in SPDiag schließen und dann erneut öffnen, werden die zuvor definierten Filterparameter angezeigt, wenn Sie den Filter öffnen.

Hinweis

Der Filter Custom Reports ermöglicht Ihnen die Auswahl aus zuvor erfassten Daten in der Projektdatenbank. Es werden keine neuen Daten von den Farmservern erfasst. Sie müssen Protokolldaten mithilfe des Filters im Bereich Consolidated Logs View erfassen, bevor Sie einen benutzerdefinierten Bereicht generieren können.

Das Dialogfeld für den SPDiag-Berichtsfilter (Report Filter)

Filtern von Daten für einen benutzerdefinierten Bericht

  1. Klicken Sie in der Ansicht Trends im Bereich Custom Reports auf die Schaltfläche Filter Reports.

  2. Wählen Sie im Dialogfeld Custom Reports Filter im Menü Report Type den Berichtstyp aus, den Sie erstellen möchten.

  3. Wenn Sie den Bericht anhand aller verfügbaren Daten erstellen möchten, klicken Sie auf Ok, um den Bericht anzuzeigen und das Dialogfeld Custom Reports Filter zu schließen, oder klicken Sie auf Apply, um den Bericht anzuzeigen, ohne das Dialogfeld Custom Reports Filter zu schließen.

  4. Sie können Datensätze aus dem Bericht ausschließen, indem Sie Filterparameter festlegen. Verwenden Sie im Abschnitt Hide entries based on this filter das Feld And/Or, um anzugeben, ob eine Filteranweisung vorherige Filteranweisungen ergänzt oder ausschließt. Wählen Sie im Feld Field name den Datensatz aus, den Sie dem Filter hinzufügen möchten. Im Feld Operator legen Sie Anweisungsoperatoren fest (z. B. greater than, equals oder contains), und im Feld Value geben Sie den Wert an, der in der Filteranweisung verwendet werden soll.

    Tipp

    Um einen Parameter aus dem Filter zu entfernen, klicken Sie mit der rechten Maustaste in die Zeile, und klicken Sie dann auf Delete.

    Beachten Sie, dass der Filter Custom Reports ebenso wie der Filter Merged Logs als Ausschlusskriterium funktioniert und dass alle in einem Filter ausgewählten Datensätze aus dem Bericht ausgeschlossen werden.

    Hinweis

    Sie können Filter verwenden, um Daten explizit auszuwählen, indem Sie negative Operatoren verwenden. Wenn Sie beispielsweise in der Spalte Field Name das Feld Host ausgewählt haben, können Sie Datensätze erfassen, die für den Host SERVER1 spezifisch sind, indem Sie folgenden Filter festlegen:

    • Field name: Host

    • Operator: Not Equal

    • Value: SERVER1

    Durch Verwendung des Operators Not Equal werden alle Datensätze aus dem Bericht ausgeschlossen, in denen der Hostname nicht dem angegebenen Wert entspricht. Sie können dem Filter weitere OR-Anweisungen mit negativen Operatoren hinzufügen, um explizit andere Datensätze anzuzeigen.

  5. Klicken Sie auf Ok, um den Bericht zu erstellen und das Dialogfeld Custom Reports Filter zu schließen. Sie können auch auf Apply klicken, wenn Sie den Bericht erstellen und das Dialogfeld Custom Reports Filter geöffnet lassen möchten.

Sie können den Bericht jetzt im Bereich Custom Report anzeigen.

Erfassen von Leistungsindikatordaten mit Live Capture

Zusätzlich zum Erfassen von Daten aus Protokollen und Leistungsindikatordateien kann SPDiag mithilfe von Live Capture auch bedarfsgesteuerte Leistungsindikatorinformationen erfassen. Das SPDiag-Feature Live Capture ermöglicht Ihnen das Erstellen eines Datensammlersatzes auf dem Zielserver, um Leistungsindikatordaten in Echtzeit aufzuzeichnen.

Nachdem der erstellte Datensammlersatz auf dem Zielserver ausgeführt wurde, können Sie den Filter im Bereich Performance Monitor verwenden, um Daten aus dem Datensammlersatz auszuwählen und zu erfassen. Das Feature Live Capture erfasst selbst keine Daten, sondern ermöglicht es Ihnen lediglich, einen Sammlersatz zu erstellen, um eine Datendatei auf dem Zielserver zu generieren.

Hinweis

Es kann immer nur jeweils ein Datensammlersatz auf einem bestimmten Server erstellt werden.

Das Dialogfeld für SPDiag-Direktaufzeichnungen (Live Capture)

Führen Sie das folgende Verfahren aus, um Daten mithilfe von Live Capture zu erfassen.

Erstellen eines Datensammlersatzes mit Live Capture

  1. Klicken Sie im Menü Data auf Live Capture.

  2. Wählen Sie im Dialogfeld Live Capture im Menü Servers den Farmserver aus, von dem Sie Daten erfassen möchten.

  3. Sobald Sie einen Server ausgewählt haben, wird im Feld darunter eine Liste der verfügbaren Leistungsindikatoren angezeigt. Wählen Sie einen zu erfassenden Indikator aus, und klicken Sie auf die Schaltfläche Add.

    Beachten Sie, dass einige Indikatoren mehrere Instanzen aufweisen, die bei Auswahl des jeweiligen Indikators im Feld Instances of selected object angezeigt werden. Wählen Sie in diesem Fall die gewünschte Instanz aus dieser Liste aus, und klicken Sie auf die Schaltfläche Add. Wiederholen Sie diesen Vorgang für jede Instanz, die Sie hinzufügen möchten.

  4. Nachdem Sie alle zu erfassenden Leistungsindikatorinstanzen hinzugefügt haben, legen Sie im Abschnitt Capture Options die Option Sample Interval auf die Anzahl der Sekunden zwischen den Stichproben fest. Der Standardwert beträgt fünf Sekunden.

    Warnung

    Wenn Sie ein kürzeres Stichprobenintervall auswählen, werden im angegebenen Zeitrahmen mehr Daten erfasst, und die Erfassung dauert länger.

  5. Verwenden Sie im Abschnitt Capture counters between die obere Zeile mit Datums- und Uhrzeitfeldern, um Anfangszeit und -datum für Live Capture festzulegen. Legen Sie Endzeit und -datum in der unteren Zeile mit Datums- und Uhrzeitfeldern fest. Diese Einstellungen stellen die lokalen Datumsangaben und Uhrzeiten auf dem Server dar.

  6. Wenn Sie ein Live Capture-Vorgang außer Kraft setzen möchten, das u. U. derzeit auf dem Zielserver ausgeführt wird, lassen Sie das Kontrollkästchen Replace a currently running Live Capture on that server with this new definition aktiviert.

  7. Klicken Sie auf Create, um den Datensammlersatz auf dem Zielserver zu erstellen und auszuführen.

  8. Klicken Sie auf Close, um das Dialogfeld Live Capture zu schließen.

Der erstellte Datensammlersatz generiert eine BLG-Datei, die die Ausgabe der angegebenen Leistungsindikatoren enthält. Diese Daten können dann über den Filter Performance Monitor erfasst werden.

Sie können auch den zuletzt auf einem Farmserver erstellten Sammlersatz manuell starten, beenden und löschen. Dies ist beispielsweise nützlich, wenn Sie einen derzeit ausgeführten Sammlersatz beenden und erneut starten möchten. Beachten Sie jedoch, dass Sie keinen abgelaufenen Sammlersatz starten können. Wenn Sie einen Sammlersatz mit denselben Indikatoren wie bei einem abgelaufenen Satz ausführen möchten, müssen Sie einen neuen Sammlersatz erstellen, oder Sie lassen einfach das Dialogfeld Live Capture geöffnet, wenn Sie mehrere Instanzen eines Sammlersatzes nacheinander ausführen möchten.

Starten, Beenden oder Löschen eines Sammlersatzes

  1. Klicken Sie im Menü Data auf Live Capture.

  2. Wählen Sie am unteren Rand des Dialogfelds Live Capture im Abschnitt Collector Sets im Menü Servers den Zielserver aus.

  3. Um den zuletzt erstellten Sammlersatz zu starten, klicken Sie auf Start.

    Klicken Sie auf Stop, um den zuletzt erstellten Sammlersatz zu beenden.

    Um den zuletzt erstellten Sammlersaz zu löschen, klicken Sie auf Delete und dann im angezeigten Dialogfeld auf Yes.

  4. Klicken Sie auf Close, um das Dialogfeld Live Capture zu schließen.

Hinweis

Sie können einen vorhandenen Datensammlersatz in SPDiag nicht bearbeiten. Sie können einen Sammlersatz auf dem Server bearbeiten, auf dem er erstellt wurde.

Weitere Informationen über Sammlersätze finden Sie in "Szenario 3: Erstellen eines Sammlungssatzes in der Leistungsüberwachung" im TechNet-Artikel Schrittweise Anleitung für die Leistungs- und Zuverlässigkeitsüberwachung in Windows Server 2008 (https://go.microsoft.com/fwlink/?linkid=141339&clcid=0x407).

Exportieren von Daten

Sie können Daten aus SPDiag in Form von Berichten exportieren. Die verfügbaren Berichte sind Snapshot, derzeit angezeigte Diagramme, derzeit angezeigte benutzerdefinierte Berichte sowie derzeit angezeigte Ereignisse und Protokolle.

Wenn Sie eine Momentaufnahme exportieren, werden Sie gefragt, ob Sie die Momentaufnahme vor dem Export aktualisieren möchten. Falls die Momentaufnahmedaten in letzter Zeit nicht aktualisiert wurden, können Sie auf Yes klicken, um die Daten vor dem Export automatisch zu aktualisieren.

Exportieren eines Berichts

  1. Klicken Sie im Menü Data auf Export.

  2. Aktivieren Sie im Dialogfeld Export Reports die Kontrollkästchen für die Berichte, die Sie exportieren möchten.

  3. Klicken Sie im Feld Location zum Navigieren auf Select folder, oder geben Sie den Pfad zum entsprechenden Exportordner ein.

  4. Klicken Sie auf Export, um die Dateien zu exportieren.

Wenn Sie die exportierten Daten an Dritte übermitteln, können Sie die Datei mit einer handelsüblichen Anwendung zur Datenkomprimierung komprimieren, um deren Größe zu verringern. Der Microsoft-Kundendienst kann diese Dateien verwenden, um Sie beim Identifizieren von Problemen mit Ihrer SharePoint-Farm zu unterstützen.

In der folgenden Tabelle werden die Dateien aufgeführt, die von SPDiag exportiert werden.

Dateiname Beschreibung

Snapshot.xml

Momentaufnahmedaten

CounterGraph.bmp

Das im Bereich Performance Monitor dargestellte Diagramm

SelectedCounterList.txt

Die Liste der Indikatoren, die zum Darstellen des Diagramms verwendet wurden

CustomReport.txt

Der im Bereich Custom Report dargestellte aktuelle Bericht

MergedLog.txt

Der Inhalt des Bereichs Merged Log