Konfigurieren von Anbietern für den zentralisierten Protokollierungsdienst in Lync Server 2013

  • Artikel

 

Thema Letzte Änderung: 19.03.2014

Die Konzepte und Die Konfiguration von Anbietern im zentralisierten Protokollierungsdienst ist eines der wichtigsten, die es zu verstehen gilt. Die Anbieter werden Lync Server-Serverrollenkomponenten im Lync Server-Ablaufverfolgungsmodell direkt zugeordnet. Der Anbieter definiert die Komponenten eines zu erfassenden Lync Server 2013, den Typ der nachrichten (z. B. schwerwiegende Nachrichten, Fehler oder Warnung) und die Flags (z. B. TF_Connection oder TF_Diag). Anbieter sind die nachverfolgbaren Komponenten in jeder Lync Server-Serverrolle. Mithilfe von Anbietern definieren Sie die Ablaufverfolgungsebene und den Typ von Verfolgung für Komponenten (z. B. S4, SIPStack, Chat oder Anwesenheit). Der festgelegte Anbieter wird in einem Szenario verwendet, um sämtliche Anbieter für eine vorgegebene logische Auflistung zu gruppieren, die eine bestimmte Problembedingung betrifft.

Um die Funktionen des zentralisierten Protokollierungsdiensts mithilfe der Lync Server-Verwaltungsshell auszuführen, müssen Sie Entweder Mitglied der rollenbasierten Zugriffssteuerungsgruppe "CsAdministrator" oder "CsServerAdministrator" oder einer benutzerdefinierten RBAC-Rolle sein, die eine dieser beiden Gruppen enthält. Um eine Liste aller rollenbasierten Zugriffssteuerungsrollen (Role-Based Access Control, RBAC) zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich aller benutzerdefinierten RBAC-Rollen, die Sie selbst erstellt haben), führen Sie den folgenden Befehl in der Lync Server-Verwaltungsshell oder in der Windows PowerShell Eingabeaufforderung aus:

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Lync Server 2013 cmdlet"}

Zum Beispiel: 

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Set-CsClsConfiguration"}

Der Rest dieses Themas konzentriert sich auf das Definieren von Anbietern, das Ändern eines Anbieters und das, was eine Anbieterdefinition enthält, um die Problembehandlung zu optimieren. Es gibt zwei Möglichkeiten zum Ausgeben von Befehlen des zentralisierten Protokollierungsdiensts. Sie können die CLSController.exe verwenden, die sich standardmäßig im Verzeichnis "C:\Program Files\Common Files\Microsoft Lync Server 2013\CLSAgent" befindet. Sie können auch die Lync Server-Verwaltungsshell verwenden, um Windows PowerShell Befehle ausstellen. Der wichtige Unterschied besteht darin, dass bei Verwendung von CLSController.exe in der Befehlszeile eine begrenzte Auswahl von Szenarien verfügbar ist, in denen die Anbieter bereits definiert sind und nicht geändert werden können, Sie aber die Protokollebene definieren können. Mithilfe von Windows PowerShell können Sie neue Anbieter für die Verwendung in Ihren Protokollierungssitzungen definieren und haben die vollständige Kontrolle über deren Erstellung, ihre Sammlung und auf welcher Ebene sie Daten sammeln.

Wichtig

Wie schon erwähnt sind Anbieter äußerst leistungsfähig. Szenarien sind jedoch noch leistungsfähiger, da sie die Darstellung sämtlicher Informationen enthalten, die zum Festlegen und Ausführen der Ablaufverfolgung für die Komponenten erforderlich sind, die die Anbieter darstellen. Diese Vorstellung von Szenarien als Auflistung von Anbietern lässt sich in etwa mit einer Batchdatei vergleichen, die Hunderte von Befehlen ausführt, um eine Vielzahl an Informationen zu sammeln, anstatt dass man jeden Befehl einzeln an der Befehlszeile ausführen muss.
Anstatt dass Sie sich ausführlich mit den Details von Anbietern befassen müssen, bietet der zentralisierte Protokollierungsdienst eine Reihe von Szenarien, die bereits für Sie definiert sind. Die bereitgestellten Szenarien decken die überwiegende Mehrheit der möglichen Probleme ab, auf die Sie stoßen werden. In seltenen Fällen müssen Sie möglicherweise Anbieter erstellen und definieren und sie Szenarien zuweisen. Es wird dringend empfohlen, sich mit jedem der bereitgestellten Szenarien vertraut zu machen, bevor Sie die Notwendigkeit untersuchen, neue Anbieter und Szenarien zu erstellen. Während Hier Informationen zum Erstellen von Anbietern zu finden sind, um Sie mit der Verwendung der Anbieterelemente zum Sammeln von Ablaufverfolgungsinformationen in den Szenarien vertraut zu machen, werden derzeit keine Details zu den Anbietern selbst bereitgestellt.

