Средство просмотра трассировки службы (SvcTraceViewer.exe)

Средство просмотра трассировки служб Windows Communication Foundation (WCF) помогает анализировать диагностические трассировки, которые создаются с помощью WCF. Средство просмотра трассировки службы позволяет легко объединять, просматривать и фильтровать сообщения трассировки в журнале, чтобы можно было диагностировать, восстановить и проверить проблемы со службой WCF.

Настройка трассировки

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

Трассировку можно настроить с помощью файла конфигурации приложения Web.config для веб-приложений или.config имени приложения для локальных приложений. Ниже приведен пример:

<system.diagnostics>
    <trace autoflush="true" />
    <sources>
            <source name="System.ServiceModel"
                    switchValue="Information, ActivityTracing"
                    propagateActivity="true">
            <listeners>
               <add name="sdt"
                   type="System.Diagnostics.XmlWriterTraceListener"
                   initializeData= "SdrConfigExample.e2e" />
            </listeners>
         </source>
    </sources>
</system.diagnostics>

В этом примере указывается имя и тип прослушивателя трассировки. Прослушиватель имеет имя sdt, а стандартный прослушиватель трассировки .NET Framework (System.Diagnostics.XmlWriterTraceListener) добавлен в качестве типа. Атрибут initializeData используется для задания имени файла журнала для этого прослушивателя SdrConfigExample.e2e. В журнале можно заменить простое имя файла на полностностью указанный путь.

В примере создается файл в корневом каталоге с именем SdrConfigExample.e2e. При использовании средства просмотра трассировки для открытия файла, как описано в разделе "Открытие и просмотр файлов трассировки WCF", можно просмотреть все отправленные сообщения.

Уровень трассировки управляется параметром switchValue . Доступные уровни трассировки описаны в следующей таблице.

Уровень трассировки	Описание
Критически важно	— журналы Fail-Fast и записи журнала событий, а также сведения о корреляции трассировки. Ниже приведены некоторые примеры использования критического уровня: — Ваш домен приложения AppDomain остановился из-за необработанного исключения. — Не удается запустить приложение. — Сообщение, вызвавшее сбой, поступило из процесса MyApp.exe.
Ошибка	— регистрирует все исключения. Уровень ошибки можно использовать в следующих ситуациях: — Код произошел сбой из-за недопустимого исключения приведения. — Исключение "не удалось создать конечную точку" вызывает сбой приложения при запуске.
Предупреждение	— Существует условие, которое может привести к ошибке или критическому сбою. Этот уровень можно использовать в следующих ситуациях: — приложение получает больше запросов, чем разрешены его параметры регулирования. — Получающая очередь загружена на 98 процентов от своей настроенной емкости.
Информация	— Создаются сообщения, полезные для мониторинга и диагностики состояния системы, измерения производительности или профилирования. Такие сведения можно использовать для планирования емкости и управления производительностью. Этот уровень можно использовать в следующих ситуациях: — Сбой произошел после того, как сообщение достигло домена приложения и было десериализовано. — Произошел сбой при создании привязки HTTP.
Многословный	— Трассировка уровня отладки для пользовательского кода и поддержки. Установите этот уровень, когда: — Вы не уверены, какой метод в коде был вызван, когда произошел сбой. — У вас настроена неправильная конечная точка, и служба не удалось запустить, так как запись в хранилище резервирования заблокирована.
ActivityTracing (Отслеживание активности)	Поток событий между действиями обработки и компонентами. Этот уровень позволяет администраторам и разработчикам сопоставлять приложения в одном домене приложения. — трассировки для границ действий: запуск и остановка. — трассировки для передачи.

Можно использовать add для указания имени и типа прослушивателя трассировки, который вы хотите использовать. В примере конфигурации прослушиватель называется sdt , а стандартный прослушиватель трассировки .NET Framework (System.Diagnostics.XmlWriterTraceListener) добавляется в качестве типа. Используйте initializeData, чтобы задать имя файла журнала для этого прослушивателя. Кроме того, можно заменить простое имя файла на полностью определенный путь.

