Запуск или остановка записи журналов CLS в Skype для бизнеса Server 2015

Статья
07/21/2023

Сводка: Узнайте, как запустить или остановить сеанс сбора журналов централизованной службы ведения журнала в Skype для бизнеса Server 2015 г.

Чтобы записать журналы трассировки с помощью централизованной службы ведения журнала, выполните команду, чтобы начать ведение журнала на одном или нескольких компьютерах и пулах. Вы также задаете параметры, определяющие, какие компьютеры или пулы, какие сценарии следует запускать (например, AlwaysOn, другой предопределенный сценарий или созданный сценарий), какие компоненты Skype для бизнеса Server (например, S4, SipStack) для трассировки.

To capture the right information, you need to make sure you use the right scenario to collect information that is relevant to the problem. В централизованной службе ведения журнала сценарий — это концепция включения ведения журнала на основе коллекции компонентов сервера, уровней ведения журнала и флагов, что гораздо эффективнее и полезнее, чем определение этих элементов на уровне сервера. 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), будет указан разумный уровень данных для определения дальнейших действий, таких как создание нового сценария, сбор других данных, выполнение другого поиска для сбора более подробных сведений и т. д.

Централизованная служба ведения журнала предоставляет два способа выполнения команд. Ряд тем был посвящен использованию Windows PowerShell с помощью командной консоли Skype для бизнеса Server. Возможность использовать ряд сложных конфигураций и команд позволяет Windows PowerShell использовать централизованную службу ведения журнала. Так как Windows PowerShell с помощью командной консоли Skype для бизнеса Server почти вездесущ для всех функций в Skype для бизнеса Server, рассматриваются только команды Windows PowerShell.

Запуск Start-CsClsLogging с Windows PowerShell с помощью базовых команд

Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.
Запустите сценарий ведения журнала с помощью централизованной службы ведения журнала, введя следующее:
```
Start-CsClsLogging -Scenario <name of scenario>
```
Например для запуска сценария AlwaysOn введите:
```
Start-CsClsLogging -Scenario AlwaysOn
```
Примечание.

У сценария AlwaysOn нет длительности по умолчанию. Этот сценарий будет выполняться, пока он не будет явно остановлен с помощью командлета Stop-CsClsLogging. Подробные сведения см. в статье Stop-CsClsLogging. Для всех остальных сценариев длительность по умолчанию составляет 4 часа.
Для выполнения команды нажмите клавишу ВВОД.

Примечание.

Для выполнения команд и возвращения состояния от компьютеров среды может потребоваться некоторое небольшое время (от 30 до 60 секунд).
Чтобы выполнить другой сценарий, используйте командлет Start-CsClsLogging с именем выполняемого дополнительного сценария (например, сценария Authentication):
```
Start-CsClsLogging -Scenario Authentication
```
Важно!

В любой момент времени на любом конкретном компьютере может работать не более двух сценариев. Если область применения команды является глобальной, этот сценарий или сценарии будут выполняться на всех компьютерах среды. Для запуска третьего сценария необходимо остановить ведение журнала для области применения (компьютер, пул, сайт, глобальная), в которой нужно запустить новый сценарий. Если сценарии запущены в глобальной области применения, можно остановить ведение журнала в одном или обоих сценариях для одного или нескольких компьютеров и пулов.

Запуск Start-CsClsLogging с Windows PowerShell с помощью дополнительных команд

Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.
Для управления командами ведения журнала доступны дополнительные параметры. С помощью параметра -Duration можно настроить время выполнения сценария. Вы также можете определить -Computers, список полных доменных имен (FQDN) компьютеров, разделенных запятой, или -Pools, разделенный запятыми список полных доменных имен для пулов, в которые требуется выполнить вход.

Пусть нужно запустить сеанс ведения журнала с помощью сценария UserReplicator для пула "pool01.contoso.net". При этом длительность сеанса ведения журнала определяется равной 8 часам. Для этого введите следующую команду:
```
Start-CsClsLogging -Scenario UserReplicator -Duration 8:00 -Pools "pool01.contoso.net"
```
При успешном выполнении этого сценария возвращается результат, подобный следующему:

