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

Skype for Business Server 2015
 

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

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

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

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

Сценарий по умолчанию называется 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.

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

  2. Запустите сценарий ведения журнала с помощью централизованной службы ведения журнала, введя следующую команду:

    Start-CsClsLogging -Scenario 
        <name of scenario>
      
    

    Например для запуска сценария AlwaysOn введите:

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

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

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

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

  2. Для управления командами ведения журнала доступны дополнительные параметры. Можно использовать параметр – Duration, чтобы задать длительность времени выполнения сценария. Также можно с помощью параметра – Computers определить разделяемый запятыми список полных доменных имен компьютеров, а с помощью параметра – Pools определить разделяемый запятыми список полных доменных имен пулов, на которых нужно вести журнал.

    Пусть нужно запустить сеанс ведения журнала с помощью сценария UserReplicator для пула "pool01.contoso.net". При этом длительность сеанса ведения журнала определяется равной 8 часам. Для этого введите следующую команду:

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

    При успешном выполнении этого сценария возвращается результат, подобный следующему:

    Запуск Start-CsClsLogging.

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

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

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

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

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

  2. Отправьте запрос в централизованную службу ведения журнала, чтобы определить, какие сценарии выполняются в данный момент времени, введя следующую команду:

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

    Результатом выполнения Show-CsClsLogging являются сводные данные обо всех выполняемых сценариях и областях их выполнения. Подробные сведения см. в статье Show-CsClsLogging.

  3. Чтобы остановить выполняемый в данный момент сеанс ведения журнала, введите:

    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.

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

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

 
Показ: