Централизованная служба ведения журнала в Skype для бизнеса 2015Centralized Logging Service in Skype for Business 2015

Сводка: Сведения о компонентах службы и параметры конфигурации для централизованной службы ведения журналов в Скайп для Business Server 2015.Summary: Learn about the service components and configuration settings for the Centralized Logging Service in Skype for Business Server 2015.

Службы централизованного ведения журналов выполнить следующие действия.The Centralized Logging Service can:

  • Запуск или остановка ведения журнала на один или несколько компьютеров и пулов с помощью одной команды из центрального расположения.Start or stop logging on one or more computers and pools with a single command from a central location.

  • поиск в журналах на одном или нескольких компьютерах и в пулах.Search logs on one or more computers and pools. Настройка поиска для возвращения всех журналов на всех компьютерах или более кратким результатов.You can tailor the search to return all logs on all machines, or return more concise results.

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

    • Определение сценарияили использовать сценарий по умолчанию.Define a Scenario, or use a default scenario. Сценарий в централизованной службы ведения журналов состоит из области действия (глобальные или сайт), имя сценария для определения назначения сценария и одного или нескольких поставщиков.A scenario in Centralized Logging Service is made up of scope (global or site), a scenario name to identify the purpose of the scenario, and one or more providers. Сценарий по умолчанию и один определенный сценарий можно запустить в любой момент времени на компьютере.You can run the default scenario and one defined scenario at any given time on a computer.

    • Использование существующего поставщика или создание нового поставщика.Use an existing provider or create a new provider. Aprovider определяет собирает сеанс ведения журнала, какой уровень детализации, какие компоненты для трассировки и какие флаги, применяются.Aprovider defines what the logging session collects, what level of detail, what components to trace, and what flags are applied.

      Совет

      Если вы знакомы с OCSLogger, termproviders ссылается на коллекцию компонентов (например, S4, SIPStack), тип ведения журнала (например, WPP, EventLog или IIS файла журнала), уровня трассировки (например, все, подробные сообщения, отладка) и флаги (например, TF_COMPONENT, TF_DIAG).If you are familiar with OCSLogger, the termproviders refers to the collection of components (for example, S4, SIPStack), a logging type (for example, WPP, EventLog, or IIS logfile), a tracing level (for example, All, verbose, debug), and flags (for example, TF_COMPONENT, TF_DIAG). Эти элементы определяются в поставщике (переменной Windows PowerShell) и передается в команду централизованной службы ведения журналов.These items are defined in the provider (a Windows PowerShell variable) and passed into the Centralized Logging Service command.

    • Настройка журналов для определенных компьютеров и пулов.Configure logs for specific computers and pools.

    • Определите узел сеанса ведения журналов в параметрах Узел (для сбора данных только с компьютеров в этом узле) или Глобальный (для сбора данных со всех компьютеров в развертывании).Define the scope for the logging session from the options Site (to run logging captures on computers in that site only), or Global (to run logging captures on all computers in the deployment).

Службы централизованного ведения журналов — это мощное средство устранения неполадок для решения проблем больших или у анализ основных причин снижения производительности.The Centralized Logging Service is a powerful troubleshooting tool for problems large or small, from root cause analysis to performance problems. Во всех примерах показаны с помощью Скайп для консоли Business Server.All examples are shown using the Skype for Business Server Management Shell. Справка предоставляется для средства командной строки по средству, однако это не имеет ограниченный набор функций, которые можно выполнить с помощью командной строки.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. С помощью Скайп для консоли Business Server, имеется доступ к намного более и более настраиваемая набор функциональных возможностей, поэтому всегда должно быть в первую очередь.By using Skype for Business Server Management Shell, you have access to a much larger and much more configurable set of features, so that should always be your first choice.

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

Службы централизованного ведения журналов выполняется на всех серверах в развертывании и включает в себя следующие агенты и служб:The Centralized Logging Service runs on all servers in your deployment, and is made up of the following agents and services:

  • Централизованный ClsAgent агента службы ведения журналов выполняется на каждом компьютере с Скайп для развертывания Business Server.Centralized Logging Service Agent ClsAgent runs on every machine with Skype for Business Server deployed. Он прослушивает (порты TCP 50001 50003) для команды из ClsController через WCF и отправляет ответы на контроллер.It listens ( on ports TCP 50001-50003) for commands from ClsController over WCF and sends responses back to the controller. Управляет журнала сеансов (start, stop или изменение) и выполняет поиск журналы.It manages log sessions (start/stop/update), and searches logs. Он также выполняет такие служебные операции, как архивирование и очистка журналов.It also performs housekeeping operations like log archiving and purges.

  • Централизованного ведения журналов службы контроллера командлеты Скайп для консоли Business Server отправляет команды Start, Stop, очистка и поиска ClsAgent.Centralized Logging Service Controller Cmdlets The Skype for Business Server Management Shell sends Start, Stop, Flush, and Search commands to the ClsAgent. При отправке команд поиска итоговый журналы возвращаются ClsControllerLib.dll и сгруппировать.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. Сведения, приведенные в следующих разделах, ориентированный на использование Скайп для консоли Business Server.The information in the following topics is focused on using the Skype for Business Server Management Shell.

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

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

Выполнение команд, с помощью интерфейса командной строки Windows Server или Скайп для консоли Business Server.You issue commands using the Windows Server command-line interface or using the Skype for Business Server Management Shell. На компьютере войти в систему и отправляется ClsAgent локально или в другие компьютеры и пулы в развертывании выполняются команды.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 maintains an index file of all .CACHE files that it has on the local machine. ClsAgent выделяет их, чтобы они равномерно распределены между томами, определенные с помощью параметра CacheFileLocalFolders, никогда не потребляет более 80% каждого тома (то есть, расположение локального кэша и процент может быть настроен с помощью ** Set-CsClsConfiguration** командлета).ClsAgent allocates them so that they are evenly distributed across volumes defined by the option CacheFileLocalFolders, never consuming more than 80% of each volume (that is, the local cache location and the percentage is configurable using the Set-CsClsConfiguration cmdlet). ClsAgent также отвечает за удаление с локального компьютера устаревших кэшированных файлов журнала трассировки событий (файлов ETL).ClsAgent is also responsible for aging old cached event trace log (.etl) files off the local machine. После две недели (то есть, временной интервал может быть настроен с помощью командлета Set-CsClsConfiguration ) эти файлы копируются в файловом ресурсе и удален с локального компьютера.After two weeks (that is, the timeframe is configurable using the Set-CsClsConfiguration cmdlet) these files are copied to a file share and deleted from the local computer. Дополнительные сведения см Set-CsClsConfiguration.For details, see Set-CsClsConfiguration. При получении запроса поиска условия поиска используются для выбора набора кэшированных ETL-файлов для выполнения поиска на основании значений из индекса, поддерживаемого агентом.When a search request is received, the search criteria is used to select the set of cached .etl files to perform the search based on the values in the index maintained by the agent.

Примечание

ClsAgent может выполнять поиск файлов, перемещенных в общую папку с локального компьютера. После перемещения файлов в общую папку ClsAgent не контролирует их устаревание и удаление. Необходимо определить административную задачу для отслеживания размера файлов в общей папке и их удаления или архивации.Files that are moved to the file share from the local computer can be searched by ClsAgent. Once ClsAgent moves the files to the file share, the aging and removal of files is not maintained by ClsAgent. You should define an administrative task to monitor the size of the files in the file share and delete them or archive them.

Результирующие файлы журналов можно считывать и анализировать с помощью различных средств, в том числе с помощью Snooper.exe ** и других средств, способных считывать текстовые файлы, таких как **Notepad.exe.The resulting log files can be read and analyzed using a variety of tools, including Snooper.exe and any tool that can read a text file, such as Notepad.exe. Snooper.exe является частью Скайп для средств отладки 2015 Business Server и доступен в качестве Web загрузить.Snooper.exe is part of the Skype for Business Server 2015 Debug Tools and is available as a Web download.

Как OCSLogger Centralized Logging Service имеет несколько компонентов для трассировки от и позволяет выбрать флаги, такие как TF_COMPONENT и TF_DIAG.Like OCSLogger, the Centralized Logging Service has several components to trace against, and provides options to select flags, such as TF_COMPONENT and TF_DIAG. Служба централизованного ведения журналов также сохраняет параметры уровня ведения журнала из OCSLogger.Centralized Logging Service also retains the logging level options of OCSLogger.

