Запуск или остановка записи журналов CLS в Skype для бизнеса Server 2015Start or stop CLS log capture in Skype for Business Server 2015

Сводка: Узнайте, как запуск или остановка сеанса записи журналов службы централизованного ведения журналов в Скайп для Business Server 2015.Summary: Learn how to start or stop a Centralized Logging Service log capture session in Skype for Business Server 2015.

Для записи журналов трассировки с помощью службы централизованного ведения журналов, выполните команду Начать ведения журнала на один или несколько компьютеров и пулов.To capture trace logs using the Centralized Logging Service, you issue a command to begin logging on one or more computers and pools. Также выдавать параметров, определяющих, какие компьютеры или пулов, какие сценарии для запуска (например, AlwaysOn, другой сценарий предварительно заданных или сценарий создания), какие Скайп для компонентов Business Server (например, S4, SipStack) для трассировки.You also issue parameters that define which computers or pools, what scenarios to run (for example, AlwaysOn, another predefined scenario, or a scenario you have created), what Skype for Business Server components (for example, S4, SipStack) to trace.

Для сбора необходимой информации, необходимо использовать подходящего сценария необходимо собрать сведения, относящиеся к проблеме.To capture the right information, you need to make sure you use the right scenario to collect information that is relevant to the problem. В Centralized Logging Service сценарий — концепцию Включение ведения журнала зависимости от набора компонентов сервера, уровни ведения журнала и флаги, которая является намного более эффективным и удобным, чем того, чтобы определить эти элементы на одном сервере.In the Centralized Logging Service, a scenario is the concept of turning logging on based on a collection of server components, logging levels, and flags, which is much more efficient and useful than having to define these elements on a per-server basis. Определите и укажите сценарий для запуска и постоянно выполняться сценарий на всех серверах и пулов в области инфраструктуры.You define and specify a scenario to run and the scenario is run consistently across all servers and pools in the scope of the infrastructure.

Сценарий по умолчанию называется AlwaysOn. Сценарий AlwaysOn, в соответствии со своим названием, предназначен для постоянного выполнения. Сценарий AlwaysOn собирает данные на уровне Info (обратите внимание, что помимо информационных сообщений при ведении журнала на уровне Info также регистрируются сообщения Fatal (неустранимо), Error (ошибка) и Warning (предупреждение)) для многих из наиболее типичных серверных компонентов. AlwaysOn собирает сведения до, во время и после возникновения проблемы. Это резко отличается от поведения предыдущих средств ведения журнала, таких как OCSLogger. OCSLogger запускается уже после появления проблемы, что затрудняет поиск и устранение неисправностей, так как данные собираются как реакция на событие, а не упреждающе. Если AlwaysOn не содержит данных, нужных для определения проблемного компонента, и не указывает направление действий для исправления проблемы (что, скорее всего, связано с недостаточной шириной и глубиной поставщиков в AlwaysOn), будет указан разумный уровень данных для определения дальнейших действий, таких как создание нового сценария, сбор других данных, выполнение другого поиска для сбора более подробных сведений и т. д.The default scenario is called AlwaysOn. The intended purpose for AlwaysOn is to run the scenario constantly, as the name of the scenario implies. The AlwaysOn scenario collects Info level information (note that Info logging level includes Fatal, Error, and Warning in addition to Info messages) for many of the most common server components. AlwaysOn collects information before, during, and after a problem occurs. This differs dramatically from the typical behavior of previous logging tools such as OCSLogger. You ran OCSLogger after the problem had already occurred, making your troubleshooting efforts more difficult because the data that you have is reactive, not proactive. If AlwaysOn does not contain the information that you are looking for in order to point to the problem component and indicate a course of action to fix it (which is not likely given the breadth and depth of providers in AlwaysOn), it will indicate a reasonable level of information to determine what else you need to do, such as creating a new scenario, gather other information, run a different search to collect more focused details, and so on.