Eingeführt in der Übersicht über den zentralisierten Protokollierungsdienst in Lync Server 2013 sind die wichtigsten Elemente der Definition eines Anbieters für die Verwendung in einem Szenario:

  • Anbieter Wenn Sie mit OCSLogger vertraut sind, sind Anbieter die Komponenten, die Sie auswählen, um OCSLogger mitzuteilen, von welchem Ablaufverfolgungsmodul Protokolle gesammelt werden sollen. Die Anbieter sind die gleichen Komponenten und haben in vielen Fällen denselben Namen wie die Komponenten in OCSLogger. Wenn Sie mit OCSLogger nicht vertraut sind, sind Anbieter serverrollenspezifische Komponenten, von denen der zentralisierte Protokollierungsdienst Protokolle sammeln kann. Im Fall des zentralisierten Protokollierungsdiensts ist der CLSAgent der Architekturteil des zentralisierten Protokollierungsdiensts, der die Ablaufverfolgung der Komponenten ausführt, die Sie in der Anbieterkonfiguration definieren.

  • Protokollierungsebenen OCSLogger bot die Möglichkeit, eine Reihe von Detailebenen für die gesammelten Daten auszuwählen. Dieses Feature ist ein integraler Bestandteil des zentralisierten Protokollierungsdiensts und der Szenarien und wird durch den Parameter "Type " definiert. Sie können aus den folgenden Optionen wählen:

    • Alle Erfasst Ablaufverfolgungsmeldungen vom Typ "schwerwiegend", "Fehler", "Warnung" und "Informationen" im Protokoll für den definierten Anbieter.

    • Schwerwiegender Sammelt nur die Ablaufverfolgungsmeldungen, die auf einen Fehler für den definierten Anbieter hinweisen.

    • Fehler Sammelt nur die Ablaufverfolgungsmeldungen, die auf einen Fehler für den definierten Anbieter hinweisen, sowie schwerwiegende Nachrichten.

    • Warnung Sammelt nur die Ablaufverfolgungsmeldungen, die eine Warnung für den definierten Anbieter angeben, sowie schwerwiegende und Fehlermeldungen.

    • Informationen Erfasst nur die Ablaufverfolgungsmeldungen, die eine Informationsnachricht für den definierten Anbieter sowie schwerwiegende, Fehler- und Warnmeldungen angeben.

    • Ausführliche Sammelt alle Ablaufverfolgungsmeldungen vom Typ "schwerwiegend", "Fehler", "Warnung" und "Info" für den definierten Anbieter.

  • Flaggen OCSLogger hat die Option zum Auswählen von Flags für jeden Anbieter bereitgestellt, die definiert haben, welche Art von Informationen Sie aus den Ablaufverfolgungsdateien abrufen können. Sie können die folgenden Flags basierend auf dem Anbieter auswählen:

    • TF_Connection Stellt verbindungsbezogene Protokolleinträge bereit. Diese Protokolle enthalten Informationen zu Verbindungen, die zu und von einer bestimmten Komponente hergestellt wurden. Dies kann auch wichtige Informationen auf Netzwerkebene enthalten (d. a. für Komponenten ohne das Konzept einer Verbindung).

    • TF_Security Stellt alle Ereignisse/Protokolleinträge im Zusammenhang mit der Sicherheit bereit. Bei SipStack sind dies beispielsweise Sicherheitsereignisse wie Domänenüberprüfungsfehler und Clientauthentifizierungs-/Autorisierungsfehler.

    • TF_Diag Stellt Diagnoseereignisse bereit, die Sie zum Diagnostizieren oder Behandeln von Problemen mit der Komponente verwenden können. Bei SipStack sind dies z. B. Zertifikatfehler oder DNS-Warnungen/Fehler.

    • TF_Protocol Stellt Protokollnachrichten wie SIP- und kombinierte Community Codec Pack-Nachrichten bereit.

    • TF_Component Aktiviert die Protokollierung der Komponenten, die als Teil der Anbieter angegeben sind.

    • Alle Legt alle verfügbaren Flags fest, die für den Anbieter verfügbar sind.