Начиная с .NET Framework 4.8 элементы управления ComboBox в некоторых темах высокой контрастности отображаются в правильном цвете. Это изменение можно отключить, удалив следующий параметр из файлаsvcTraceViewer.exe.config :

<AppContextSwitchOverrides value="Switch.UseLegacyAccessibilityFeatures=false;Switch.UseLegacyAccessibilityFeatures.2=false" />

Использование средства просмотра трассировки службы

Открытие и просмотр файлов трассировки WCF

Средство просмотра трассировки службы поддерживает три типа файлов:

• Файл трассировки WCF (.svcLog)

• Файл трассировки событий (ETL)

• Файл трассировки Crimson

Средство просмотра трассировки службы позволяет открывать любой поддерживаемый файл трассировки, добавлять и интегрировать дополнительные файлы трассировки или одновременно открывать и объединять группу файлов трассировки.

Чтобы открыть файл трассировки

1. Запустите средство просмотра трассировки службы с помощью командного окна, чтобы перейти к расположению установки WCF (C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin), а затем введите SvcTraceViewer.exe.

Замечание

Средство просмотра трассировки службы может связаться с двумя типами файлов: SVCLOG и STVPROJ. Для регистрации и отмены регистрации расширений файлов можно использовать два параметра в командной строке.

/register: регистрация сопоставления расширений файлов .svclog и .stvproj с помощью SvcTraceViewer.exe

/unregister: отмените регистрацию сопоставления расширений файлов .svclog и .stvproj с SvcTraceViewer.exe

1. При запуске средства "Просмотр трассировки службы" нажмите "Файл" и наведите указатель на "Открыть". Перейдите в папку, где хранятся ваши файлы трассировки.

2. Дважды щелкните файл отслеживания, который требуется открыть.

   Замечание

   Удерживайте клавишу SHIFT и щелкните по нескольким файлам трассировки, чтобы выбрать и открыть их одновременно. Средство просмотра трассировки службы объединяет содержимое всех файлов в единое представление. Например, можно открыть файлы трассировки как клиента, так и службы. Это полезно, если вы включили ведение журнала сообщений и распространение действий в конфигурации. Таким образом, можно изучить обмен сообщениями между клиентом и службой. Вы также можете перетащить несколько файлов в средство просмотра или использовать вкладку "Проект ". Дополнительные сведения см. в разделе "Управление проектом".

3. Чтобы добавить дополнительные файлы трассировки в открытую коллекцию, нажмите кнопку "Файл " и выберите пункт "Добавить". В открывшемся окне откройте расположение файлов трассировки и дважды щелкните по файлу, который хотите добавить.

Осторожность

Не рекомендуется загружать файл журнала трассировки больше 200 МБ. Если вы пытаетесь загрузить файл, превышающий это ограничение, процесс загрузки может занять много времени в зависимости от ресурса компьютера. Средство просмотра трассировки служб может не реагировать на длительный период времени или может исчерпать память компьютера. Рекомендуется настроить частичную загрузку, чтобы избежать этого. Дополнительные сведения о том, как это сделать, см. в разделе "Загрузка больших файлов трассировки".

Трассировка событий и Crimson-трассировка

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

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

Замечание

Для преобразования требуется место на диске для хранения преобразованных данных трассировки. Перед началом преобразования убедитесь, что у вас достаточно места на диске. В противном случае преобразование завершается ошибкой.

Управление проектами

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

Существует два способа управления проектами:

• В меню "Файл" можно открыть, сохранить и закрыть проекты.

• На вкладке "Проект" можно добавить файлы в проект.

Просмотр трассировок WCF

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

Переключение на разные представления

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

• Обзор активности

• Вид проекта

• Представление сообщения

• Вид графа

Отображение активности

После открытия файлов трассировки вы можете увидеть трассировки, сгруппированные по видам деятельности и отображаемые в области слева в представлении действий.