Обратите внимание, что в этом примере выполняются сценарий AlwaysOn и сценарий UserReplicator.

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

Остановить текущий работающий сеанс ведения журнала можно с помощью командлета Stop-CsClsLogging. Как правило, не так много ситуаций, в которых необходимо остановить сеанс ведения журнала. Например, поиск в журналах и изменение конфигураций можно выполнять без обязательной предварительной остановки ведения журнала. Если выполняются два сценария, например AlwaysOn и UserReplicator, и нужно собирать сведения, связанные с проверкой подлинности (сценарий Authentication), понадобится остановить один из других сценариев (на глобальном уровне, уровне сайта, пула или компьютера), прежде чем можно будет запустить сценарий Authentication. Подробные сведения см. в статье Stop-CsClsLogging.

Примечание.

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 на пограничном сервере или пограничном пуле будет очень мало пользы.

Разобравшись в проблеме и оценив масштаб влияния, следует аккуратно выбрать, какие сценарии будут выполняться и на каких компьютерах и пулах. Хотя сценарий AlwaysOn имеет смысл для широкой области применения, так как он собирает данные для широкого множества поставщиков, определенные сценарии целесообразно применять только на конкретных компьютерах и пулах. Кроме того, следует соблюдать осторожность и не запускать сеанс ведения журнала случайным образом, не разобравшись сначала в эффективности данного сценария в конкретном случае. Использование неправильного сценария или сценария, не соответствующего задаче, либо запуск сценария в неправильной области применения (будь это глобальный уровень, уровень площадки, пула или компьютера), может привести к получению сомнительных и не слишком полезных данных — как если бы никакой сценарий вообще не запускался.

Чтобы управлять функциями централизованной службы ведения журналов с помощью командной консоли 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"}

Примечание.

Так что вы можете задаться вопросом: теперь, когда вы включили ведение журнала, где хранятся журналы? Так как вы будете получать доступ к информации, хранящейся в журналах, с помощью запросов оболочки управления, отправленных в агенты CLS, и вы можете выводить результаты в несколько возможных форматов файлов, где на каждом сервере агент CLS хранит свои записи на самом деле не важно знать. Файлы журналов можно сохранить в указанное расположение, а также считывать и анализировать с помощью различных средств, включая Snooper.exe и любое средство, которое может считывать текстовый файл, например Notepad.exe. Snooper.exe входит в состав средств отладки Skype для бизнеса Server 2015 года и доступен для скачивания в Интернете.

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

Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.
Запросите централизованную службу ведения журнала, чтобы узнать, какие сценарии в настоящее время выполняются, введя следующее:
```
Show-CsClsLogging
```
Результатом выполнения Show-CsClsLogging являются сводные данные обо всех выполняемых сценариях и областях их выполнения. Подробные сведения см. в статье Show-CsClsLogging.
Чтобы остановить выполняемый в данный момент сеанс ведения журнала, введите:
```
Stop-CsClsLogging -Scenario <scenario name> -Computers <comma separated list of fully qualified computer names> -Pools <comma separated list of fully qualified pool names>
```
Например:
```
Stop-CsClsLogging -Scenario UserReplicator -Pools pool01.contoso.net
```
Эта команда остановит ведение журнала с помощью сценария UserReplicatior для pool01.contoso.net.

Примечание.

Журналы, созданные в течение останавливаемого сеанса ведения журнала с помощью сценария UserReplicator, не удаляются. Журналы остаются доступными для выполнения поиска с помощью команды Search-CsClsLogging. Подробные сведения см. в статье Search-CsClsLogging.

Действуя в качестве команды-спутника для Start-CsClsLogging, командлет Stop-CsClsLogging завершает сеанс ведения журнала и сохраняет журналы, созданные в течение этого сеанса. Одновременно на данном компьютере может выполняться не более двух сценариев. Способ остановки одного сценария для сбора данных с помощью другого сценария является типовой задачей, часто выполняемой при устранении неполадок рабочих нагрузок.

См. также

Centralized Logging Service in Skype for Business 2015