Verwenden der umfassenden Protokollierung für synthetische Transaktionen in Lync Server 2013

  • Artikel

 

Letzte Änderung: 22.10.2012

Synthetische Transaktionen (eingeführt in Microsoft Lync Server 2010) bieten Administratoren die Möglichkeit, zu überprüfen, ob Benutzer allgemeine Aufgaben wie die Anmeldung beim System, den Austausch von Chatnachrichten oder das Tätigen von Anrufen an ein Telefon im Telefonfestnetz (Public Switched Telephone Network, PSTN) erfolgreich ausführen können. Diese Tests (die als Lync Server-Windows PowerShell Cmdlets verpackt sind) können manuell von einem Administrator durchgeführt werden, oder sie können automatisch von einer Anwendung wie System Center Operations Manager ausgeführt werden.

In Lync Server 2010 erwiesen sich synthetische Transaktionen als äußerst nützlich, um Administratoren dabei zu helfen, Probleme mit dem System zu erkennen. Beispielsweise könnte das Cmdlet Test-CsRegistration Administratoren darüber informieren, dass einige Benutzer Schwierigkeiten bei der Registrierung bei Lync Server hatten. Die synthetischen Transaktionen waren jedoch etwas weniger hilfreich, um Administratoren zu helfen, zu ermitteln, warum diese Benutzer Schwierigkeiten bei der Registrierung bei Lync Server hatten. Dies lag daran, dass die synthetischen Transaktionen keine detaillierten Protokollierungsinformationen bereitstellten, die Administratoren bei der Behandlung von Problemen mit Lync Server helfen konnten. Bestenfalls lieferte die ausführliche Ausgabe einer synthetischen Transaktion schrittweise Informationen, die es einem Administrator ermöglichen könnten, eine fundierte Vermutung darüber zu machen, wo ein Problem wahrscheinlich aufgetreten ist.

In Microsoft Lync Server 2013 wurden synthetische Transaktionen umgestaltet, um umfassende Protokollierung bereitzustellen. "Rich Logging" bedeutet, dass für jede Aktivität, die eine synthetische Transaktion durchführt, Informationen wie diese aufgezeichnet werden:

  • Der Zeitpunkt, zu dem die Aktivität gestartet wurde

  • Die Zeit, zu der die Aktivität abgeschlossen wurde

  • Die ausgeführte Aktion (z. B. Erstellen, Beitreten oder Verlassen einer Konferenz, Anmelden bei Lync Server, Senden einer Chatnachricht usw.)

  • Informative oder ausführliche Meldungen bzw. Warn- oder Fehlermeldungen, die beim Ausführen der Aktivität generiert wurden

  • SIP-Registrierungsmeldungen

  • Ausnahmedatensätze oder Diagnosecodes, die beim Ausführen der Aktivität generiert wurden

  • Das Nettoergebnis der Ausführung der Aktivität

Diese Informationen werden bei jeder Ausführung einer synthetischen Transaktion automatisch generiert. Die Informationen werden jedoch nicht automatisch angezeigt oder in einer Protokolldatei gespeichert. Stattdessen können Administratoren, die eine synthetische Transaktion manuell ausführen, den Parameter OutLoggerVariable verwenden, um eine Windows PowerShell Variable anzugeben, in der die Informationen gespeichert werden. Von dort aus können Administratoren dann ein Methodenpaar verwenden, mit dem sie das umfangreiche Protokoll im XML- oder HTML-Format speichern und/oder anzeigen können.

Beispielsweise können Lync Server 2010-Administratoren das Cmdlet "Test-CsRegistration " mit einem Befehl ausführen, der dem folgenden ähnelt:

Test-CsRegistration -TargetFqdn atl-cs-001.litwareinc.com

Administratoren haben die Möglichkeit, den OutLoggerVariable-Parameter gefolgt von einem Variablennamen ihrer Wahl anzugeben:

Test-CsRegistration -TargetFqdn atl-cs-001.litwareinc.com -OutLoggerVariable RegistrationTest

Hinweis

Stellen Sie dem Variablennamen nicht das $-Zeichen voran. Verwenden Sie einen Variablennamen wie RegistrationTest und nicht $RegistrationTest.

Der vorherige Befehl gibt Inhalt ähnlich dem folgenden aus:

Target Fqdn   : atl-cs-001.litwareinc.com
Result        : Failure
Latency       : 00:00:00
Error Message : This machine does not have any assigned certificates.
Diagnosis     :

Für diesen Fehler stehen jedoch viel ausführlichere Informationen zur Verfügung als nur die oben gezeigte Fehlermeldung. Um auf diese Informationen im HTML-Format zuzugreifen, verwenden Sie einen ähnlichen Befehl, um die in der Variablen RegistrationTest gespeicherten Informationen in einer HTML-Datei zu speichern:

$RegistrationTest.ToHTML() | Out-File C:\Logs\Registration.html

Alternativ können Sie die ToXML()-Methode verwenden, um Dateien in einer XML-Datei zu speichern:

$RegistrationTest.ToXML() | Out-File C:\Logs\Registration.xml

Diese Dateien können dann mit Internet Explorer, Visual Studio oder einer anderen Anwendung angezeigt werden, die HTML/XML-Dateien öffnen kann.

Synthetische Transaktionen, die innerhalb von System Center Operations Manager ausgeführt werden, generieren automatisch diese Protokolldateien für Fehler. Diese Protokolle werden jedoch nicht generiert, wenn die Ausführung fehlschlägt, bevor Windows PowerShell die synthetische Transaktion laden und ausführen kann.

Wichtig

Standardmäßig speichert Lync Server 2013 Protokolldateien in einem Ordner, der nicht freigegeben ist. Damit diese Protokolle leicht zugänglich sind, sollten Sie diesen Ordner freigeben (z. B. \\atl-watcher-001.litwareinc.com\WatcherNode.