В представлении действия отображаются имена действий, количество трассировок в действии, время длительности, время начала и время окончания.

Нажав на любую из перечисленных активностей, трассировки для этой активности отображаются в области трассировки справа. Затем можно выбрать трассировку для просмотра сведений.

Можно выбрать несколько действий, нажав клавиши CTRL или SHIFT и щелкнув нужные действия. На панели отслеживания отображаются все следы выбранных действий.

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

Замечание

Действие "000000000000000" — это специальное действие, которое невозможно отобразить в представлении графа. Так как все остальные действия связаны с ним, отображение этого действия оказывает серьезное влияние на производительность.

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

Существуют различные типы действий, и каждый тип соответствует значку в левой части каждого действия. Вы можете обратиться к разделу "Значки трассировки" для их смысла.

Вид проекта

Это представление позволяет управлять файлами трассировки в текущем проекте. Дополнительные сведения см. в разделе "Управление проектом".

Представление сообщения

Это представление позволяет просматривать все трассировки журнала сообщений, включая Действие, Дату/Время, Процесс, Активность и Отправитель/Получатель, а также перейти к сведениям о связанной трассировке журнала сообщений. Вы можете сгруппировать трассировки журнала сообщений по границам действия, процессу или потоку или отправке и получению для упрощения навигации потока сообщений.

Вид графа

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

Чтобы переключиться на представление Graph, выберите элемент в представлении Activity и нажмите вкладку Activity, или выберите трассировку журнала сообщений в представлении Message. Если загружается несколько файлов трассировки и действие включает трассировки из нескольких файлов, все соответствующие трассировки отображаются в представлении графа. Дважды щелкнув по действиям и трассировкам журнала сообщений, вы также перейдете к представлению Graph.

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

Выбор следов в графе

1. Щелкните блок в графе.

2. Используйте клавиши вверх и вниз, чтобы выбрать соседние следы.

3. Просмотрите сведения о трассировке в панели трассировки и панели сведений.

Развертывание или свертывание перепередачи действий

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

Чтобы развернуть или свернуть передачу действий, выполните

1. Найдите трассировку передачи со знаком "+" слева от значка передачи.

2. Щелкните "+" или нажмите клавиши CTRL и "+" с помощью клавиатуры.

3. Следующее действие отображается в графе.

4. Знак "-" отображается слева от значка передачи. Щелкните знак "-" или нажмите клавиши Ctrl и "-", чтобы свернуть передачу активности.

Замечание

Когда действие имеет несколько перемещений в него и вы развертываете одно из перемещений, отображаются действия, которые ведут к новому действию из начального действия. Эти новые действия отображаются в свернутой форме. Если вы хотите просмотреть сведения об этих действиях, разверните их по вертикали, щелкнув значок развертывания в заголовке графа.

Развертывание или свертывание деятельности по вертикали

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

Чтобы развернуть или свернуть действия по вертикали,

1. Щелкните значок "+" в заголовке действия, чтобы развернуть действие по вертикали.

2. Обратите внимание, что все трассировки отображаются в графе.

3. Щелкните значок "-" в заголовке действия, чтобы свернуть действие по вертикали.

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

Опции

В режиме графического отображения можно выбрать две опции из меню Опции.

• Показывать трассировки границ активности, которые при снятии галочки игнорируют трассировки границ активности в графике.

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

Режим макета

Средство просмотра имеет два режима макета: процесс и поток. Этот параметр определяет самую большую единицу организации. Режим макета по умолчанию — "Процесс", то есть действия группируются по процессам в графе.

Список выполнения задач

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

Просмотр сведений о трассировке

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

Область трассировки

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

Вы можете скопировать необработанный XML-код трассировки в буфер обмена, щелкнув правой кнопкой мыши трассировку и выбрав "Копировать трассировку в буфер обмена".

Панель «Подробности»

