Настройка поставщиков для централизованной службы ведения журнала в Lync Server 2013

  • Статья

 

Последнее изменение раздела: 2014-03-19

Основные понятия и конфигурация поставщиков в централизованной службе ведения журналов — одна из самых важных. Поставщики сопоставляются непосредственно с компонентами роли сервера Lync Server в модели трассировки Lync Server. Поставщик определяет компоненты Lync Server 2013, которые будут отслеживаться, тип сообщений (например, неустранимая ошибка или предупреждение) для сбора, а также флаги (например, TF_Connection или TF_Diag). Поставщики — это отслеживаемые компоненты в каждой роли сервера Lync Server. С их помощью можно определить уровень и тип трассировки компонентов (например, S4, SIPStack, IM и Presence). Определенный поставщик используется в сценарии для группировки всех поставщиков в логическую коллекцию, описывающую состояние определенной проблемы.

Чтобы запустить функции централизованной службы ведения журнала с помощью командной консоли Lync Server, необходимо быть членом групп безопасности CsAdministrator или CsServerAdministrator на основе ролей (RBAC) или настраиваемой роли RBAC, которая содержит эти две группы. Чтобы получить список всех ролей управления доступом на основе ролей (RBAC), которым был назначен этот командлет (включая все пользовательские роли RBAC, созданные вами самостоятельно), выполните следующую команду из командной консоли Lync Server или Windows PowerShell запроса:

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

Например:

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

Остальная часть данной темы посвящена определению поставщиков, изменению поставщика и компонентов поставщика, упрощающих поиск и устранение неисправностей. Существует два способа выдачи команд централизованной службы ведения журнала. По умолчанию CLSController.exe папку C:\Program Files\Common Files\Microsoft Lync Server 2013\CLSAgent можно использовать в каталоге C:\Program Files\Common Files\Microsoft Lync Server 2013\CLSAgent. Можно также использовать командную консоль Lync Server для Windows PowerShell команд. Важное отличие заключается в том, что при использовании CLSController.exe в командной строке существует ограниченный выбор сценариев, в которых поставщики уже определены и не являются изменяемыми, но вы можете определить уровень журнала. С помощью Windows PowerShell вы можете определить новых поставщиков для использования в сеансах ведения журнала и получить полный контроль над их созданием, тем, что они собирают и на каком уровне собирают данные.

Важно

Как уже упоминалось, поставщики являются очень мощным средством. Однако сценарии имеют большее значение, так как объединяют в себе все данные, необходимые для определения и выполнения трассировок компонентов, представленных поставщиками. Сценарии, которые являются коллекциями поставщиков, можно сравнить с выполнением пакетного файла, содержащего сотни команд, для сбора большого объема данных, что отличается от выполнения сотен команд по одной в командной строке.
Вместо того чтобы подробно изучить сведения о поставщиках, централизованная служба ведения журнала предоставляет ряд сценариев, которые уже определены для вас. Предоставленные сценарии покрывают большое количество различных проблем и неполадок, которые могут возникнуть. В редких случаях может понадобиться создать и определить поставщиков и назначить их в сценарии. Настоятельно рекомендуется ознакомиться с каждым предоставленным сценарием, прежде чем создавать новых поставщиков и сценарии. Хотя здесь предоставляются сведения о создании поставщиков, чтобы вы могли ознакомиться с тем, как сценарии используют элементы поставщиков для сбора данных трассировок, сведения о самих поставщиках в настоящее время не предоставлены.

Представленные в обзоре централизованной службы ведения журнала в Lync Server 2013, основные элементы определения поставщика для использования в сценарии:

  • Поставщиков Если вы знакомы с OCSLogger, поставщики — это компоненты, которые вы решили сообщить OCSLogger, из чего подсистема трассировки должна собирать журналы. Поставщики — это те же компоненты, а во многих случаях их имя совпадает с компонентами в OCSLogger. Если вы не знакомы с OCSLogger, поставщики — это компоненты роли сервера, из которых централизованная служба ведения журнала может собирать журналы. В случае централизованной службы ведения журнала CLSAgent является архитектурным компонентом централизованной службы ведения журнала, которая выполняет трассировку компонентов, определенных в конфигурации поставщиков.

  • Уровни ведения журнала OCSLogger предоставил возможность выбрать ряд уровней детализации для собранных данных. Эта функция является неотъемлемой частью централизованной службы ведения журнала и сценариев и определяется параметром Type . Можно выбрать следующие значения:

    • Все Собирает сообщения трассировки о неустранимых типах, ошибках, предупреждениях и сведениях в журнал для определенного поставщика.

    • Смертельным Собирает только сообщения трассировки, указывающие на сбой для определенного поставщика.

    • Ошибка Собирает только сообщения трассировки, указывающие на ошибку для определенного поставщика, а также неустранимые сообщения.

    • Предупреждение Собирает только сообщения трассировки, указывающие на предупреждение для определенного поставщика, а также неустранимые сообщения и сообщения об ошибках.

    • Информация Собирает только сообщения трассировки, указывающие информационное сообщение для определенного поставщика, а также неустранимые, ошибки и предупреждающие сообщения.

    • Подробного Собирает все сообщения трассировки с неустранимыми типами, ошибками, предупреждениями и сведениями для определенного поставщика.

  • Флаги OCSLogger предоставил возможность выбирать флаги для каждого поставщика, определяющие тип информации, которую можно получить из файлов трассировки. В зависимости от поставщика можно задать следующие флаги:

    • TF_Connection Предоставляет записи журнала, связанные с подключением. Эти журналы включают сведения о подключениях к определенному компоненту. Кроме того, может быть включен большой объем сведений сетевого уровня (то есть для компонентов без концепции подключения).

    • TF_Security Предоставляет все события или записи журнала, связанные с безопасностью. Например, для SipStack, это события безопасности, такие как ошибки проверки домена и ошибки проверки подлинности и авторизации клиентов.

    • TF_Diag Предоставляет события диагностики, которые можно использовать для диагностики или устранения неполадок компонента. Например, для SipStack это ошибки сертификатов или ошибки/предупреждения, связанные с DNS.

    • TF_Protocol Предоставляет протокольные сообщения, такие как SIP и объединенный кодек-пакет сообщества.

    • TF_Component Включает ведение журнала для компонентов, указанных в составе поставщиков.

    • Все Задает все доступные флаги, доступные для поставщика.