Наиболее важное преимущество использования Скайп для консоли Business Server через командной строки ClsController — можно настраивать и определить новые сценарии, с помощью выбранного поставщиков, относящихся к области, настраиваемые флаги и уровни ведения журнала.The most important advantage to using the Skype for Business Server Management Shell over the command-line ClsController is that you can configure and define new scenarios using selected providers that target the problem space, custom flags, and logging levels. Сценарии для ClsController только те, которые определены для исполняемого файла.The scenarios available to ClsController are limited to those that are defined for the executable.

В предыдущих версиях средство OCSLogger.exe позволяло администраторам и сотрудникам технической поддержки собирать файлы трассировки с компьютеров в развертывании. Наряду с преимуществами средство OCSLogger обладало одним существенным недостатком. В заданный момент времени журналы можно было собирать только на одном компьютере. Можно было вести журналы на нескольких компьютерах с помощью отдельных копий OCSLogger, но при этом создавалось несколько журналов, а простого способа объединения результатов не существовало.In previous versions, OCSLogger.exe was provided to enable administrators and support personnel to collect trace files from computers in the deployment. OCSLogger, for all of its strengths, had a shortcoming. You could only collect logs on one computer at a given time. You could log on to multiple computers by using separate copies of OCSLogger, but you ended up with multiple logs and no easy way to aggregate the results.

Когда пользователь запрашивает поиск журналов, ClsController определяет, на какие компьютеры отправить этот запрос (на основании выбранных сценариев). Контроллер также определяет, нужно ли выполнять поиск в общей папке, в которой находятся сохраненные ETL-файлы. При получении результатов поиска ClsController объединяет их в один упорядоченный по времени набор, который предоставляется пользователю. Пользователи могут сохранять результаты поиска на локальном компьютере для дальнейшего анализа.When a user requests a log search, the ClsController determines which machines to send the request to (that is, based on the scenarios selected). It also determines whether the search needs to be sent to the file share where the saved .etl files are located. When the search results are returned to the ClsController, the controller merges the results into a single time-ordered result set that is presented to the user. Users can save the search results to their local machine for further analysis.

При запуске сеанса ведения журнала пользователь указывает сценарии, имеющие отношение к решаемой задаче. В любой момент времени могут выполняться два сценария. Одним из этих сценариев должен быть сценарий AlwaysOn. Как можно понять из названия, этот сценарий должен всегда выполняться в развертывании, собирая сведения о всех компьютерах, пулах и компонентах.When you start a logging session, you specify scenarios that are relative to the problem that you are trying to resolve. You can have two scenarios running at any time. One of these two scenarios should be the AlwaysOn scenario. As the name implies, it should always be running in your deployment, collecting information on all computers, pools, and components.

Важно!

Сценарий AlwaysOn не выполняется в развертывании по умолчанию.By default, the AlwaysOn scenario is not running in your deployment. Этот сценарий необходимо явно запустить.You must explicitly start the scenario. После запуска он будет выполняться, пока не будет явно остановлен, а состояние выполнения будет сохраняться между перезагрузками компьютеров.Once started, it will continue to run until explicitly stopped, and the running state will persist through reboots of the computers. Подробные сведения о запуске и остановке сценарии, в разделе Запуск или остановка CLS запись в журнал в Скайп для Business Server 2015.For details on starting and stopping scenarios, see Start or stop CLS log capture in Skype for Business Server 2015.

При возникновении неполадок запустите второй сценарий, связанный с обнаруженной проблемой. Воспроизведите условия возникновения проблемы и остановите ведение журнала для второго сценария. Выполните в журнале поиск данных, связанных с обнаруженной проблемой. При объединении журналов создается файл, содержащий сообщения трассировки со всех компьютеров в области сайта или в глобальной области развертывания. Если поиск возвращает слишком много данных, которые физически невозможно проанализировать (такую ситуацию часто называют отношением "сигнал-шум", в котором значение "шума" слишком велико), выполните другой поиск с более точными параметрами. На этом этапе можно заметить наборы данных, которые позволяют выявить признаки проблемы и сузить круг поиска. В конечном счете, после выполнения нескольких уточненных поисков можно обнаружить данные, имеющие отношение к проблеме, и определить ее причину.When a problem occurs, start a second scenario that relates to the problem reported. Reproduce the problem, and stop the logging for the second scenario. Begin your log searches relative to the problem reported. The aggregated collection of logs produces a log file that contains trace messages from all computers in your site or global scope of your deployment. If the search returns more data than you can feasibly analyze (typically known as a signal-to-noise ratio, where the noise is too high), you run another search with narrower parameters. At this point, you can begin to notice patterns that show up and can help you get a clearer focus on the problem. Ultimately, after you perform a couple of refined searches you can find data that is relevant to the problem and figure out the root cause.