В нижней левой панели средства просмотра трассировки службы находится панель сведений. Эта функция предоставляет три вкладки для просмотра сведений трассировки.

Форматируемое представление отображает информацию более упорядоченным способом. В нем перечислены все известные XML-элементы в таблицах и деревьях, что упрощает чтение и понимание информации.

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

В представлении сообщений отображается часть сообщения XML в трассировках журнала сообщений. Это не отображается при выборе трассировки, которая не является сообщением.

Фильтрация трассировок WCF

Чтобы упростить анализ трассировки, их можно фильтровать следующим образом:

• Панель инструментов фильтра предоставляет доступ к предварительно определенным и пользовательским фильтрам. Его можно включить в меню "Вид ".

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

• Пользовательские фильтры XPath предоставляют пользователям полный контроль над фильтрацией. Их можно определить в меню "Настраиваемый фильтр " в меню "Вид ".

Отображаются только трассировки, проходящие через все фильтры.

Использование панели инструментов фильтра

Панель инструментов фильтра отображается в верхней части средства. Если он отсутствует, его можно активировать в меню "Вид ". В баре три компонента:

• Искать: определяет объект для поиска в операции фильтрации. Например, если вы хотите найти все трассировки, которые были эмитированы в контексте процесса X, задайте для этого поля значение X, а поле «Поиск в» — «Имя процесса». Это поле превращается в элемент управления селектором даты и времени при выборе фильтра, основанного на времени.

• Поиск в: это поле определяет тип фильтра для применения.

• Уровень: параметр уровня определяет минимальный уровень трассировки, разрешенный фильтром. Например, если для уровня задано значение Error и Up, отображаются только трассировки на уровне ошибки и критического уровня. Этот фильтр используется с критериями, заданными в Искать и Искать в.

Кнопка "Фильтр теперь " запускает операцию фильтра. Для выполнения некоторых фильтров, особенно при применении к большому набору данных, потребуется много времени. Вы можете отменить операцию фильтра, нажав кнопку "Остановить ", которая отображается в строке состояния в меню "Операции ".

Кнопка «Очистить» сбрасывает предварительно определенные и настраиваемые фильтры, чтобы все данные могли проходить.

Параметры фильтра

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

Настройки этого фильтра задаются в подменю Параметры фильтра в меню Вид.

Пользовательские фильтры

Если вы знакомы с языком XML-пути (XPath), его можно использовать для создания пользовательских фильтров для поиска данных трассировки для любого интересующего XML-элемента. Фильтры доступны с помощью панели инструментов фильтра.

Пользовательские фильтры могут включать параметры. Вы также можете импортировать уже существующие пользовательские фильтры.

Создание настраиваемого фильтра

Фильтры можно создать двумя способами:

Создание настраиваемого фильтра с помощью мастера шаблонов

Вы можете щелкнуть по существующему следу и создать фильтр на основе структуры следа. В этом примере создается пользовательский фильтр на основе идентификатора потока.

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

2. Нажмите кнопку "Создать настраиваемый фильтр" , расположенную в верхней части области трассировки.

3. В появившемся диалоговом окне введите имя фильтра. В этом примере введите Thread ID. Вы также можете указать описание фильтра.

4. В представлении дерева слева отображается структура записи трассировки, выбранной на шаге 1. Перейдите к элементу, для которого нужно создать условие. В этом примере перейдите к ThreadID, который должен находиться в узле XPath: /E2ETraceEvent/System/Execution/@ThreadID. Дважды щелкните атрибут ThreadID в представлении дерева. Это создает выражение для атрибута справа от диалогового окна.

5. Измените поле параметра для условия ThreadID с None на "{0}". Этот шаг позволяет настроить значение ThreadID при применении фильтра. (См. раздел "Применение фильтра") Можно определить до четырех параметров. Условия объединяются с помощью оператора ИЛИ.

6. Нажмите кнопку "ОК ", чтобы создать фильтр.

Замечание