Службы централизованного ведения журналов предоставляет два способа для передачи команд.The Centralized Logging Service provides two ways to issue commands. Число разделов были предназначенным непосредственно с помощью Windows PowerShell через Скайп для консоли Business Server.A number of topics have been focused squarely on using Windows PowerShell through the Skype for Business Server Management Shell. Возможность использования количество сложных конфигураций и команд Windows PowerShell подходит для использования службой централизованного ведения журналов.The ability to use a number of complex configurations and commands favors Windows PowerShell for Centralized Logging Service use. Поскольку Windows PowerShell через Скайп для консоли Business Server практически повсеместно применяемых для всех функций в Скайп для Business Server, рассматриваются только команд Windows PowerShell.Because Windows PowerShell through the Skype for Business Server Management Shell is nearly ubiquitous for all functions in Skype for Business Server, only the Windows PowerShell commands are discussed.

Запуск Start-CsClsLogging с помощью Windows PowerShell с помощью базовых командTo run Start-CsClsLogging with Windows PowerShell using basic commands

  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. Запустите сценарий ведения журнала со службой централизованного ведения журналов, введя следующую команду:Start a logging scenario with the Centralized Logging Service by typing the following:

    Start-CsClsLogging -Scenario <name of scenario>
    

    Например для запуска сценария AlwaysOn введите:For example, to start the AlwaysOn scenario, type:

    Start-CsClsLogging -Scenario AlwaysOn
    

    Примечание

    У сценария AlwaysOn нет длительности по умолчанию.The AlwaysOn scenario has no default duration. Этот сценарий будет работать, пока не будет явным образом остановлен вручную с помощью командлета Stop-CsClsLogging .This scenario will run until you explicitly stop it with the Stop-CsClsLogging cmdlet. Дополнительные сведения см Stop-CsClsLogging.For details, see Stop-CsClsLogging. Для всех остальных сценариев длительность по умолчанию составляет 4 часа.For all other scenarios, the default duration is 4 hours.

  3. Для выполнения команды нажмите клавишу ВВОД.Press Enter to run the command.

    Примечание

    Для выполнения команд и возвращения состояния от компьютеров среды может потребоваться некоторое небольшое время (от 30 до 60 секунд).It may take a short amount of time (30 to 60 seconds) for the commands to run and to receive the status back from the computers in your deployment.

    Запуск Start-CsClsLogging.

  4. Чтобы выполнить другой сценарий, используйте командлет Start-CsClsLogging с именем выполняемого дополнительного сценария для запуска следующим образом (например, сценария Authentication):To start another scenario, use the Start-CsClsLogging cmdlet with the name of the additional scenario to run as follows (for example, the scenario Authentication):

    Start-CsClsLogging -Scenario Authentication
    

    Важно!

    В любой момент времени на любом конкретном компьютере может работать не более двух сценариев. Если область применения команды является глобальной, этот сценарий или сценарии будут выполняться на всех компьютерах среды. Для запуска третьего сценария необходимо остановить ведение журнала для области применения (компьютер, пул, сайт, глобальная), в которой нужно запустить новый сценарий. Если сценарии запущены в глобальной области применения, можно остановить ведение журнала в одном или обоих сценариях для одного или нескольких компьютеров и пулов.You can have a total of two scenarios running on any given computer at any time. If the command is global in scope, all of the computers in your deployment will run the scenario or scenarios. To start a third scenario, you must stop logging on the computer, pool, site, or global scope that you want to run the new scenario on. If you have started a global scope, you can stop logging for one or both of the scenarios on one or more computers and pools.