So überprüfen Sie Informationen zu vorhandenen Szenarienanbietern für den zentralisierten Protokollierungsdienst

  1. Starten Sie die Lync Server-Verwaltungsshell: Klicken Sie auf "Start", dann auf "Alle Programme", dann auf "Microsoft Lync Server 2013" und dann auf "Lync Server-Verwaltungsshell".

  2. Mit dem folgenden Befehl können Sie die Konfiguration vorhandener Anbieter überprüfen:

    Get-CsClsScenario -Identity <scope and scenario name>

    Wenn Sie beispielsweise Informationen über die globale Konferenzzentrale überprüfen möchten, geben Sie Folgendes ein:

    Get-CsClsScenario -Identity "global/CAA"

    Der Befehl listet Anbieter mit den zugehörigen Flags, Einstellungen und Komponenten auf. Wenn die angezeigten Informationen nicht ausreichen oder die Liste für das Standardmäßige Windows PowerShell Listenformat zu lang ist, können Sie zusätzliche Informationen anzeigen, indem Sie eine andere Ausgabemethode definieren. Geben Sie dazu Folgendes ein:

    Get-CsClsScenario -Identity "global/CAA" | Select-Object -ExpandProperty Provider

    Dieser Befehl gibt die einzelnen Anbieter in einem fünfzeiligen Format aus, bei dem der Anbietername, der Protokollierungstyp, die Protokollierungsebene, Flags, GUID und Rolle jeweils in einer eigenen Zeile angezeigt werden.

So definieren Sie einen neuen Szenarioanbieter für den zentralisierten Protokollierungsdienst

  1. Starten Sie die Lync Server-Verwaltungsshell: Klicken Sie auf "Start", dann auf "Alle Programme", dann auf "Microsoft Lync Server 2013" und dann auf "Lync Server-Verwaltungsshell".

  2. Ein Szenarioanbieter besteht aus einer nachzuverfolgenden Komponente, zu verwendenden Flags und einer Detailstufe für die Erfassung. Geben Sie dazu Folgendes ein:

    $<variableName> = New-CsClsProvider -Name <provider component> -Type <log type> -Level <log level detail type> -Flags <provider trace log flags>

    Beispiel: Die Definition eines Ablaufverfolgungsanbieters, in der festgelegt ist, was und mit welcher Detailstufe vom Anbieter „Lyss“ erfasst werden soll, sieht so aus:

    $LyssProvider = New-CsClsProvider -Name "Lyss" -Type "WPP" -Level "Info" -Flags "All"

Die –Ebene sammelt Nachrichten zu schwerwiegenden Ereignissen, Fehlern, Warnungen und Informationen. Die verwendeten Flags sind alle, die für den Lyss-Anbieter definiert sind, und umfassen TF_Connection, TF_Diag und TF_Protocol.

Nachdem die Variable „$LyssProvider“ definiert ist, können Sie sie mit dem Cmdlet New-CsClsScenario verwenden, um Ablaufverfolgungen vom Anbieter „Lyss“ zu sammeln. Geben Sie für die Erstellung und Zuweisung des Anbieters zu einem neuen Szenario den folgenden Befehl ein:

New-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo" -Provider $LyssProvider

Hierbei ist „$LyssProvider“ die Variable, in der sich das definierte Szenario befindet, das mit New-CsClsProvider erstellt wurde.