После создания фильтра с помощью мастера шаблонов его можно изменить только вручную. Невозможно активировать мастер для созданного ранее фильтра. Кроме того, условия фильтра XPath, созданного в мастере шаблонов, объединяются с помощью оператора OR. Если требуется операция AND, можно изменить выражение фильтра после его создания.

Создание настраиваемого фильтра вручную

Меню "Пользовательские фильтры" позволяет вручную вводить фильтры XPath.

1. В меню "Вид" выберите пункт меню "Настраиваемые фильтры ".

2. В появившемся диалоговом окне нажмите кнопку "Создать".

3. По крайней мере укажите имя фильтра и выражение XPath.

4. Нажмите кнопку ОК.

Применение пользовательского фильтра

После создания пользовательского фильтра он доступен на панели инструментов фильтра. Выберите фильтр, который нужно применить в поле "Поиск в " панели инструментов фильтра. В предыдущем примере выберите "Идентификатор потока".

1. Укажите значение, которое вы ищете в поле "Найти что ". В нашем примере введите идентификатор потока, который вы хотите найти.

2. Нажмите кнопку "Фильтр сейчас" и просмотрите результат операции.

Если фильтр использует несколько параметров, введите их с помощью ";" в качестве разделителя в поле "Найти что ". Например, следующая строка определяет 3 параметра: '1; findValue; text'. Средство просмотра применяет значение "1" к {0} параметру фильтра. "findValue" и "text" применяются к {1} и {2} соответственно.

Общий доступ к пользовательским фильтрам

Пользовательские фильтры можно совместно использовать между различными сеансами и разными пользователями. Фильтры можно экспортировать в файл настроек и импортировать его в другое место.

Чтобы импортировать пользовательский фильтр, выполните приведенные далее действия.

1. В меню "Вид " щелкните "Настраиваемые фильтры".

2. В открывшемся диалоговом окне нажмите кнопку "Импорт ".

3. Перейдите к пользовательскому файлу фильтра (STVCF), щелкните файл и нажмите кнопку "Открыть ".

Экспорт настраиваемого фильтра:

1. В меню "Вид" щелкните "Настраиваемые фильтры".

2. В открывшемся диалоговом окне выберите фильтр, который требуется экспортировать.

3. Нажмите кнопку "Экспорт ".

4. Укажите имя и расположение файла определения пользовательского фильтра (STVCF) и нажмите кнопку "Сохранить ".

Замечание

Эти пользовательские фильтры можно импортировать и экспортировать только из "Service Trace Viewer". Они не могут быть прочитаны другими инструментами.

Поиск данных

Средство просмотра предоставляет следующие способы поиска данных:

• Панель инструментов поиска предоставляет быстрый доступ к наиболее распространенным параметрам поиска.

• Диалоговое окно "Поиск" предоставляет дополнительные параметры поиска. Он доступен в меню "Изменить " или с помощью короткого клавиши CTRL+F.

Панель инструментов поиска отображается в верхней части средства просмотра. Если он отсутствует, его можно активировать в меню "Вид ". У полосы есть два компонента:

• Найти что: позволяет ввести ключевое слово поиска.

• Поле "Где искать": позволяет выбрать область поиска. Вы можете выбрать, следует ли выполнять поиск во всех действиях или только в текущем действии.

Диалоговое окно поиска предоставляет два дополнительных варианта:

• Найдите целевой объект:

  • Параметр "Необработанные данные журнала" выполняет поиск ключевого слова во всех необработанных данных.

  • Параметры "XML-текст" и "АТРИБУТ XML" выполняют поиск только в XML-элементах.

  • Параметр "Зарегистрированное сообщение" выполняет поиск ключевого слова только в сообщениях.

• Игнорировать корневую активность: поиск игнорирует трассировки в активности "000000000000". Это улучшает производительность в больших файлах трассировки, когда корневое действие содержит тысячи трассировок, и большинство из них являются передачами.

Навигация по трассам