Совет

Когда появится проблемный сценарий в Скайп для Business Server, в первую очередь спросите себя «Что уже узнать о проблеме?»When presented with a problem scenario in Skype for Business Server, start by asking yourself "What do I already know about the problem?" Если измерить границы проблему, можно исключить большая часть действующие сущностей в Скайп для Business Server.If you quantify the problem boundaries, you can eliminate a large part of the operational entities in Skype for Business Server.

Рассмотрим пример сценария, в котором пользователи не получают актуальные результаты при поиске контактов.Consider an example scenario where you know that users are not getting current results when looking for a contact. Нет смысла в поиск проблем в компонентов мультимедиа, корпоративной голосовой связи, конференц-связи и ряд других компонентов.There is no point in looking for problems in the media components, Enterprise Voice, conferencing, and a number of other components. Неизвестно только то, где фактически возникла проблема: в клиенте или на стороне сервера?What you may not know is where the problem actually is: on the client, or is this a server-side problem? Контакты собранные Репликатор пользователей из Active Directory и доставки клиенту через сервер адресной книги (этой).Contacts are collected from Active Directory by the User Replicator and delivered to the client by way of the Address Book Server (ABServer). Этой получает обновления из базы данных RTC (где репликатора пользовательских данных был создан их) и собирает их в файлы адресной книги по умолчанию - 1:30 по.The ABServer gets its updates from the RTC database (where User Replicator wrote them) and collects them into address book files, by default - 1:30 AM. Скайп для клиентов, Business Server получить новый адресной книги в произвольной время по расписанию.The Skype for Business Server clients retrieve the new address book on a randomized schedule. Так как вы знаете, как работает процесс, можно уменьшить поиск возможных причин проблемы, связанные с данными, записываются из Active Directory с репликатора пользовательских данных этой не извлечение и создание файлов адресной книги или клиенты не Загрузка файла адресной книги.Because you know how the process works, you can reduce your search for the potential cause to an issue related to data being collected from Active Directory by the User Replicator, the ABServer not retrieving and creating the address book files, or the clients not downloading the address book file.

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

Службы централизованного ведения журналов настроен для определения возможности службы ведения журналов предназначен для collect, как оно собирает, где он будет собирать из и какие существуют параметры журнала.The Centralized Logging Service is configured to define what the logging service is intended to collect, how it collects, where it will collect from, and what the log settings are. Определить следующие параметры глобально (то есть для всего развертывания) или для сайта (то есть, именованных сайтов в развертывании).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.

Чтобы отобразить текущую конфигурацию централизованной службы ведения журналовTo display the current Centralized Logging Service configuration

  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. Введите следующую команду в командной строке:Type the following at a command-line prompt:

    Get-CsClsConfiguration
    

    Совет

    Вы можете сузить или расширить область параметров конфигурации, которые возвращаются, определив -Identity и области, например «Site: Redmond», чтобы возвратить только CsClsConfiguration для сайта Redmond.You can narrow or expand the scope of the configuration settings that are returned by defining -Identity and a scope, such as "Site:Redmond" to return only the CsClsConfiguration for the site Redmond. Просмотра сведений о данная часть конфигурации можно передать выходные данные в другой командлета Windows PowerShell.If you want details about a given portion of the configuration, you can pipe the output into another Windows PowerShell cmdlet. Например чтобы получить сведения о сценариях в конфигурации для сайта Redmond, введите Get-CsClsConfiguration -Identity "site:Redmond" | Select-Object -ExpandProperty Scenarios.For example, to get details about the scenarios defined in the configuration for site "Redmond", type: Get-CsClsConfiguration -Identity "site:Redmond" | Select-Object -ExpandProperty Scenarios

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

    Результат выполнения командлета демонстрирует текущую конфигурацию службы централизованного ведения журналов.The result from the cmdlet displays the current configuration of the Centralized Logging Service.

