Настройка поставщиков для централизованной службы ведения журналов в Skype для бизнеса Server 2015
Сводка: Узнайте, как настроить поставщиков сценариев для централизованной службы ведения журнала в Skype для бизнеса Server 2015 г.
Основные понятия и конфигурация поставщиков в централизованной службе ведения журнала являются одними из наиболее важных для понимания. Поставщики сопоставляют непосредственно с компонентами роли сервера Skype для бизнеса Server в модели трассировки Skype для бизнеса Server. Поставщик определяет компоненты отслеживаемого Skype для бизнеса Server 2015, тип сообщений (например, неустранимая ошибка или предупреждение) для сбора, а также флаги (например, TF_Connection или TF_Diag). Поставщики — это отслеживаемые компоненты в каждой Skype для бизнеса Server роли сервера. С их помощью можно определить уровень и тип трассировки компонентов (например, S4, SIPStack, IM и Presence). Определенный поставщик используется в сценарии для группировки всех поставщиков в логическую коллекцию, описывающую состояние определенной проблемы.
Чтобы запустить функции централизованной службы ведения журнала с помощью командной консоли Skype для бизнеса Server, необходимо быть членом групп безопасности CsAdministrator или CsServerAdministrator на основе ролей управления доступом (RBAC) или настраиваемой роли RBAC, содержащей обе эти две группы. Чтобы вернуть список всех ролей управления доступом на основе ролей (RBAC), которым назначен этот командлет (включая все пользовательские роли RBAC, которые вы создаете самостоятельно), выполните следующую команду из командной консоли Skype для бизнеса Server или Windows PowerShell командной строки:
Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Skype for Business Server 2015 cmdlet"}
Например:
Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Set-CsClsConfiguration"}
Оставшаяся часть этой статьи посвящена определению поставщиков, изменению поставщика и определению поставщика для оптимизации устранения неполадок. Существует два способа выполнения команд централизованной службы ведения журнала. Вы можете использовать файл CLSController.exe, который по умолчанию расположен в каталоге C:\Program Files\Common Files\Skype for Business Server 2015\CLSAgent. Кроме того, можно использовать командную консоль Skype для бизнеса Server для выполнения Windows PowerShell команд. Используя Windows PowerShell, вы можете определить новых поставщиков для использования в сеансах ведения журнала и полностью контролировать их создание, то, что они собирают, и на каком уровне они собирают данные.
Важно!
Как уже упоминалось, поставщики являются очень мощным средством. Однако сценарии имеют большее значение, так как объединяют в себе все данные, необходимые для определения и выполнения трассировок компонентов, представленных поставщиками. Сценарии, которые являются коллекциями поставщиков, можно сравнить с выполнением пакетного файла, содержащего сотни команд, для сбора большого объема данных, что отличается от выполнения сотен команд по одной в командной строке.
Централизованная служба ведения журнала предоставляет множество сценариев, которые уже определены. В указанных сценариях рассматривается большинство возможных проблем, с которыми вы столкнулись. В редких случаях может потребоваться создать и определить поставщиков и назначить их сценариям. Настоятельно рекомендуется ознакомиться с каждым предоставленным сценарием, прежде чем создавать новых поставщиков и сценарии. Хотя сведения о создании поставщиков приведены здесь, чтобы ознакомиться с тем, как в сценариях используются элементы поставщика для сбора данных трассировки, сведения о самих поставщиках в настоящее время не предоставляются.
Представленные в централизованной службе ведения журнала в Skype для бизнеса 2015 г., ключевые элементы определения поставщика для использования в сценарии:
Поставщиков Если вы знакомы с OCSLogger, поставщики — это компоненты, которые вы решили сообщить OCSLogger, из чего подсистема трассировки должна собирать журналы. Поставщики — это те же компоненты, а во многих случаях их имя совпадает с компонентами в OCSLogger. Если вы не знакомы с OCSLogger, поставщики — это компоненты, относящиеся к роли сервера, из которых централизованная служба ведения журнала может собирать журналы. В случае с централизованной службой ведения журнала CLSAgent является архитектурной частью централизованной службы ведения журнала, которая выполняет трассировку компонентов, определяемых в конфигурации поставщиков.
Уровни ведения журнала OCSLogger предоставляет возможность выбора нескольких уровней детализации для собранных данных. Эта функция является неотъемлемой частью централизованной службы ведения журнала и сценариев и определяется параметром Type . Можно выбрать следующие значения:
Все Собирает сообщения трассировки типа неустранимые, ошибки, предупреждения, подробные сведения и сведения об отладке в журнал для определенного поставщика.
Смертельным Собирает только сообщения трассировки, определенные как "Неустранимая".
Ошибка Собирает только сообщения трассировки, определенные как "Error" или "Fatal".
Предупреждение Собирает только сообщения трассировки типа "Warning", "Error" и "Fatal".
Информация Собирает только сообщения трассировки, указывающие на информационное сообщение для определенного поставщика, а также неустранимые сообщения, сообщения об ошибках и предупреждениях.
Подробного Собирает все сообщения трассировки типа fatal, error, warning и verbose для определенного поставщика.
Отладка , по сути, эквивалентна "All" — собирает трассировки типа Fatal, Error, Warning, Info, Verbose и Debug для определенного поставщика.
Флаги OCSLogger предоставляет возможность выбора флагов для каждого поставщика, который определяет тип сведений, которые можно получить из файлов трассировки. В зависимости от поставщика можно выбрать следующие флаги:
TF_Connection Предоставляет записи журнала, связанные с подключением. Эти журналы включают сведения о подключениях к определенному компоненту. Кроме того, может быть включен большой объем сведений сетевого уровня (то есть для компонентов без концепции подключения).
TF_Security Предоставляет все события и записи журнала, связанные с безопасностью. Например, для SipStack, это события безопасности, такие как ошибки проверки домена и ошибки проверки подлинности и авторизации клиентов.
TF_Diag Предоставляет диагностика события, которые можно использовать для диагностики или устранения неполадок компонента. Например, для SipStack это ошибки сертификатов или ошибки/предупреждения, связанные с DNS.
TF_Protocol Предоставляет сообщения протокола, такие как sip и объединенные сообщения codec pack.
TF_Component Включает ведение журнала для компонентов, указанных в составе поставщиков.
Все Задает все доступные флаги, доступные для поставщика.
Просмотр сведений о существующих поставщиках сценариев централизованной службы ведения журнала
Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.
Чтобы просмотреть конфигурацию существующих поставщиков, введите следующую команду:
Get-CsClsScenario -Identity <scope and scenario name>Например, чтобы просмотреть сведения о глобальном помощнике конференц-связи, введите следующее:
Get-CsClsScenario -Identity "global/CAA"Команда отображает список поставщиков со связанными флагами, параметрами и компонентами. Если отображаемых сведений недостаточно или список слишком длинный для формата списка по умолчанию Windows PowerShell, можно отобразить дополнительные сведения, определив другой метод вывода. Для этого выполните следующую команду:
Get-CsClsScenario -Identity "global/CAA" | Select-Object -ExpandProperty ProviderВ выходе этой команды отображается каждый поставщик. Каждая запись состоит из пяти строк: имя поставщика, тип ведения журнала, уровень ведения журнала, флаги, GUID и роль.
Определение нового поставщика сценариев централизованной службы ведения журнала
Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.
Поставщик сценария состоит из отслеживаемого компонента, используемых флагов и уровня детализации собираемых данных. Это определяется следующей командой:
$<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.
Изменение существующего поставщика сценариев централизованной службы ведения журнала
Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.
Чтобы обновить или изменить конфигурацию существующего поставщика, введите следующую команду:
$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.
Удаление поставщика сценария
Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.
Приведенные командлеты позволяют обновить существующих поставщиков и создать новых. Чтобы удалить поставщика, необходимо использовать директиву Replace для параметра Provider в командлете Set-CsClsScenario. Единственным способом полностью удалить поставщика является замена его на переопределенного поставщика того же типа с тем же именем, что выполняется с помощью директивы Update. Например, наш поставщик LyssProvider определен с типом журнала WPP, уровнем "Отладка" и флагами TF_CONNECTION и TF_DIAG. Необходимо изменить флаги на "Все". Чтобы изменить поставщика, выполните следующую команду:
$LyssProvider = New-CsClsProvider -Name "Lyss" -Type "WPP" -Level "Debug" -Flags "All"Set-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo" -Provider @{Replace=$LyssProvider}Если необходимо полностью удалить сценарий и связанных с ним поставщиков, выполните следующую команду:
Remove-CsClsScenario -Identity <scope and name of scenario>Например:
Remove-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo"Осторожностью
Командлет Remove-CsClsScenario не запрашивает подтверждения. Сценарий удаляется вместе со всеми назначенными ему поставщиками. Можно повторно создать сценарий, повторно выполнив команды, которые использовались для его исходного создания. Процедуры восстановления удаленных сценариев или поставщиков не существует.
При удалении сценария с помощью командлета Remove-CsClsScenario вы полностью удаляете сценарий из области применения. Чтобы использовать созданные сценарии и поставщиков, которые являются частью сценария, необходимо создать новых поставщиков и назначить их новому сценарию.