Настройка поставщиков для централизованной службы ведения журналов в Skype для бизнеса Server 2015Configure providers for Centralized Logging Service in Skype for Business Server 2015

Сводка: Сведения о настройке поставщиков сценариев для централизованной службы ведения журналов в Скайп для Business Server 2015.Summary: Learn how to configure scenario providers for the Centralized Logging Service in Skype for Business Server 2015.

Основные понятия и конфигурации поставщиков в централизованной службы ведения журналов является одним из наиболее важных для осознавать.The concepts and configuration of providers in Centralized Logging Service is one of the most important to grasp. Карта Theproviders непосредственно к Скайп Business Server компонентов роли сервера в Скайп для модели трассировки Business Server.Theproviders map directly to Skype for Business Server server role components in the Skype for Business Server tracing model. Компоненты Скайп поставщиком для Business Server 2015, который будет отслеживаться тип сообщения (например, сообщения о неустранимых об ошибке или предупреждение) для сбора и флаги (например, TF_Connection или TF_Diag).The provider defines the components of a Skype for Business Server 2015 that will be traced, the type of messages (for example, fatal, error, or warning) to collect, and the flags (for example, TF_Connection or TF_Diag). Поставщики, выполняемых компоненты в каждом Скайп для роли сервера Business Server.Providers are the traceable components in each Skype for Business Server server role. С их помощью можно определить уровень и тип трассировки компонентов (например, S4, SIPStack, IM и Presence).By using providers, you define the level and type of tracing on components (for example, S4, SIPStack, IM and Presence). Определенный поставщик используется в сценарии для группировки всех поставщиков в логическую коллекцию, описывающую состояние определенной проблемы.The defined provider is used in a scenario to group all of the providers for a given logical collection that address a specific problem condition.

Для запуска функции централизованной службы ведения журналов с помощью Скайп for Business Server Командная консоль, должна быть членом CsAdministrator или групп безопасности CsServerAdministrator доступом на основе ролей (RBAC) элемента управления или настраиваемые роли RBAC, содержит любой из этих двух групп.To run the Centralized Logging Service functions using the Skype for Business Server Management Shell, you must be a member of either the CsAdministrator or the CsServerAdministrator role-based access control (RBAC) security groups, or a custom RBAC role that contains either of these two groups. Чтобы получить список всех роли доступом на основе ролей (RBAC) элемента управления, которые этот командлет был назначен (включая любые пользовательские роли RBAC, созданные самостоятельно), выполните следующую команду из Скайп для консоли Business Server и Windows PowerShell в командной строке:To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Skype for Business Server Management Shell or the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Skype for Business Server 2015 cmdlet"}

Например:For example:

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

Остальная часть данной темы посвящена определению поставщиков, изменению поставщика и компонентов поставщика, упрощающих поиск и устранение неисправностей.The remainder of this topic focuses on how to define providers, modify a provider and what a provider definition contains to optimize your troubleshooting. Существует два способа для выполнения команд, централизованной службы ведения журналов.There are two ways to issue Centralized Logging Service commands. Вы можете использовать файл CLSController.exe, который по умолчанию расположен в каталоге C:\Program Files\Common Files\Skype for Business Server 2015\CLSAgent.You can use the CLSController.exe that is located, by default, in the directory C:\Program Files\Common Files\Skype for Business Server 2015\CLSAgent. Или можно использовать Скайп для консоли Business Server на выполнение команд Windows PowerShell.Or, you can use the Skype for Business Server Management Shell to issue Windows PowerShell commands. С помощью Windows PowerShell, можно определить новые службы для использования в вашей сеансы ведения журналов и имеют полный контроль над их создания, что они сбор и на каком уровне их сбора данных.By using Windows PowerShell, you can define new providers for use in your logging sessions, and have complete control over their creation, what they collect, and at what level they collect data.

Важно!

Как уже упоминалось, поставщики являются очень мощным средством. Однако сценарии имеют большее значение, так как объединяют в себе все данные, необходимые для определения и выполнения трассировок компонентов, представленных поставщиками. Сценарии, которые являются коллекциями поставщиков, можно сравнить с выполнением пакетного файла, содержащего сотни команд, для сбора большого объема данных, что отличается от выполнения сотен команд по одной в командной строке.As mentioned, providers are very powerful. However, scenarios are more powerful because they contain the embodiment of all information needed to set and execute tracing on the components that the providers represent. With scenarios being a collection of providers, this could be loosely compared to running a batch file containing hundreds of commands to collect a lot of information versus issuing hundreds of commands, one at a time, at the command line.