Просмотр сведений о существующих поставщиках сценариев централизованной службы ведения журнала

  1. Запустите консоль управления Lync Server: нажмите кнопку "Пуск ", выберите пункт "Все программы ",щелкните Microsoft Lync Server 2013, а затем щелкните Lync Server Management Shell.

  2. Чтобы просмотреть конфигурацию существующих поставщиков, введите следующую команду:

    Get-CsClsScenario -Identity <scope and scenario name>

    Например, чтобы просмотреть сведения о глобальном помощнике конференц-связи, введите следующее:

    Get-CsClsScenario -Identity "global/CAA"

    Команда отображает список поставщиков со связанными флагами, параметрами и компонентами. Если отображаемых сведений недостаточно или список слишком длинный для формата Windows PowerShell списка по умолчанию, можно отобразить дополнительные сведения, определив другой метод вывода. Для этого выполните следующую команду:

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

    В выходе этой команды отображается каждый поставщик. Каждая запись состоит из пяти строк: имя поставщика, тип ведения журнала, уровень ведения журнала, флаги, GUID и роль.

Определение нового поставщика сценариев централизованной службы ведения журнала

  1. Запустите консоль управления Lync Server: нажмите кнопку "Пуск ", выберите пункт "Все программы ",щелкните Microsoft Lync Server 2013, а затем щелкните Lync Server Management Shell.

  2. Поставщик сценария состоит из отслеживаемого компонента, используемых флагов и уровня детализации собираемых данных. Это определяется следующей командой:

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

    Например, определение поставщика трассировки, которое указывает, что нужно собирать с поставщика Lyss и при каком уровне детализации, выглядит следующим образом.

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

Параметр –Level указывает сбор сообщений типа неустранимая ошибка, ошибка, предупреждение и информация. Используются флаги, которые определены для поставщика Lyss, а также TF_Connection, TF_Diag и TF_Protocol.

После определения переменной $LyssProvider можно использовать ее в командлете New-CsClsScenario для сбора трассировок с поставщика Lyss. Чтобы завершить создание и назначение поставщика новому сценарию, введите следующую команду:

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

где $LyssProvider — это переменная, содержащая определенный сценарий, созданный с помощью командлета New-CsClsProvider.

Изменение существующего поставщика сценариев централизованной службы ведения журнала

  1. Запустите консоль управления Lync Server: нажмите кнопку "Пуск ", выберите пункт "Все программы ",щелкните Microsoft Lync Server 2013, а затем щелкните Lync Server Management Shell.

  2. Чтобы обновить или изменить конфигурацию существующего поставщика, введите следующую команду:

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

    Затем обновите сценарий, чтобы назначить поставщика. Введите следующее:

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

Конечный результат выполнения команды — обновление флагов и уровня поставщика назначенного для сайта сценария: Redmond/RedmondLyssInfo. Новый сценарий можно просмотреть с помощью командлета Get-CsClsScenario. Дополнительные сведения см. в разделе Get-CsClsScenario.

Предупреждение

New-ClsCsProvider не определяет допустимость флагов. Убедитесь, что названия флагов указаны верно (например, TF_DIAG или TF_CONNECTION). Если названия флагов указаны неверно, поставщик не вернет ожидаемые сведения журналов.

Если необходимо добавить в этот сценарий дополнительных поставщиков, введите следующую команду:

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

где каждый поставщик, определенный с помощью директивы Add, уже был определен с помощью процесса New-CsClsProvider.

Удаление поставщика сценария

  1. Запустите консоль управления Lync Server: нажмите кнопку "Пуск ", выберите пункт "Все программы ",щелкните Microsoft Lync Server 2013, а затем щелкните Lync Server Management Shell.

  2. Приведенные командлеты позволяют обновить существующих поставщиков и создать новых. Чтобы удалить поставщика, необходимо использовать директиву Replace для параметра Provider в командлете Set-CsClsScenario. Единственным способом полностью удалить поставщика является замена его на переопределенного поставщика того же типа с тем же именем, что выполняется с помощью директивы Update. Например, наш поставщик LyssProvider определен с типом журнала WPP, уровнем "Отладка" и флагами TF_CONNECTION и TF_DIAG. Необходимо изменить флаги на All. Чтобы изменить поставщика, выполните следующую команду:

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

     

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

  3. Если необходимо полностью удалить сценарий и связанных с ним поставщиков, выполните следующую команду:

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

    Например:

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

    Предупреждение

    Командлет Remove-CsClsScenario не запрашивает подтверждения. Сценарий удаляется вместе со всеми назначенными ему поставщиками. Можно повторно создать сценарий, повторно выполнив команды, которые использовались для его исходного создания. Процедуры восстановления удаленных сценариев или поставщиков не существует.

При удалении сценария с помощью командлета Remove-CsClsScenario вы полностью удаляете сценарий из области применения. Чтобы использовать созданные сценарии и поставщиков, которые являются частью сценария, необходимо создать новых поставщиков и назначить их новому сценарию.