Поскольку трассировки записываются пошагово во время выполнения приложения, навигация по ним может помочь в отладке приложения. Средство просмотра трассировки службы предоставляет различные способы навигации по трассировкам.

Шаг вперед или назад

Если вы рассматриваете каждую трассировку как строку кода в программе, шаг вперед очень похож на шаг вперед в интегрированной среде разработки Visual Studio (IDE). Разница заключается в том, что вы также можете выполнить шаг назад в трассировках. Шаг вперед означает переход к следующему этапу в процессе.

• Шаг вперед: используйте меню действий или нажмите клавишу F10. Кроме того, в области трассировки можно использовать клавишу со стрелкой вниз.

• Шаг назад: используйте меню действий или нажмите клавишу F9. Кроме того, в области трассировки можно использовать клавишу со стрелкой вверх.

Замечание

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

Следуйте передаче

Трассировки передачи — это специальные трассировки в файле трассировки. Передача действия в другое действие может осуществляться посредством следа передачи. Например, "Действие А" может переходить в "Действие B". В таком случае имеется трассировка передачи в "Действии A" с именем "To: Activity" и значком передачи. Этот след передачи является связующим звеном между двумя следами. В действии B также может быть трассировка передачи в конце действия, чтобы вернуться в действие A. Это похоже на вызовы функций в программах: A вызывает B, а затем B возвращается.

"Следовать передаче" аналогично "Шаг в" в отладчике. Он следует за передачей из A в B. Он не влияет на другие трассировки.

Можно выполнить передачу двумя способами: мышью или клавиатурой:

• По мыши: дважды щелкните трассировку передачи в области трассировки.

• Клавиатура: выберите трассировку передачи и используйте "Следить за передачей" в меню Активность, или нажмите клавишу "F11".

Замечание

Во многих случаях, когда действие A передается в действие B, действие A ожидает, пока действие B не передаст управление обратно в действие A. Это означает, что действие A не регистрирует трассировку в течение периода, когда действие B активно ведет трассировку. Однако возможно, что действие А не будет ожидать и продолжит записывать логи. Также возможно, что действие B не возвращается в действие A. Поэтому передача действий по-прежнему отличается от вызовов функций в этом смысле. Вы можете лучше понять передачу действий в графическом представлении.

Переход к следующей или предыдущей передаче

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

• Переход к следующей передаче: используйте меню действий или нажмите клавиши CTRL+F10.

• Переход к предыдущей передаче: используйте меню действий или нажмите клавиши CTRL+F9.

Навигация в режиме графа

Несмотря на то, что навигация в области действий и области трассировки аналогична отладке, использование представления Graph обеспечивает гораздо лучший интерфейс навигации. Подробная информация в разделе "Просмотр графика".

Загрузка больших файлов трассировки

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

При открытии очень большого файла трассировки в средстве просмотра трассировки службы производительность системы может ухудшиться. Скорость загрузки и время отклика после загрузки могут быть медленными. Фактическая скорость время от времени различается в зависимости от конфигурации вашего оборудования. На большинстве компьютеров загрузка файла трассировки, размером более 200 МБ, серьёзно сказывается на производительности. Для файлов трассировки, превышающих 1G, средство может использовать всю доступную память или перестать отвечать на запросы в течение очень длительного времени.

Чтобы избежать медленной загрузки и отклика при анализе больших файлов трассировки, средство просмотра трассировки службы предоставляет функцию с именем "Частичная загрузка", которая загружает только небольшую часть трассировки за раз. Например, у вас может быть файл трассировки более 1 ГБ, работающий в течение нескольких дней на сервере. Если произошли некоторые ошибки и вы хотите проанализировать трассировку, не нужно открывать весь файл трассировки. Вместо этого можно загрузить трассировки за определенный период времени, в который могла произойти ошибка. Так как область меньше, средство просмотра трассировки службы может быстрее загрузить файл, и вы можете определить ошибки с помощью меньшего набора данных.