Устраняет необходимость подробнее глубоко поставщиков, службы централизованного ведения журналов предоставляет ряд сценариев, которые уже определен.Instead of requiring you to dig deeply into the details of providers, the Centralized Logging Service provides a number of scenarios that are already defined for you. Предоставленные сценарии покрывают большое количество различных проблем и неполадок, которые могут возникнуть.The provided scenarios cover the vast majority of possible issues that you will encounter. В редких случаях может понадобиться создать и определить поставщиков и назначить их в сценарии.In rare cases, you may need to create and define providers and assign them to scenarios. Настоятельно рекомендуется ознакомиться с каждым предоставленным сценарием, прежде чем создавать новых поставщиков и сценарии.We strongly recommend that you become familiar with each of the scenarios provided before you investigate the need to create new providers and scenarios. Хотя здесь предоставляются сведения о создании поставщиков, чтобы вы могли ознакомиться с тем, как сценарии используют элементы поставщиков для сбора данных трассировок, сведения о самих поставщиках в настоящее время не предоставлены.While information about creating providers is found here to familiarize you with how the scenarios use the provider elements to collect trace information, details on the providers themselves are not provided at this time.

Представлено в Централизованной службы ведения журналов в Скайп для бизнеса 2015, ключевые элементы определения поставщика для использования в сценарии являются:Introduced in Centralized Logging Service in Skype for Business 2015, the key elements of defining a provider for use in a scenario are:

  • Поставщики Если вы знакомы с OCSLogger, поставщики — это компоненты, чтобы сообщить OCSLogger обработчик трассировки следует собирать данные для выбора.Providers If you are familiar with OCSLogger, providers are the components that you choose to tell OCSLogger what the tracing engine should collect logs from. Поставщики — это те же компоненты, а во многих случаях их имя совпадает с компонентами в OCSLogger.The providers are the same components, and in many cases have the same name as the components in OCSLogger. Если вы не знакомы с OCSLogger, поставщики, роль сервера отдельные компоненты, которые можно собрать службы централизованного ведения журналов входит в систему.If you are not familiar with OCSLogger, providers are server-role specific components that the Centralized Logging Service can collect logs from. В случае Centralized Logging Service CLSAgent входит в архитектуре of the Centralized Logging Service, который делает трассировки компонентов, определенных в конфигурации поставщиков.In the case of the Centralized Logging Service, the CLSAgent is the architectural part of the Centralized Logging Service that is doing the tracing of the components that you define in the providers configuration.

  • Уровни ведения журнала OCSLogger обеспечивает возможность выбора нескольких уровнях детализации для данных, собранных.Logging levels OCSLogger provided the option to choose a number of levels of detail for the data collected. Эта функция является частью централизованной службы ведения журналов и сценарии и определяется с помощью параметра типа Type .This feature is an integral part of the Centralized Logging Service and scenarios, and is defined by the Type parameter. Можно выбрать следующие значения:You can choose from the following:

    • Все Собирает трассировку сообщений неустранимые, ошибка, предупреждение, verbose и отладочной информации в журнал на определенном поставщике.All Collects trace messages of type fatal, error, warning, verbose, and debug info to the log for the defined provider.

    • Сообщения о неустранимых Собирает только сообщения трассировки, определенные как «Неустранимая ошибка».Fatal Collects only the trace messages defined as "Fatal."

    • Ошибка Собирает только сообщения трассировки, определенные как «Ошибка» или «Ошибка».Error Collects only the trace messages defined as "Error" or "Fatal."

    • Предупреждение Собирает только сообщения трассировки типа «Предупреждение», «Ошибка» и «Сообщения о неустранимых.»Warning Collects only the trace messages of type "Warning," "Error" and "Fatal."

    • Сведения о Собирает только сообщения трассировки, оповещающие об информационном сообщении на определенном поставщике, а также сообщения о неустранимых, ошибки и предупреждения.Info Collects only the trace messages that indicate an informational message for the defined provider, plus fatal, error, and warning messages.

    • Verbose Собирает сообщения трассировки всех типов критическая ошибка, ошибки, предупреждения и verbose на определенном поставщике.Verbose Collects all trace messages of type fatal, error, warning and verbose for the defined provider.

    • Отладка это по сути эквивалент из «Все» — собирает трассировку типа Неустранимая ошибка, ошибка, предупреждение, информация, подробный и отладка на определенном поставщике.Debug this is essentially an equivalent of 'All' - collects traces of type Fatal, Error, Warning, Info, Verbose and Debug for the defined provider.

  • Флаги OCSLogger обеспечивает возможность выбора флаги для каждого поставщика, что определенный тип данных, можно извлечь из файлов трассировки.Flags OCSLogger provided the option to choose flags for each provider that defined what type of information you could retrieve from the trace files. В зависимости от поставщика можно задать следующие флаги:You can chose the following flags, based on the provider:

    • TF_Connection Содержит записи журнала, связанные с подключением.TF_Connection Provides connection-related log entries. Эти журналы включают сведения о подключениях к определенному компоненту.These logs include information about connections established to and from a particular component. Кроме того, может быть включен большой объем сведений сетевого уровня (то есть для компонентов без концепции подключения).This may also include significant network-level information (that is, for components without the concept of a connection).

    • TF_Security Содержит все записи событий и журналов, связанных с безопасностью.TF_Security Provides all events/log entries related to security. Например, для SipStack, это события безопасности, такие как ошибки проверки домена и ошибки проверки подлинности и авторизации клиентов.For example, for SipStack, these are security events such as domain validation failure, and client authentication/authorization failures.

    • TF_Diag Предоставляет события диагностики, которые можно использовать для диагностики и устранения неполадок компонента.TF_Diag Provides diagnostics events that you can use to diagnose or troubleshoot the component. Например, для SipStack это ошибки сертификатов или ошибки/предупреждения, связанные с DNS.For example, for SipStack, these are certificate failures, or DNS warnings/errors.

    • TF_Protocol Предоставляет сообщения протокола, например сообщения SIP и в сочетании пакет кодек сообщества.TF_Protocol Provides protocol messages such as SIP and Combined Community Codec Pack messages.

    • TF_Component Ведение журнала на компонентах, определенных как часть поставщиков.TF_Component Enables logging on the components specified as part of the providers.

    • Все Задает доступные флаги для поставщика.All Sets all available flags available for the provider.