Запуск Start-CsClsLogging с помощью Windows PowerShell с помощью расширенных командTo run Start-CsClsLogging with Windows PowerShell using advanced commands

  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. Для управления командами ведения журнала доступны дополнительные параметры.Additional parameters are available to manage the logging commands. Вы можете использовать - длительность, чтобы настроить интервал времени для запуска сценария.You can use -Duration to adjust the length of time for the scenario to run. Также можно определить - компьютеров, список имен доменов полное компьютера (FQDN), разделенные точкой с запятой, или - список полных доменных имен для пулов, которые необходимо выполнить вход в систему, разделенных пулов, их запятыми.You also can define -Computers, a list of computer fully qualified domain names (FQDNs) separated by a comma, or -Pools, a comma separated list of FQDNs for pools that you want to run logging on.

    Начало сеанса ведения журнала для сценарий UserReplicator в пуле «pool01.contoso.net».You start a logging session for the UserReplicator scenario on the pool "pool01.contoso.net". При этом длительность сеанса ведения журнала определяется равной 8 часам.You also define the duration of the logging session at 8 hours. Для этого введите следующую команду:To do this, type:

    Start-CsClsLogging -Scenario UserReplicator -Duration 8:00 -Pools "pool01.contoso.net"
    

    При успешном выполнении этого сценария возвращается результат, подобный следующему:The successful execution of this scenario returns a result like the following:

    Запуск Start-CsClsLogging.

Обратите внимание, что в этом примере выполняются сценарий AlwaysOn и сценарий UserReplicator.Note that in this example, the AlwaysOn scenario is running and the UserReplicator scenario is running.

Остановка записи службы централизованного ведения журналаStop the Centralized Logging Service log capture

Остановить текущий работающий сеанс ведения журнала можно с помощью командлета Stop-CsClsLogging.You can stop a currently running logging session with the Stop-CsClsLogging cmdlet. Как правило не существует множество ситуаций, в которых может потребоваться остановить сеанс ведения журнала.Generally, there aren't many situations in which you would need to stop a logging session. Например, поиск в журналах и изменение конфигураций можно выполнять без обязательной предварительной остановки ведения журнала.For example, you can search logs and change configurations without first needing to stop logging. Если выполняются два сценария, например AlwaysOn и UserReplicator, и нужно собирать сведения, связанные с проверкой подлинности (сценарий Authentication), понадобится остановить один из других сценариев (на глобальном уровне, уровне сайта, пула или компьютера), прежде чем можно будет запустить сценарий Authentication.If you have two scenarios running, for example AlwaysOn and UserReplicator, and you need to collect information related to Authentication, you will need to stop one of the other scenarios (at a global, site, pool or computer scope) before you can start running to Authentication scenario. Дополнительные сведения см Stop-CsClsLogging.For details, see Stop-CsClsLogging.

Примечание

При определении, какие сценарии, можно запустить на указанной развертывания, пул или компьютера, необходимо помнить, что доступно не более работает два сценария на каждом компьютере: AlwaysOn и один из пользовательских сценариев.When determining what scenarios you can run on a given deployment, pool or computer, you need to remember that you are limited to running two scenarios per computer: AlwaysOn and one custom scenario. При входе активности в пуле, должны использовать пул как единый элемент.If you are logging activity on a pool, you should treat a pool as a single entity. В большинстве случаев бы смысла запуск различных сценариев на каждом компьютере в пуле.In most cases, it would not make sense to run different scenarios on each computer in a pool. Смысл рассмотрим этот вопрос, который выполняется сбор данных о и подумайте, какой сценарий наиболее логично на определенном компьютере в развертывании.It does make sense to look at the problem that you are collecting data about and think about what scenario makes the most sense on a given computer in the overall deployment. Например если рассмотрим сценарий UserReplicator, то должно быть очень маленьким значение в под управлением UserReplicator на пограничный сервер или пограничный пул.For example, if you consider the UserReplicator scenario, there would be very little value in running UserReplicator on an Edge Server or Edge pool.