Включение частичной загрузки

Не требуется вручную включить частичную загрузку. Если общий размер файлов трассировки, которые вы пытаетесь загрузить, превышает 40 МБ, средство просмотра трассировки служб автоматически отображает диалоговое окно частичной загрузки, чтобы выбрать часть, которую требуется загрузить.

Замечание

Поскольку трассировки могут распределяться неравномерно в течение времени, длина периода времени, указанная на панели инструментов частичной загрузки, может не быть пропорциональной отображенному размеру загрузки. Фактический размер загрузки может быть меньше предполагаемого размера в диалоговом окне частичной загрузки.

Настройка частичной загрузки

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

1. Переместите панель инструментов по мыши или введите время начала и окончания.

2. Нажмите кнопку "Изменить ".

Общие сведения о значках трассировки

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

Замечание

Некоторые трассировки, которые не классифицируются (например, "сообщение закрыто") не имеют значка.

Трассировки действий

Иконка	Описание
	Трассировка предупреждения: трассировка, которая создается на уровне предупреждения
	Трассировка ошибок: трассировка, которая создается на уровне ошибки.
	Трассировка запуска действия: трассировка, которая помечает начало действия. Она содержит название активности. В качестве конструктора приложений или разработчика следует определить одну трассировку действия Start на идентификатор действия для каждого процесса или потока. Если идентификатор активности передается между источниками трассировки для их корреляции, можно заметить несколько запусков с одинаковым идентификатором активности (по одному на источник трассировки). Трассировка "Start" создается, если "ActivityTracing" включен для источника трассировки.
	Трассировка остановки действия: трассировка, которая помечает конец действия. . Она содержит название активности. В качестве конструктора приложений или разработчика следует определить одну трассировку остановки действия для каждого идентификатора действия для каждого источника трассировки. Трассировки из заданного источника трассировки не отображаются после остановки действия, созданного этим источником трассировки, за исключением случаев, если степень детализации времени трассировки недостаточно мала. В этом случае при отображении две трассировки с одинаковым временем, включая остановку, могут быть переплетены. Если идентификатор активности распространяется между источниками трассировки для корреляции трассировки, можно увидеть несколько остановок для одного и того же идентификатора активности (по одному на каждый источник трассировки). Останавливающаяся трассировка испускается, если ActivityTracing включен для источника трассировки.
	Трассировка приостановки действия: помечает время, когда действие приостановлено. Трассировки не создаются в приостановленном действии, пока действие не возобновляется. Приостановленное действие указывает на то, что обработка не выполняется в этом действии в контексте источника трассировки. Трассировки приостановки и возобновления полезны для профилирования. Трассировка приостановки генерируется, если для источника трассировки включено ActivityTracing.
	Трассировка возобновления активности: трассировка, которая фиксирует время возобновления активности после её приостановки. Трассировки могут снова генерироваться в этой активности. Трассировки приостановки и возобновления полезны для профилирования. Трассировка возобновления выдается, если ActivityTracing включен для источника трассировки.
	Передача: трассировка, которая создается при передаче логического потока управления из одного действия в другую. Действие, от которого происходит передача, может продолжать выполняться параллельно с действием, в которое передается передача. Трассировка передачи создается, если ActivityTracing включен для источника трассировки.
	Передача из: след, который определяет передачу из другой активности в текущую активность.
	Передача в: трассировка, которая определяет передачу потока логического управления из текущего действия в другое действие.

Трассировки WCF