Чтобы просмотреть сведения о существующих поставщиков сценариев для централизованной службы ведения журналовTo review information about existing Centralized Logging Service scenario providers

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Чтобы просмотреть конфигурацию существующих поставщиков, введите следующую команду:To review the configuration of existing providers, type the following:

    Get-CsClsScenario -Identity <scope and scenario name>
    

    Например, чтобы просмотреть сведения о глобальном помощнике конференц-связи, введите следующее:For example, to review information about the global conferencing attendant, type:

    Get-CsClsScenario -Identity "global/CAA"
    

    Команда отображает список поставщиков со связанными флагами, параметрами и компонентами.The command displays a list of providers with the associated flags, settings, and components. Если сведения, отображаемые недостаточно или списка слишком длинный формат списка по умолчанию Windows PowerShell, вы можете отобразить дополнительные сведения, определив другой метод.If the information displayed is not enough or the list is too long for the default Windows PowerShell list format, you can display additional information by defining a different output method. Для этого выполните следующую команду:To do this, type:

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

    В выходе этой команды отображается каждый поставщик. Каждая запись состоит из пяти строк: имя поставщика, тип ведения журнала, уровень ведения журнала, флаги, GUID и роль.The output of this command displays each provider displayed in a five line format with the provider name, type of logging, logging level, flags, GUID, and role, each one on a separate line.

Чтобы определить новый поставщик сценария централизованной службы ведения журналовTo define a new Centralized Logging Service scenario provider

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Поставщик сценария состоит из отслеживаемого компонента, используемых флагов и уровня детализации собираемых данных. Это определяется следующей командой:A scenario provider consists of a component to trace, flags to use, and a level of detail to collect. You do this by typing:

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

    Например, определение поставщика трассировки, которое указывает, что нужно собирать с поставщика Lyss и при каком уровне детализации, выглядит следующим образом.For example, a trace provider definition that defines what to collect and to what level of detail from the Lyss provider looks like the following:

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

-Уровня собирает критическая ошибка, ошибки, предупреждения и сведения сообщений.The -Level collects fatal, error, warning, and information messages. Флаги, используемые все соединители, определенные для поставщика Lyss и включают в себя TF_Connection, TF_Diag и TF_Protocol.After, определенного переменной $LyssProvider, можно использовать его с помощью командлета New-CsClsScenario сбора трассировок с поставщика Lyss.The flags used are all of those defined for the Lyss provider, and include TF_Connection, TF_Diag and TF_Protocol.After the variable $LyssProvider is defined, you can use it with the New-CsClsScenario cmdlet to collect traces from the Lyss provider. Чтобы завершить создание и назначение поставщика новому сценарию, введите следующую команду:To complete the creation and assignment of the provider to a new scenario, type:

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

Где $LyssProvider — это переменная, содержащая определенный сценарий, созданный с помощью New-CsClsProvider.Where $LyssProvider is the variable containing the defined scenario created with New-CsClsProvider.

