Централизованная служба ведения журнала в Skype для бизнеса 2015

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

Централизованная служба ведения журнала может:

  • Запустите или остановите ведение журнала на одном или нескольких компьютерах и пулах с помощью одной команды из центрального расположения.

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

  • Настройте сеансы ведения журналов следующим образом:

    • Define a Scenario, or use a default scenario. Сценарий в централизованной службе ведения журнала состоит из область (глобального или сайта), имени сценария для определения цели сценария и одного или нескольких поставщиков. Вы можете запустить сценарий по умолчанию и один определенный сценарий в любой момент времени на компьютере.

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

      Совет

      Если вы знакомы с OCSLogger, терминпровидеры относятся к коллекции компонентов (например, S4, SIPStack), типу ведения журнала (например, WPP, EventLog или файлу журнала IIS), уровню трассировки (например, All, verbose, debug) и флагам (например, TF_COMPONENT, TF_DIAG). Эти элементы определяются в поставщике (переменная Windows PowerShell) и передаются в команду централизованной службы ведения журнала.

    • Настройка журналов для определенных компьютеров и пулов.

    • Определите узел сеанса ведения журналов в параметрах Узел (для сбора данных только с компьютеров в этом узле) или Глобальный (для сбора данных со всех компьютеров в развертывании).

Централизованная служба ведения журнала — это мощное средство устранения больших или мелких проблем, от анализа первопричин до проблем с производительностью. Все примеры показаны с помощью командной консоли Skype для бизнеса Server. Help is provided for the command-line tool through the tool itself, but there is a limited set of functions that you can execute from the command line. Используя Skype для бизнеса Server командную консоль, вы получите доступ к гораздо большему и гораздо более настраиваемому набору функций, поэтому это всегда должен быть вашим первым выбором.

Компоненты службы ведения журналов

Централизованная служба ведения журнала работает на всех серверах в развертывании и состоит из следующих агентов и служб:

  • Централизованный агент службы ведения журнала ClsAgent выполняется на каждом компьютере с развернутыми Skype для бизнеса Server. Он прослушивает ( на портах TCP 50001-50003) для команд из ClsController через WCF и отправляет ответы обратно контроллеру. Он управляет сеансами журналов (запуск, остановка, обновление) и выполняет поиск в журналах. Он также выполняет такие служебные операции, как архивирование и очистка журналов.

  • Командлеты контроллера службы централизованного ведения журнала. Командлеты командной консоли Skype для бизнеса Server отправляются команды Start, Stop, Flush и Search в ClsAgent. When search commands are sent, the resulting logs are returned to the ClsControllerLib.dll and aggregated. The controller sends commands to the agent, receives the status of those commands and manages the search log file data as it is returned from all agents on any computer in the search scope, and aggregates the log data into a meaningful and ordered output set. Сведения в следующих разделах посвящены использованию командной консоли Skype для бизнеса Server.

Взаимодействие ClsController и ClsAgent

Связь между CLSController и CLSAgent.

Команды выдаются с помощью интерфейса командной строки Windows Server или командной консоли Skype для бизнеса Server. The commands are executed on the computer you are logged in to and sent to the ClsAgent locally or to the other computers and pools in your deployment.

ClsAgent поддерживает файл индекса всех файлов .CACHE, которые имеются на локальном компьютере. ClsAgent размещает их так, чтобы они равномерно распределялись по томам, определенным параметром CacheFileLocalFolders, и не занимали более 80% места на каждом томе (расположение и процент локального кэша можно настроить с помощью командлета Set-CsClsConfiguration). ClsAgent также отвечает за удаление с локального компьютера устаревших кэшированных файлов журнала трассировки событий (файлов ETL). По истечении двухнедельного срока (этот временной интервал настраивается с помощью командлета Set-CsClsConfiguration) эти файлы копируются в общую папку и удаляются с локального компьютера. Дополнительные сведения см. в описании командлета Set-CsClsConfiguration. При получении запроса поиска условия поиска используются для выбора набора кэшированных ETL-файлов для выполнения поиска на основании значений из индекса, поддерживаемого агентом.

Примечание.

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

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

Как и OCSLogger, централизованная служба ведения журнала имеет несколько компонентов для трассировки и предоставляет параметры для выбора флагов, например TF_COMPONENT и TF_DIAG. Централизованная служба ведения журнала также сохраняет параметры уровня ведения журнала OCSLogger.

Наиболее важным преимуществом использования командной консоли Skype для бизнеса Server по сравнению с ClsController из командной строки является возможность настройки и определения новых сценариев с помощью выбранных поставщиков, предназначенных для пространства проблем, пользовательских флагов и уровней ведения журнала. The scenarios available to ClsController are limited to those that are defined for the executable.

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

Когда пользователь запрашивает поиск журналов, ClsController определяет, на какие компьютеры отправить этот запрос (на основании выбранных сценариев). Контроллер также определяет, нужно ли выполнять поиск в общей папке, в которой находятся сохраненные ETL-файлы. При получении результатов поиска ClsController объединяет их в один упорядоченный по времени набор, который предоставляется пользователю. Пользователи могут сохранять результаты поиска на локальном компьютере для дальнейшего анализа.

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

Важно!

Сценарий AlwaysOn не выполняется в развертывании по умолчанию. Этот сценарий необходимо явно запустить. После запуска он будет выполняться, пока не будет явно остановлен, а состояние выполнения будет сохраняться между перезагрузками компьютеров. Дополнительные сведения о сценариях запуска и остановки см. в статье Запуск или остановка сбора журналов CLS в Skype для бизнеса Server 2015 г.