Параметр конфигурацииConfiguration Setting ОписаниеDescription
IdentityIdentity
Определяет область действия и имя данной конфигурации. Существует одна глобальная конфигурация и по одной конфигурации для каждого сайта.Identifies the scope and name for this configuration. There is only one Global configuration, and one configuration per site.
ScenariosScenarios
Список всех сценариев, определенных для данной конфигурации.Listing of all scenarios that are defined for this configuration.
SearchTermsSearchTerms
Определенные поисковые запросы для этой конфигурации.Defined search terms for the configuration. Office 365, не в локальных развертываниях.Office 365, not on-premises deployments.
Групп безопасности поSecurityGroups
Определенные группы безопасности, которые управляют кто (т. е. участники групп безопасности) могут просматривать компьютеры на основе сайта их размещения.Defined security groups that control who (that is, members of the security groups) can see computers based on the site they are located in. В данном контексте-сайт, определенный в построителе топологий.Site, in this context, is the site as defined in Topology Builder.
RegionsRegions
Определенные регионы используются для сбора групп безопасности по регионам, например EMEA (страны Европы, Ближнего Востока и Африки).Defined regions are used to collect SecurityGroups into a region, for example EMEA.
EtlFileRolloverSizeMBEtlFileRolloverSizeMB
Данный параметры указывает максимальный размер файла журнала до создания нового файла трассировки журнала (.etl). Новый файл журнала создается при достижении определенного размера, даже если не было достигнуто значение, заданное в параметре EtlFileRolloverMinutes.The parameter indicates the maximum size of the log file before a new event trace log (.etl) file is created. A new log file is created when the defined size is reached even if the maximum time set in EtlFileRolloverMinutes has not yet been reached.
EtlFileRolloverMinutesEtlFileRolloverMinutes
Определенное максимальное время существования журнала (в минутах) до создания нового ETL-файла. Новый файл журнала создается по завершении таймера, даже если еще не было достигнуто значение максимального размера, заданное в параметре EtlFileRolloverSizeMB.Defined maximum amount of time, in minutes, that a log can elapse before a new .etl file is created. A new log file is created when the timer expires even if the maximum size set in EtlFileRolloverSizeMB has not yet been reached.
TmfFileSearchPathTmfFileSearchPath
Местоположение для поиска файлов формата трассировки сообщений.Location to search for the trace message format files.
CacheFileLocalFoldersCacheFileLocalFolders
Определенный путь к месту сохранения файлов кэша на компьютерах. CLSAgent записывает файлы кэша и работает в контексте сетевой службы. В этом случае значением переменной %TEMP% является %WINDIR%\ServiceProfiles\NetworkService\AppData\Local. По умолчанию файлы кэша и файлы журнала записываются в один каталог.Defined path to the location where cache files are written on computers. CLSAgent writes the cache files and runs under the context of the Network Service. In this case, %TEMP% expands to %WINDIR%\ServiceProfiles\NetworkService\AppData\Local. By default, cache files and log files are written to the same directory.
CacheFileNetworkFolderCacheFileNetworkFolder
Можно определить UNC-путь для получения файлов кэша во время операций ведения журналов.You can define a universal naming convention (UNC) path to receive the cache files during logging operations.
CacheFileLocalRetentionPeriodCacheFileLocalRetentionPeriod
Определяется как максимальное время в днях для сохранения файлов кэша.Defined as the maximum time, in days, that cache files are retained.
CacheFileMaxDiskUsageCacheFileMaxDiskUsage
Определяется как часть дискового пространства (выраженное в процентах), которое может использоваться под файлы кэша.Defined as the percentage of disk space that can be used by the cache files.
ComponentThrottleLimitComponentThrottleLimit
Определяется как максимальное количество трассировок в секунду, которое может создавать компонент до активации автоматического ограничителя.Defined as the maximum number of traces per second that a component can produce before the automatic throttle limiter is triggered.
ComponentThrottleSampleComponentThrottleSample
Количество превышений значения ComponentThrottleLimit в течение 60 секунд.Number of times in 60 seconds that the ComponentThrottleLimit can be exceeded.
MinimumClsAgentServiceVersionMinimumClsAgentServiceVersion
Минимальная версия CLSAgent, допустимая для запуска.The minimum version of the CLSAgent allowed to run. Этот элемент предназначен для Office 365.This element is intended for Office 365.