Чтобы изменить существующего поставщика сценария централизованной службы ведения журналовTo change an existing Centralized Logging Service scenario provider

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Чтобы обновить или изменить конфигурацию существующего поставщика, введите следующую команду:To update or change the configuration of an existing provider, type:

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

    Затем обновите сценарий, чтобы назначить поставщика. Введите следующее:You then update the scenario to assign the provider by typing the following:

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

Конечный результат выполнения команды — обновление флагов и уровня поставщика назначенного для сайта сценария: Redmond/RedmondLyssInfo.The end result of the command is that the scenario site:Redmond/RedmondLyssInfo will have updated flags and level for the provider assigned to it. Новый сценарий можно просмотреть с помощью командлета Get-CsClsScenario.You can view the new scenario by using Get-CsClsScenario. Дополнительные сведения см Get-CsClsScenario.For details, see Get-CsClsScenario.

Внимание!

New-ClsCsProvider не проверяет, чтобы определить допустимое флаги.New-ClsCsProvider does not check to determine whether the flags are valid. Убедитесь, что названия флагов указаны верно (например, TF_DIAG или TF_CONNECTION).Make sure that the spelling of the flags (for example, TF_DIAG or TF_CONNECTION) is spelled correctly. Если названия флагов указаны неверно, поставщик не вернет ожидаемые сведения журналов.If the flags are not spelled correctly, the provider cannot return the expected log information.

Если необходимо добавить в этот сценарий дополнительных поставщиков, введите следующую команду:If you want to add additional providers to this scenario, type the following:

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

Где каждый поставщик, определенный с помощью директивы Add уже был определен с помощью процесса New-CsClsProvider .Where each provider defined with the Add directive has already been defined using the New-CsClsProvider process.

Удаление поставщика сценарияTo remove a scenario provider

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Приведенные командлеты позволяют обновить существующих поставщиков и создать новых.The cmdlets provided allow you to update existing providers and create new providers. Чтобы удалить поставщика, необходимо использовать директиву заменить для параметра поставщика для Set-CsClsScenario.To remove a provider, you must use the Replace directive for the Provider parameter to Set-CsClsScenario. Единственным способом полностью удалить поставщика является замена его на переопределенного поставщика того же типа с тем же именем, что выполняется с помощью директивы Update.The only way to completely remove a provider is to replace it with a redefined provider of the same name and use the Update directive. Например, наш поставщик LyssProvider определен с типом журнала WPP, уровнем "Отладка" и флагами TF_CONNECTION и TF_DIAG.For example, our provider LyssProvider is defined with WPP as the log type, level set to Debug, and flags set are TF_CONNECTION and TF_DIAG. Чтобы сменить флаги для «Все».You need to change the flags to "All". Чтобы изменить поставщика, выполните следующую команду:To change the provider, type the following:

    $LyssProvider = New-CsClsProvider -Name "Lyss" -Type "WPP" -Level "Debug" -Flags "All"
    
    Set-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo" -Provider @{Replace=$LyssProvider}
    
  3. Если необходимо полностью удалить сценарий и связанных с ним поставщиков, выполните следующую команду:If you want to completely remove a scenario and the providers associated with it, type the following:

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

    Например:For example:

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

    Внимание!

    Командлет Remove-CsClsScenario не запрашивать подтверждение.The cmdlet Remove-CsClsScenario does not prompt you for confirmation. Сценарий удаляется вместе со всеми назначенными ему поставщиками.The scenario is deleted, along with the providers that were assigned to it. Можно повторно создать сценарий, повторно выполнив команды, которые использовались для его исходного создания.You can recreate the scenario by re-running the commands used to create it initially. Процедуры восстановления удаленных сценариев или поставщиков не существует.There is no procedure to recover removed scenarios or providers.

При удалении сценария с помощью командлета Remove-CsClsScenario , полностью удалить сценарий из области действия.When you remove a scenario by using the Remove-CsClsScenario cmdlet, you completely remove the scenario from the scope. Чтобы использовать созданные сценарии и поставщиков, которые являются частью сценария, необходимо создать новых поставщиков и назначить их новому сценарию.To use the scenarios that you created and the providers that were a part of the scenario, you create new providers and assign them to a new scenario.

См. такжеSee also

Get-CsClsScenarioGet-CsClsScenario

New-CsClsScenarioNew-CsClsScenario

Remove-CsClsScenarioRemove-CsClsScenario

SET-CsClsScenarioSet-CsClsScenario

New-CsClsProviderNew-CsClsProvider