So ändern Sie einen vorhandenen Szenarioanbieter für den zentralisierten Protokollierungsdienst

  1. Starten Sie die Lync Server-Verwaltungsshell: Klicken Sie auf "Start", dann auf "Alle Programme", dann auf "Microsoft Lync Server 2013" und dann auf "Lync Server-Verwaltungsshell".

  2. Geben Sie Folgendes ein, um die Konfiguration eines vorhandenen Anbieters zu aktualisieren oder zu ändern:

    $LyssProvider = New-CsClsProvider -Name "Lyss" -Type "WPP" -Level "Debug" -Flags "TF_Connection, TF_Diag"

    Aktualisieren Sie das Szenario anschließend mit der folgenden Eingabe, um den Anbieter zuzuweisen:

    Set-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo" -Provider $LyssProvider

Dieser Befehl bewirkt, dass beim Szenariostandort „Redmond/RedmondLyssInfo“ die Flags und die Ebene für den zugewiesenen Anbieter aktualisiert werden. Das neue Szenario können Sie mithilfe von „Get-CsClsScenario“ anzeigen. Weitere Informationen dazu finden Sie unter Get-CsClsScenario.

Warnung

New-ClsCsProvider überprüft nicht, ob die Flags gültig sind. Sie müssen sicherstellen, dass die Namen der Flags keine Schreibfehler enthalten (z. B. TF_DIAG oder TF_CONNECTION). Wenn die Flags falsch geschrieben sind, kann der Anbieter nicht die gewünschten Protokollinformationen zurückgeben.

Wenn Sie diesem Szenario weitere Anbieter hinzufügen möchten, geben Sie Folgendes ein:

Set-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo" -Provider @{Add=$ABSProvider, $CASProvider, S4Provider}

Hierbei wurde jeder mit der „Add“-Anweisung festgelegte Anbieter bereits mithilfe des New-CsClsProvider-Prozesses definiert.

So entfernen Sie einen Szenarioanbieter

  1. Starten Sie die Lync Server-Verwaltungsshell: Klicken Sie auf "Start", dann auf "Alle Programme", dann auf "Microsoft Lync Server 2013" und dann auf "Lync Server-Verwaltungsshell".

  2. Mithilfe der bereitgestellten Cmdlets können Sie vorhandene Anbieter aktualisieren und neue Anbieter erstellen. Wenn Sie einen Anbieter entfernen möchten, müssen Sie bei Set-CsClsScenario beim Parameter „-Provider“ die Anweisung „Replace“ verwenden. Die einzige Möglichkeit, einen Anbieter komplett zu entfernen, besteht darin, ihn durch einen neu definierten Anbieter mit dem gleichen Namen zu ersetzen und die Anweisung „Update“ zu verwenden. Beispiel: Der Anbieter „LyssProvider“ ist mit dem Protokollierungstyp „WPP“, der Protokollierungsebene „Debug“ und den gesetzten Flags „TF_CONNECTION“ und „TF_DIAG“ definiert. Sie möchten die Flags auf „Alle“ ändern. Geben Sie dazu den folgenden Befehl ein, um den Anbieter zu ändern:

    $LyssProvider = New-CsClsProvider -Name "Lyss" -Type "WPP" -Level "Debug" -Flags "All"

     

    Set-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo" -Provider @{Replace=$LyssProvider}

  3. Wenn Sie ein Szenario mit den zugehörigen Anbietern vollständig entfernen möchten, geben Sie den folgenden Befehl ein:

    Remove-CsClsScenario -Identity <scope and name of scenario>

    Beispiel:

    Remove-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo"

    Warnung

    Das Cmdlet Remove-CsClsScenario fordert Sie nicht zur Eingabe einer Bestätigung auf. Das Szenario wird einschließlich der zugewiesenen Anbieter gelöscht. Sie können das Szenario wieder neu erstellen, indem Sie die Befehle ausführen, mit denen das Szenario ursprünglich erstellt wurde. Ein Verfahren zum Wiederherstellen entfernter Szenarien oder Anbieter gibt es nicht.

Wenn Sie ein Szenario mit dem CmdletRemove-CsClsScenario entfernen, wird es komplett aus dem Bereich entfernt. Wenn Sie die von Ihnen erstellten Szenarien mit den zugehörigen Anbietern verwenden möchten, müssen Sie neue Anbieter erstellen und diese einem neuen Szenario zuweisen.