При возникновении неполадок запустите второй сценарий, связанный с обнаруженной проблемой. Воспроизведите условия возникновения проблемы и остановите ведение журнала для второго сценария. Выполните в журнале поиск данных, связанных с обнаруженной проблемой. При объединении журналов создается файл, содержащий сообщения трассировки со всех компьютеров в области сайта или в глобальной области развертывания. Если поиск возвращает слишком много данных, которые физически невозможно проанализировать (такую ситуацию часто называют отношением "сигнал-шум", в котором значение "шума" слишком велико), выполните другой поиск с более точными параметрами. На этом этапе можно заметить наборы данных, которые позволяют выявить признаки проблемы и сузить круг поиска. В конечном счете, после выполнения нескольких уточненных поисков можно обнаружить данные, имеющие отношение к проблеме, и определить ее причину.

Совет

При появлении сценария проблемы в Skype для бизнеса Server начните с вопроса "Что я уже знаю о проблеме?" Если определить границы проблемы, можно устранить большую часть операционных сущностей в Skype для бизнеса Server.

Рассмотрим пример сценария, в котором пользователи не получают актуальные результаты при поиске контактов. Нет смысла искать проблемы в компонентах мультимедиа, Корпоративная голосовая связь, конференц-связи и ряде других компонентов. Неизвестно только то, где фактически возникла проблема: в клиенте или на стороне сервера? Контакты собираются из Active Directory репликатором пользователей и доставляются клиенту через сервер адресной книги (ABServer). ABServer получает обновления из базы данных RTC (где они были записаны репликатором пользователей) и собирает их в файлы адресной книги по умолчанию — 1:30. Клиенты Skype для бизнеса Server извлекают новую адресную книгу по случайному расписанию. Так как вы знаете, как работает этот процесс, вы можете сократить поиск потенциальной причины проблемы, связанной с получением данных из Active Directory репликатором пользователей, не извлекая и не создавая файлы адресной книги, или клиенты не скачивают файл адресной книги.

Текущая конфигурация

Централизованная служба ведения журнала настроена так, чтобы определить, что служба ведения журналов предназначена для сбора данных, как она собирается, откуда будет собираться и какие параметры журнала. You define these settings globally (that is, for the entire deployment) or for a site (that is, a named site in your deployment). Any logging that you define will use the settings that are appropriate for the identity that you use for commands to start, stop, flush, and search logs.

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

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

  2. Введите следующую команду в командной строке:

    Get-CsClsConfiguration
    

    Совет

    Вы можете сузить или развернуть область параметров конфигурации, возвращаемых путем определения -Identity и область, например Site:Redmond, чтобы вернуть только csClsConfiguration для сайта Redmond. Если вам нужны сведения об определенной части конфигурации, можно передать выходные данные в другой командлет Windows PowerShell. Например, чтобы получить сведения о сценариях, определенных в конфигурации для сайта Redmond, введите: Get-CsClsConfiguration -Identity "site:Redmond" | Select-Object -ExpandProperty Scenarios

    Выход выборки из Get-CsClsConfiguration.

    Результат командлета отображает текущую конфигурацию централизованной службы ведения журнала.

Параметр конфигурации Описание
Идентификатор
Определяет область действия и имя данной конфигурации. Существует одна глобальная конфигурация и по одной конфигурации для каждого сайта.
Scenarios
Список всех сценариев, определенных для данной конфигурации.
SearchTerms
Определенные поисковые запросы для этой конфигурации. Microsoft 365 или Office 365, а не локальные развертывания.
SecurityGroups
Определенные группы безопасности, которые управляют кто (т. е. участники групп безопасности) могут просматривать компьютеры на основе сайта их размещения. Сайт в этом контексте — это сайт, определенный в построителе топологий.
Regions
Определенные регионы используются для сбора групп безопасности по регионам, например EMEA (страны Европы, Ближнего Востока и Африки).
EtlFileRolloverSizeMB
Данный параметры указывает максимальный размер файла журнала до создания нового файла трассировки журнала (.etl). Новый файл журнала создается при достижении определенного размера, даже если не было достигнуто значение, заданное в параметре EtlFileRolloverMinutes.
EtlFileRolloverMinutes
Определенное максимальное время существования журнала (в минутах) до создания нового ETL-файла. Новый файл журнала создается по завершении таймера, даже если еще не было достигнуто значение максимального размера, заданное в параметре EtlFileRolloverSizeMB.
TmfFileSearchPath
Местоположение для поиска файлов формата трассировки сообщений.
CacheFileLocalFolders
Определенный путь к месту сохранения файлов кэша на компьютерах. CLSAgent записывает файлы кэша и работает в контексте сетевой службы. В этом случае значением переменной %TEMP% является %WINDIR%\ServiceProfiles\NetworkService\AppData\Local. По умолчанию файлы кэша и файлы журнала записываются в один каталог.
CacheFileNetworkFolder
Можно определить UNC-путь для получения файлов кэша во время операций ведения журналов.
CacheFileLocalRetentionPeriod
Определяется как максимальное время в днях для сохранения файлов кэша.
CacheFileMaxDiskUsage
Определяется как часть дискового пространства (выраженное в процентах), которое может использоваться под файлы кэша.
ComponentThrottleLimit
Определяется как максимальное количество трассировок в секунду, которое может создавать компонент до активации автоматического ограничителя.
ComponentThrottleSample
Количество превышений значения ComponentThrottleLimit в течение 60 секунд.
MinimumClsAgentServiceVersion
Минимальная версия CLSAgent, допустимая для запуска. Этот элемент предназначен для Microsoft 365 или Office 365.