Иконка	Описание
	Трассировка журнала сообщений: трассировка, которая создается, когда сообщение WCF регистрируется функцией ведения журнала сообщений, если источник трассировки System.ServiceModel.MessageLogging включен. При щелчке на этот след отображается сообщение. Существует четыре настраиваемые точки ведения журнала для сообщения: ServiceLevelSendRequest, TransportSend, TransportReceive и ServiceLevelReceiveRequest, которые также можно указать атрибутом messageSource в трассировке журнала сообщений.
	Полученная трассировка сообщения: трассировка, которая создается при получении сообщения WCF, если System.ServiceModel источник трассировки включен на уровне сведений или подробных сведений. Эта трассировка необходима для отображения стрелки корреляции сообщения в разделе Граф действий.
	Трассировка отправки сообщения: трассировка, которая создается при отправке сообщения WCF, если System.ServiceModel источник трассировки включен на уровне сведений или подробных сведений. Эта трассировка необходима для отображения стрелки корреляции сообщения в разделе Граф действий.

Мероприятия

Иконка	Описание
	Действие. Указывает, что текущее действие является универсальным.
	Корневое действие: указывает корневое действие процесса.

Действия WCF

Иконка	Описание
	Действие среды: действие, которое создает, открывает или закрывает хост WCF или клиент. Ошибки, которые произошли на этих этапах, будут отображаться в этом действии.
	Действие прослушивания: действие, которое регистрирует отслеживания, связанные со слушателем. В этом мероприятии мы можем просматривать информацию о слушателях и запросы на подключение.
	Действие получения байтов: действие, которое группирует все трассировки, связанные с получением входящих байтов в соединении между двумя конечными точками. Эта деятельность важна для сопоставления с транспортными действиями, которые распространяют свой идентификатор активности, например http.sys. Ошибки подключения, такие как прерывания, будут отображаться в этом действии.
	Действие по обработке сообщений: действие, которое группирует трассировки, связанные с созданием WCF сообщения. Ошибки из-за плохого конверта или неправильно сформированного сообщения будут отображаться в этом действии. В этом действии можно проверить заголовки сообщений, чтобы узнать, был ли идентификатор действия передан от вызывающего. Если это верно, при переходе к активности действия процесса (следующий значок) можно также назначить этой активности распространяемый идентификатор активности для корреляции между трассировками вызывающего и вызываемого.
	Процесс действия: действие, которое группирует все трассировки, связанные с запросом WCF между двумя конечными точками. Если propagateActivity установлено значение true для обоих конечных точек в конфигурации, все трассировки из обеих конечных точек объединяются в одно действие для прямой корреляции. Такая деятельность будет содержать ошибки из-за обработки транспортировки данных или мер безопасности, доходя до границы кода пользователя и обратно (если существует ответ).
	Активность выполнения пользовательского кода: активность, которая группирует трассировки пользовательского кода для обработки запроса.

Устранение неполадок

Если у вас нет разрешения на запись в реестр, вы получите следующее сообщение об ошибке "Средство просмотра трассировки службы Майкрософт не зарегистрировано в системе" при использовании команды "svctraceviewer /register" для регистрации средства. В этом случае необходимо войти с помощью учетной записи с доступом на запись в реестр.

Кроме того, средство просмотра трассировки службы записывает некоторые параметры (например, настраиваемые фильтры и параметры фильтра) в файл SvcTraceViewer.exe.settings в папке сборки. Если у вас нет разрешения на чтение для файла, вы по-прежнему можете запустить средство, но вы не сможете загрузить параметры.

Если при открытии ETL-файла появится сообщение об ошибке "Неизвестная ошибка при обработке одной или нескольких трассировок", это означает, что недопустимый формат файла ETL.

Если открыть журнал трассировки, созданный с помощью арабской операционной системы, вы можете заметить, что фильтр времени не работает. Например, год 2005 соответствует 1427 году в арабском календаре. Однако диапазон времени, поддерживаемый фильтром средства просмотра трассировки служб, не поддерживает дату до 1752 года. Это может означать, что вы не можете выбрать правильную дату в фильтре. Чтобы устранить эту проблему, можно создать пользовательский фильтр (просмотр и настраиваемые фильтры) с помощью выражения XPath для включения определенного диапазона времени.

См. также

• Использование программы просмотра трассировки службы для просмотра коррелированных трассировок и устранения неполадок
• Настройка трассировки
• Сквозная трассировка