Разобравшись в проблеме и оценив масштаб влияния, следует аккуратно выбрать, какие сценарии будут выполняться и на каких компьютерах и пулах. Хотя сценарий AlwaysOn имеет смысл для широкой области применения, так как он собирает данные для широкого множества поставщиков, определенные сценарии целесообразно применять только на конкретных компьютерах и пулах. Кроме того, следует соблюдать осторожность и не запускать сеанс ведения журнала случайным образом, не разобравшись сначала в эффективности данного сценария в конкретном случае. Использование неправильного сценария или сценария, не соответствующего задаче, либо запуск сценария в неправильной области применения (будь это глобальный уровень, уровень площадки, пула или компьютера), может привести к получению сомнительных и не слишком полезных данных — как если бы никакой сценарий вообще не запускался.After you understand the problem and the scope of the impact, you should make careful choices about what scenarios to run on which computers and pools. While the AlwaysOn scenario makes sense for a wide scope application because it collects information on a wide variety of providers, specific scenarios only have application value on specific computers or pools. Also, you should take caution when randomly starting up a logging session without first understanding the value of a given scenario. If you use the wrong scenario, or if you use a scenario that is appropriate for the task and you apply the scenario at the wrong scope (be it global, site, pool, or computer), you can get questionable data that is not very useful—as if you didn't run the scenario at all.

Для управления функциями централизованной службы ведения журналов с помощью Скайп для консоли Business Server, должна быть членом CsAdministrator или групп безопасности CsServerAdministrator доступом на основе ролей (RBAC) элемента управления или настраиваемые роли RBAC который содержит любой из этих двух групп.To control the Centralized Logging Service functions by 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 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"}

Остановка текущего выполняемого сеанса централизованной службы ведения журналовTo stop a currently running Centralized Logging Service session

  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. Запрос централизованной службы ведения журналов, чтобы узнать, какие сценарии в настоящее время работает, введя следующее:Query the Centralized Logging Service to find out what scenarios are currently running by typing the following:

    Show-CsClsLogging
    

    Консоль Windows PowerShell после вызова Show-CsCl

    Результатом выполнения Show-CsClsLogging являются сводные данные обо всех выполняемых сценариях и областях их выполнения.The result of Show-CsClsLogging is a summary of the scenarios that are running and what scope they are running in. Дополнительные сведения см Show-CsClsLogging.For details, see Show-CsClsLogging.

  3. Чтобы остановить выполняемый в данный момент сеанс ведения журнала, введите:To stop a currently running logging session with a specific scenario, type:

    Stop-CsClsLogging -Scenario <scenario name> -Computers <comma separated list of fully qualified computer names> -Pools <comma separated list of fully qualified pool names>
    

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

    Stop-CsClsLogging -Scenario UserReplicator -Pools pool01.contoso.net
    

    Эта команда остановит ведение журнала с помощью сценария UserReplicatior для pool01.contoso.net.This command will stop logging with the UserReplicatior scenario on pool01.contoso.net.

    Примечание

    Журналы, созданные в течение останавливаемого сеанса ведения журнала с помощью сценария UserReplicator, не удаляются.Logs created during this logging session using the UserReplicator scenario are not deleted. Журналы остаются доступными для выполнения поиска с помощью команды Search-CsClsLogging.The logging is still available for you to execute searches against using the Search-CsClsLogging command. Дополнительные сведения см Search-CsClsLogging.For details, see Search-CsClsLogging.

Действуя в качестве команды-спутника для Start-CsClsLogging, командлет Stop-CsClsLogging завершает сеанс ведения журнала и сохраняет журналы, созданные в течение этого сеанса. Одновременно на данном компьютере может выполняться не более двух сценариев. Способ остановки одного сценария для сбора данных с помощью другого сценария является типовой задачей, часто выполняемой при устранении неполадок рабочих нагрузок.Acting as the companion command to Start-CsClsLogging, the Stop-CsClsLogging cmdlet ends the logging session, defined by scenarios, and retains the logs created by the logging session. You can run two scenarios on a given computer at any time. The method of stopping one scenario to gather information using another scenario is a common task that you can perform during most workload troubleshooting.

Были ли эти инструкции полезны? Если да, укажите это в конце статьи. Если нет, сообщите нам о недочетах, и мы постараемся найти решение.See also

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