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

Skype for Business Server 2015
 

Дата изменения раздела:2015-08-17

Краткое содержание. В этой статье содержатся инструкции по настройке поставщиков сценариев для централизованной службы ведения журнала в Skype для бизнеса Server 2015.

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

Чтобы выполнять функции централизованная служба ведения журнала с помощью Командная консоль Skype для бизнеса Server необходимо быть участником группы безопасности RBAC CsAdministrator или CsServerAdministrator или настраиваемой роли 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 можно определить новых поставщиков для использования в сеансах ведения журналов и установить полный контроль их создания, сбора данных и уровня сбора данных.

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

Представленные в разделе Централизованная служба ведения журнала в Skype для бизнеса 2015, ключевые элементы определения поставщика для использования в сценарии также приведены ниже.

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

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

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

    • Неустранимая ошибка    Собирает только сообщения трассировки, такие как "Неустранимая ошибка".

    • Ошибка    Собирает только сообщения трассировки, такие как "Ошибка" или "Неустранимая ошибка".

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

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

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

    • Отладка    Это эквивалент значения "Все" — собирает сообщения трассировки типа "Неустранимая ошибка", "Ошибка", "Предупреждение", "Информация" "Подробное" или "Отладка" для указанного поставщика.

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

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

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

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

    • TF_Protocol    Предоставляет сообщения протокола, такие как сообщения SIP и CCCP.

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

    • All    Определяет все доступные для поставщиков флаги.

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск , последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса .

  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. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск , последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса .

  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. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск , последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса .

  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.

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

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

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

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

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск , последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса .

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

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

 
Показ: