Программа Service Trace Viewer (SvcTraceViewer.exe)Service Trace Viewer Tool (SvcTraceViewer.exe)

Средство просмотра трассировки службы Windows Communication Foundation (WCF) помогает анализировать диагностические трассировки, созданные WCF.Windows Communication Foundation (WCF) Service Trace Viewer Tool helps you analyze diagnostic traces that are generated by WCF. Средство Service Trace Viewer позволяет легко выполнять слияние, просмотр и фильтрацию сообщений трассировки в журнале, чтобы можно было диагностировать, восстанавливать и проверять проблемы служб WCF.Service Trace Viewer provides a way to easily merge, view, and filter trace messages in the log so that you can diagnose, repair, and verify WCF service issues.

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

Диагностические трассировки предоставляют информацию о том, что происходит на всем протяжении работы приложения.Diagnostic traces provide you with information that shows what is happening throughout your application's operation. Как следует из названия, можно проследить операции от их источника до назначения, а также выяснить, что происходило в промежуточных точках.As the name implies, you can follow operations from their source to destination and through intermediate points as well.

Вы можете настроить трассировку с помощью файла конфигурации приложения (Web. config для веб-приложений или имя_приложения. config для собственных приложений).You can configure tracing using the application’s configuration file—either Web.config for Web-hosted applications, or Appname.config for self-hosted applications. Ниже представлен пример такого кода.The following is an example:

<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>

В этом примере указываются имя и тип прослушивателя трассировки.In this example, the name and type of the trace listener is specified. Прослушиватель имеет имя sdt, а в качестве типа добавляется стандартный прослушиватель трассировки .NET Framework (System.Diagnostics.XmlWriterTraceListener).The Listener is named sdt and the standard .NET Framework trace listener (System.Diagnostics.XmlWriterTraceListener) is added as the type. Атрибут initializeData используется для задания имени файла журнала для этого прослушивателя SdrConfigExample.e2e.The initializeData attribute is used to set the name of the log file for that Listener to be SdrConfigExample.e2e. Для файла журнала можно заменить полный путь на простое имя файла.For the log file, you can substitute a fully-qualified path for a simple file name.

В этом примере в корневом каталоге создается файл с именем SdrConfigExample.e2e.The example creates a file in the root directory called SdrConfigExample.e2e. При использовании средства просмотра трассировки для открытия файла, как описано в разделе "Открытие и просмотр файлов трассировки WCF", можно просмотреть все отправленные сообщения.When you use the Trace Viewer to open the file as described in the "Opening and Viewing WCF Trace Files" section, you can see all the messages that have been sent.

Уровень трассировки контролируется параметром switchValue.The tracing level is controlled by the switchValue setting. Доступные уровни трассировки приведены в следующей таблице.The available tracing levels are described in the following table.

Уровень трассировкиTrace Level ОписаниеDescription
Критические важноеCritical — Записывает в журнал ошибки быстрого входа и записи журнала событий, а затем данные корреляции трассировки.- Logs Fail-Fast and Event Log entries, and trace correlation information. Ниже приводится несколько примеров ситуаций, в которых может потребоваться использовать уровень Critical.The following are some examples of when you might use the Critical level:
— Ваш AppDomain вышел из-за необработанного исключения.- Your AppDomain went down because of an unhandled exception.
— Не удается запустить приложение.- Your application fails to start.
— Сообщение, вызвавшее сбой, получено от процесса MyApp. exe.- The message that caused the failure originated from the process MyApp.exe.
ErrorError — Записывает все исключения.- Logs all exceptions. Уровень Error можно использовать в следующих ситуациях.You can use the Error level in the following situations:
— Ваш код был аварийно завершен из-за исключения недопустимого приведения.- Your code crashed because of an Invalid Cast Exception.
— Исключение "не удалось создать конечную точку" вызывает сбой приложения при запуске.- A "failed to create endpoint" exception is causing your application to fail on startup.
ПредупреждениеWarning — Существует условие, которое может впоследствии привести к ошибке или критическому сбою.- A condition exists that may subsequently result in an error or critical failure. Этот уровень можно использовать в следующих ситуациях.You can use this level in the following situations:
— Приложение получает больше запросов, чем разрешает его параметры регулирования.- The application is receiving more requests than its throttling settings allows.
— Принимающая очередь находится на 98 процентов от своей заданной емкости.- The receiving queue is at 98 percent of its configured capacity.
СведенияInformation — Сообщения, полезные для мониторинга и диагностики состояния системы, измерения производительности или профилирования.- Messages helpful for monitoring and diagnosing system status, measuring performance, or profiling are generated. Эту информацию можно использовать для планирования загрузки и управления производительностью.You can utilize such information for capacity planning and performance management. Этот уровень можно использовать в следующих ситуациях.You can use this level in the following situations:
— Произошла ошибка после того, как сообщение достигло домена приложения и было десериализовано.- A failure occurred after the message reached the AppDomain and was deserialized.
-Во время создания привязки HTTP произошла ошибка.- A failure occurred while the HTTP binding was being created.
ПодробныйVerbose — Трассировка на уровне отладки для пользовательского кода и обслуживания.- Debug-level tracing for both user code and servicing. Этот уровень используется в следующих ситуациях.Set this level when:
— Вы не уверены, какой метод в коде был вызван при возникновении ошибки.- You are not sure which method in your code was called when the failure occurred.
-У вас настроена неправильная конечная точка, и не удалось запустить службу, так как запись в хранилище резервирования заблокирована.- You have an incorrect endpoint configured and the service failed to start because the entry in the reservation store is locked.
ActivityTracingActivityTracing События переходов между действиями по обработке и компонентами.Flow events between processing activities and components.

Этот уровень позволяет администраторам и разработчикам коррелировать приложения из одного домена приложений.This level allows administrators and developers to correlate applications in the same application domain.

— Трассировка для границ действий: запуск и завершение.- Traces for activity boundaries: start/stop.
— Трассировки для передачи.- Traces for transfers.

С помощью add можно задать имя и тип прослушивателя трассировки, который требуется использовать.You can use add to specify the name and type of the trace listener you want to use. В примере конфигурации прослушиватель имеет имя sdt, а в качестве типа добавляется стандартный прослушиватель трассировки .NET Framework (System.Diagnostics.XmlWriterTraceListener).In the example configuration, the Listener is named sdt and the standard .NET Framework trace listener (System.Diagnostics.XmlWriterTraceListener) is added as the type. Чтобы задать имя файла журнала для этого прослушивателя, используйте initializeData.Use initializeData to set the name of the log file for that Listener. Кроме того, можно заменить простое имя файла полным путем.In addition, you can substitute a fully-qualified path for a simple file name.

Начиная с .NET Framework 4,8, элементы управления ComboBox в некоторых темах с высокой контрастностью отображаются в правильном цвете.Starting in .NET Framework 4.8, ComboBox controls in some high contrast themes are displayed in the correct color. Вы можете отключить это изменение, удалив следующий параметр из файла svcTraceViewer. exe. config :You can disable this change by removing the following setting from the svcTraceViewer.exe.config file:

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

Использование программы Service Trace ViewerUsing the Service Trace Viewer Tool

Открытие и просмотр файлов трассировки WCFOpening and Viewing WCF Trace Files

Программа Service Trace Viewer поддерживает три типа файлов:The Service Trace Viewer supports three file types:

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

  • Файлы трассировки событий (ETL)Event Tracing File (.etl)

  • Файлы трассировки CrimsonCrimson Tracing File

Программа Service Trace Viewer позволяет открыть любой поддерживаемый файл трассировки, добавить или интегрировать дополнительные файлы трассировки, а также открыть и выполнить одновременное слияние группы файлов трассировки.Service Trace Viewer enables you to open any supported trace file, add and integrate additional trace files, or open and merge a group of trace files simultaneously.

Открытие файла трассировкиTo open a trace file
  1. Запустите средство Service Trace Viewer, используя командное окно, чтобы перейти к расположению установки WCF (C:\Program Files\Microsoft Sdks\windows\v6.0\Bin.), а затем введите SvcTraceViewer.exe.Start Service Trace Viewer by using a command window to navigate to your WCF installation location (C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin), and then type SvcTraceViewer.exe.

Примечание

Программу Service Trace Viewer можно ассоциировать с двумя типами файлов: SVCLOG и STVPROJ.The Service Trace Viewer tool can associate with two file types: .svclog and .stvproj. С помощью двух параметров в командной строке можно регистрировать и отменять регистрацию расширений файлов.You can use two parameters in command line to register and unregister the file extensions.

/register: зарегистрировать связь расширений файлов "SVCLOG" и "STVPROJ" с программой SvcTraceViewer.exe./register: register the association of file extensions ".svclog" and ".stvproj" with SvcTraceViewer.exe

/unregister: отменить регистрацию связи расширений файлов "SVCLOG" и "STVPROJ" с программой SvcTraceViewer.exe./unregister: unregister the association of file extensions ".svclog" and ".stvproj" with SvcTraceViewer.exe

  1. Когда программа Service Trace Viewer запускается, в меню файл выберите пункт Открыть.When Service Trace Viewer starts, click File and then point to Open. Перейдите в папку, где находятся файлы трассировки.Navigate to the location where your trace files are stored.

  2. Дважды щелкните имя файла трассировки, который требуется открыть.Double-click the trace file that you want to open.

    Примечание

    Щелкните несколько файлов трассировки, удерживая нажатой клавишу SHIFT, и откройте их одновременно.Press SHIFT while clicking multiple trace files to select and open them simultaneously. Service Trace Viewer производит слияние содержимого всех файлов и отображает данные в одном представлении.Service Trace Viewer merges the content of all files and presents one view. Например, можно открыть файлы трассировки как для клиента, так и для службы.For example, you can open trace files of both client and service. Это удобно, если в конфигурации включено ведение журнала сообщений и распространение действий.This is useful when you have enabled message logging and activity propagation in configuration. Таким образом, можно проверить обмен сообщениями между клиентом и службой.In this way, you can examine message exchange between client and service. Можно также перетащить несколько файлов в средство просмотра или использовать вкладку Project ( проект ). Дополнительные сведения см. в разделе "Управление проектом".You can also drag multiple files into the viewer, or use the Project tab. See the Managing Project section for more details.

  3. Чтобы добавить дополнительные файлы трассировки в открытую коллекцию, в меню файл выберите пункт Добавить.To add additional trace files to the collection that is open, click File and then point to Add. В открывшемся окне перейдите в расположение файлов трассировки и дважды щелкните левой кнопкой мыши файл, который нужно добавить.In the window that opens, navigate to the location of the trace files and double-click the file you want to add.

Внимание!

Не рекомендуется загружать файлы журнала трассировки размером более 200 МБ.It is not recommended that you load a trace log file bigger than 200MB. Загрузка файла, размер которого превышает указанное значение, может занять длительное время в зависимости от ресурсов компьютера.If you attempt to load a file larger than this limit, the loading process may take a long time, depending on your computer resource. Программа Service Trace Viewer может не отвечать в течение длительного времени или исчерпать память компьютера.The Service Trace Viewer tool may not be responsive for a long time, or it may exhaust your machine's memory. Во избежание этого рекомендуется настроить частичную загрузку.It is recommended that you configure partial loading to avoid this. Дополнительные сведения см. в разделе "Загрузка больших файлов трассировки".For more information on how to do this, see "Loading Large Trace Files" section.

Трассировка событий и трассировка CrimsonEvent Tracing and Crimson Tracing

Собственный формат средства просмотра — это формат трассировки действий, выдаваемый WCF.The viewer’s native format is the activity tracing format that WCF emits. Трассировки, создаваемые в различных форматах, должны конвертироваться перед их отображением в средстве просмотра.Traces emitted in a different format must be converted before the viewer displays them. На данный момент кроме формата трассировки действий средство просмотра поддерживает трассировку событий и трассировку Crimson.Currently, in addition to the activity tracing format, the viewer supports event tracing and crimson tracing.

При открытии файла, не содержащего трассировок действий, средство просмотра пытается преобразовать файл.When you open a file that does not contain activity traces, the viewer attempts to convert the file. Необходимо указать имя и расположение файла, который будет содержать преобразованные данные трассировки.You must specify the name and location of the file that will contain the converted trace data. После преобразования данных средство просмотра отображает содержимое в новом файле.Once the data has been converted, the viewer displays the content of the new file.

Примечание

Для сохранения преобразованных данных трассировки требуется свободное пространство на диске.Conversion requires disk space to store the converted trace data. Перед запуском преобразования убедитесь, что на диске достаточно свободного пространства для сохранения данных.Make sure you have enough disk space available to store the data before you start a conversion. В противном случае преобразование не будет выполнено.Otherwise, the conversion fails.

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

Средство просмотра поддерживает проекты, что позволяет просматривать несколько файлов трассировки одновременно.The viewer supports projects to facilitate viewing multiple trace files. Например, если имеется файл трассировки клиента и файл трассировки службы, их можно добавить в проект.For example, if you have a client trace file and a service trace file, you can add them to a project. После этого при каждом открытии проекта все файлы трассировки проекта будут загружаться одновременно.Then, every time you open the project, all the trace files in the project are loaded simultaneously.

Существует два способа управления проектами.There are two ways to manage projects:

  • В меню файл можно открывать, сохранять и закрывать проекты.In the File menu, you can open, save and close projects.

  • На вкладке проект можно добавить файлы в проект.In the Project tab, you can add files to a project.

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

WCF выдает трассировки, используя формат трассировки действий.WCF emits traces using the activity tracing format. В модели трассировки действий отдельные трассировки группируются в действиях в соответствии со своим назначением.In the activity tracing model, individual traces are grouped in activities according to their purpose. Логический поток управления переходит между действиями.Logical control flow is transferred between activities. Например, во время работы приложения появляется и исчезает множество действий "отправка сообщения".For example, during the lifetime of an application, many "message send activities" appear and disappear. Дополнительные сведения о просмотре трассировок и действий, а также о пользовательском интерфейсе средства просмотра трассировки службы см. в разделе Использование Service Trace Viewer для просмотра коррелированных трассировок и устранения неполадок.For more information on viewing traces and activities, and the user interface of the Service Trace Viewer too, see Using Service Trace Viewer for Viewing Correlated Traces and Troubleshooting.

Переключение между различными представлениямиSwitching to Different Views

В программе Service Trace Viewer предусмотрены следующие различные представления.The Service Trace Viewer provides the following different views. Они отображаются в виде вкладок на левой панели средства просмотра, и к ним также можно получить доступ из меню вид .They are displayed as tabs on the left pane of the Viewer, and can also be accessed from the View menu.

  • Представление действияActivity View

  • Представление проектаProject View

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

  • Представление диаграммыGraph View

Представление действияActivity view

После открытия файлов трассировки можно просмотреть трассировки, сгруппированные в действия, и отобразить их в представлении " действия " на панели слева.Once the trace files are opened, you can see the traces grouped into activities and displayed in the Activity view in the left-hand pane.

В представлении " действия " отображаются имена действий, число трассировок в действии, длительность, время начала и время окончания.The Activity view displays activity names, number of traces in the activity, duration time, start time and end time.

При щелчке на любом из перечисленных действий на панели трассировок справа отображаются трассировки этого действия.By clicking any of the listed activities, the traces in this activity are displayed in the trace pane on the right. После этого можно выбрать трассировку, чтобы просмотреть сведения о ней.You can then select a trace to view its details.

Можно выбрать несколько действий, нажав клавишу CTRL или SHIFT и выбрав нужные действия.You can select multiple activities by pressing the Ctrl or Shift key and clicking the desired activities. Панель трассировок отображает все трассировки выбранных действий.The trace pane displays all the traces of the selected activities.

Можно дважды щелкнуть действие, чтобы отобразить его в представлении графика .You can double-click an activity to display it in Graph View. Альтернативным способом является выбор действия и переключение в представление графика .The alternative way is to select an activity and switch to Graph View.

Примечание

Действие "000000000000" является специальным действием, которое не может быть отображено в представлении графа.The activity "000000000000" is a special activity that cannot be displayed in the Graph View. Поскольку все остальные действия привязаны к нему, отображение данного действия может сильно повлиять на производительность.Because all other activities are linked to it, displaying this activity has a severe performance impact.

Чтобы выполнить сортировку списка действий, щелкните заголовок столбца.You can click the column title to sort the activity list. Действия, содержащие трассировки предупреждений, имеют желтый фон, а действия, содержащие трассировки ошибок, - красный фон.Activities that contain warning traces have a yellow background and those that contain error traces have a red one.

Существуют различные типы действий, и каждому типу соответствует значок, расположенный слева от каждого действия.There are different types of activities and each type corresponds to an icon on the left side of each activity. Обратитесь к разделу "Значки трассировок", чтобы получить информацию об их значении.You can refer to the Understanding Trace Icons section for their meaning.

Представление проектаProject View

Это представление позволяет управлять файлами трассировки текущего проекта.This view enables you to manage trace files in the current project. Дополнительные сведения см. в разделе «Управление проектом».See the Managing Project section for more details.

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

Это представление позволяет просматривать все трассировки журнала сообщений, включая действия, даты и времени, обработку, действий и обратно, а также переходить к сведениям о трассировке журнала сообщений.This view enables you to view all message log traces, including Action, Date/Time, Process, Acivity and From/To, and navigate to the details of the associated message log trace. Трассировки журнала сообщений можно сгруппировать по границе действия, процессу или потоку или отправить & получения для упрощения навигации по потоку сообщений.You can group the message log traces by Activity Boundary, Process/Thread, or Send & Receive for easier navigation of the message flow.

Представление диаграммыGraph View

В этом представлении отображаются данные трассировки для данного действия в форме диаграммы.This view displays the trace data for a given activity in chart form. Диаграмма позволяет просматривать последовательные этапы выполнения событий и взаимосвязи между множеством действий при перемещении данных между ними.The chart form enables you to see the stepwise execution of events and the interrelationships between multiple activities as data moves between them.

Чтобы переключиться в представление графика , выберите действие в представлении действие и перейдите на вкладку действие или трассировку журнала сообщений в представлении сообщений .To switch to Graph view, select an activity in the Activity view and click the Activity tab, or a message log trace in the Message View. Если загружено несколько файлов трассировки и действие включает трассировки из нескольких файлов, в представлении графика отображаются все соответствующие трассировки.If multiple trace files are loaded and the activity involves traces from more than one file, all of the relevant traces appear in the graph view. Двойной щелчок по действиям и трассировке журнала сообщений также приводит к представлению графика .Double-clicking on the activities and message log traces also leads you to the Graph view.

В представлении диаграммы каждый вертикальный столбец представляет действие, а каждый блок в столбце представляет трассировку.In Graph view, each vertical column represents an activity, and each block in the column represents a trace. Действия группируются в процессы (или потоки).The activities are grouped by process (or thread). Небольшие стрелки между действиями обозначают перенаправления.The small arrows between activities represent transfers. Большие стрелки между процессами обозначают обмен сообщениями.The big arrows between processes represent message exchange. Выбранное действие всегда обозначается желтым цветом.The activity in selection is always in yellow.

Выбор трассировок на графикеSelecting Traces in the Graph
  1. Щелкните блок на графике.Click a block in the graph.

  2. Используйте клавиши СТРЕЛКА ВВЕРХ и СТРЕЛКА ВНИЗ для выбора соседних трассировок.Use the up and down keys to select its neighboring traces.

  3. Просматривайте данные трассировки на панели трассировки и в области сведений.Observe the trace information in the Trace Pane and Detail Pane.

Развертывание и свертывание перенаправлений действийExpanding or Collapsing Activity Transfers

Можно развернуть перенаправление действия, если выбранное действие перенаправляется на другое действие.You can expand activity transfers when the activity in selection transfers out to another activity. Это позволяет следить за перенаправлениями.It enables you to follow the transfers.

Развертывание и свертывание перенаправлений действийTo expand or collapse activity transfers,

  1. Нахождение трассировки перемещения с помощью знака "+" слева от значка перемещения.Locate the transfer trace with a "+" sign on the left of the transfer icon.

  2. Нажмите клавишу "+" или клавиши CTRL и "+" с помощью клавиатуры.Click the "+", or press Ctrl and "+" using the keyboard.

  3. На графике отображается следующее действие.The next activity appears in the graph.

  4. В левой части значка перемещения появится "-".A "-" appears on the left of the transfer icon. Щелкните знак "-" или нажмите клавиши CTRL и "-", чтобы свернуть действие.Click the "-" sign or press Ctrl and "-", the activity transfer collapses.

Примечание

Если развернуть одно из нескольких перенаправлений на одно действие, будут отображены действия, ведущие к новому действию из корневого действия.When an activity has multiple transfers into it and you expand one of the transfers, activities that lead up to the new activity from the root activity are displayed. Эти новые действия отобразятся в свернутом виде.These new activities appear in collapsed form. Если необходимо просмотреть подробные сведения об этих действиях, разверните их по вертикали, щелкнув значок развертывания в заголовке графика.If you want to see the details of these activities, expand them vertically by clicking the expand icon in the header of the graph.

Вертикальное развертывание и свертывание действийExpanding or Collapsing Activities Vertically

Средство просмотра позволяет скрыть ненужные сведения на графике действий путем свертывания действий.The viewer hides unnecessary detail in the activity graph by collapsing activities. В свернутом действии отдельные трассировки не отображаются.In a collapsed activity, individual traces are not displayed. Отображаются только перенаправления трассировок.Only transfers trace appear. Чтобы просмотреть все трассировки в действии, разверните действие вертикально, щелкнув значок развертывания действия в заголовке графика.If you want to view all traces in an activity, expand the activity vertically by clicking the expand symbol of the activity in the header of the graph.

Вертикальное развертывание и свертывание действийTo expand or collapse activities vertically,

  1. Щелкните значок "+" в заголовке действия, чтобы развернуть действие по вертикали.Click the "+" icon in the activity header to expand the activity vertically.

  2. Обратите внимание, что на графике отображаются все трассировки.Notice that all traces are displayed in the graph.

  3. Щелкните значок "-" в заголовке действия, чтобы свернуть действие по вертикали.Click the "-" icon in the activity header to collapse the activity vertically.

  4. Обратите внимание, что в действии отображаются только важные трассировки перенаправлений, журналов сообщений, предупреждений и исключений.Notice that only important transfers, message logs, warning and exception traces are shown in the activity.

ПараметрыOptions

В меню « Параметры » в представлении диаграммы можно выбрать два параметра.You can select two options from the Option menu in Graph view.

  • Показать трассировки границ действий. Если этот параметр отключен, трассировки границ действий на графике игнорируются.Show Activity Boundary Traces, which when unchecked ignore the activity boundary traces in the graph.

  • Показать подробные трассировки, не относящиеся к сообщениям. Если этот параметр отключен, игнорируются все подробные трассировки, за исключением трассировок сообщений.Show Non-message Verbose Traces, which when unchecked ignore verbose level traces, except for message traces. В большинстве случаев подробные трассировки не очень важны для анализа.In most cases, verbose level traces are less important for analysis. Этот параметр полезен, если не требуется анализировать подробные трассировки, и необходимо сосредоточиться на более важных трассировках.This option is helpful when you do not want to analyze verbose level traces and only want to focus on more important traces.

Режим макетаLayout Mode

Средство просмотра имеет два режима макета: Обработка и поток.The viewer has two Layout Modes: Process and Thread. Этот параметр определяет самый большой элемент организации.This setting defines the largest unit of organization. Режим макета по умолчанию — Process, то есть действия группируются по процессам в графе.The default Layout Mode is Process, which means that activities are grouped by processes in the graph.

Список выполненияExecution List

В этом раскрывающемся списке можно выбрать процесс или поток для отображения на графике.You can select which process or thread to be displayed in the graph from this drop-down list. Например, если имеется два файла трассировки двух клиентов (А и Б) и открыта одна служба и необходимо отобразить на графике только службу и клиент А, можно отменить выбор клиента Б в списке.For example, if you have the trace files of two clients (A and B) and one service opened, and you only want to display the service and client A in the graph, you can deselect client B from the list.

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

Для просмотра сведений трассировки выберите трассировку на панели трассировки.To view a trace detail, select a trace in the Trace pane. Подробные сведения отобразятся в области сведений.The details are displayed in the Detail pane.

Панель трассировкиTrace Pane

Панель, расположенная в правой верхней части окна Service Trace Viewer, - это панель трассировки.The upper right pane in the Service Trace Viewer is the Trace Pane. В ней отображаются все трассировки, существующие в выбранном действии, вместе с дополнительной информацией, такой как уровень трассировки, идентификатор потока и имя процесса.It lists all the traces in the selected activity with extra information, for example, trace level, thread ID, and process name.

Вы можете скопировать необработанный XML-код трассировки в буфер обмена, щелкнув трассировку правой кнопкой мыши и выбрав пункт Копировать трассировку в буфер обмена.You can copy the raw XML of the trace to the clipboard by right-clicking a trace and selecting Copy Trace to Clipboard.

Область сведенийDetail Pane

Левая нижняя область окна Service Trace Viewer - это область сведений.The bottom left pane in the Service Trace Viewer is the Detail Pane. Она содержит три вкладки для просмотра сведений трассировок.It provides three tabs to view trace details.

В форматированном представлении данные отображаются более организованным образом.The Formatted view displays the information in a more organized way. Все известные XML-элементы отображаются в таблицах и деревьях, что облегчает чтение и восприятие информации.It lists all known XML elements in tables and trees, making it easier to read and understand the information.

В представлении XML отображается XML-код, соответствующий выбранной трассировке.The XML view displays XML corresponding to the selected trace. Это представление поддерживает выделение цветом и раскраску синтаксических конструкций.It supports highlighting and syntax color. При использовании Find для поиска строк выделяются результаты поиска.When you use Find to search strings, it highlights the search results.

В представлении сообщений отображается часть сообщения XML в трассировках журнала сообщений.The Message view displays the message part of the XML in message log traces. Эти данные скрыты при выборе трассировок, не связанных с сообщениями.It is invisible when you select a non-message trace.

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

Чтобы упростить анализ файлов трассировки, их можно фильтровать следующими способами.To make the analysis of trace easier, you can filter them in the following ways:

  • Панель инструментов фильтрации предоставляет доступ к встроенным и настраиваемым фильтрам.The filter toolbar provides access to pre-defined and custom filters. Его можно включить в меню вид .It can be enabled through the View menu.

  • Предварительно определенный фильтр средства просмотра можно использовать для выборочной фильтрации частей трассировок WCF.The pre-defined filter of the viewer can be used to selectively filter parts of the WCF traces. По умолчанию он настроен на пропускание всех трассировок инфраструктуры.By default, it is set to allow all infrastructure traces to pass through. Параметры этого фильтра определяются в подменю " Параметры фильтра " в меню " вид ".The settings of this filter are defined in the Filter Options sub-menu under View menu.

  • Пользовательские фильтры XPath позволяют пользователям полностью контролировать процесс фильтрации.Custom XPath filters give users full control over filtering. Их можно определить в настраиваемом фильтре в меню вид .They can be defined in the Custom Filter under View menu.

Отображаются только трассировки, которые проходят через все фильтры.Only traces that passes through all filters is displayed.

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

Панель фильтра отображается в верхней части инструмента.The filter toolbar appears across the top of the tool. Если он отсутствует, его можно активировать в меню вид .If it is not present, you can activate it in the View menu. Панель содержит три компонента.The bar has three components:

  • Искать: найдите , определяет предмет для поиска в операции фильтрации.Look for: Look for defines the subject to look for in the filter operation. Например, если нужно найти все трассировки, которые были созданы в контексте процесса X, задайте для этого поля значение X, а в поле Поиск — значение "имя процесса".For example, if you want to find all traces that were emitted in the context of process X, set this field to X and the Search In field to ‘Process Name’. Это поле заменяется элементом управления выбора даты и времени, если выбран фильтр времени.This field changes to a DateTime selector control when a time-based filter is selected.

  • Диапазон поиска: это поле определяет тип применяемого фильтра.Search in: This field defines the type of filter to apply.

  • Уровень: определяет минимальный уровень трассировки, допускаемый фильтром.Level: The level setting defines the minimum trace level allowed by the filter. Например, при значении "Ошибка и выше" отображаются только трассировки уровня Error или Critical.For example, if the level is set to Error and Up, only traces at the Error and critical level are displayed. Этот фильтр комбинируется с критериями, заданными в полях «Искать» и «Диапазон поиска».This filter combines with the criteria specified by Look For and Search In.

Кнопка Фильтр теперь запускает операцию фильтрации.The Filter Now button starts the filter operation. Некоторые фильтры, особенно если они применяются к большим объемам данных, работают достаточно долго.Some filters, especially when they are applied to a large data set, take a long time to complete. Операцию фильтра можно отменить, нажав кнопку остановить , которая отображается в строке состояния в меню операции .You can cancel the filter operation by pressing the Stop button that appears in the status bar under the Operations menu.

Кнопка clear сбрасывает предварительно определенные и настраиваемые фильтры, чтобы разрешить передачу всех трассировок.The Clear button resets pre-defined and custom filters to allow all traces to pass through.

Параметры фильтрацииFilter Options

Средство просмотра может автоматически удалять трассировки WCF из представления.The viewer can automatically remove WCF traces from the view. Он также может выборочно удалять трассировки, относящиеся к отдельным областям WCF, например, удалять из представления трассировки, относящиеся к транзакциям.It can selectively remove traces emitted by specific areas of WCF, for example, removing transaction related traces from the view.

Параметры этого фильтра определяются в подменю " Параметры фильтра " в меню " вид ".The settings of this filter are defined in the Filter Options sub-menu under View menu.

Настраиваемые фильтрыCustom Filters

С помощью языка XML Path (XPath) можно создавать настраиваемые фильтры, позволяющие выполнять поиск данных трассировки для любого XML-элемента.If you are familiar with the XML Path Language (XPath), you can use it to construct custom filters to search the trace data for any XML element of interest. Фильтры доступны на панели инструментов фильтрации.The filters are accessible through the filter toolbar.

В пользовательских фильтрах могут быть предусмотрены параметры.Custom filters can include parameters. Также можно импортировать уже имеющиеся настраиваемые фильтры.You can also import pre-existing custom filters.

Создание пользовательского фильтраCreating a custom filter

Фильтры можно создавать двумя способами:Filters can be created in two ways:

Создание настраиваемого фильтра с помощью мастера шаблоновCreating a Custom Filter using the Template Wizard

Можно щелкнуть существующую трассировку и создать фильтр на основе структуры этой трассировки.You can click an existing trace and create a filter based on the structure of the trace. В этом примере создается настраиваемый фильтр на основе идентификатора потока.This example creates a custom filter based on thread ID.

  1. На панели трассировки в правой части средства просмотра выберите трассировку, содержащую элемент, для которого требуется выполнить фильтрацию.In the trace pane in the top right area of the viewer, select a trace that includes the element you want to filter for.

  2. Нажмите кнопку создать настраиваемый фильтр , расположенную в верхней части панели трассировки.Click the Create Custom Filter button located at the top of the trace pane.

  3. В появившемся диалоговом окне введите имя фильтра.In the dialog box that appears, enter a name for your filter. В этом примере введите Thread ID.In this example, enter Thread ID. Также можно ввести описание фильтра.You can also provide a description of your filter.

  4. В древовидном представлении слева представлена структура записи трассировки, выбранной на шаге 1.The tree view on the left displays the structure of the trace record you selected in step 1. Перейдите к элементу, для которого нужно создать условие.Browse to the element you want to create a condition for. В этом примере перейдите к ThreadID, который будет находиться в узле XPath: /E2ETraceEvent/System/Execution/@ThreadID.In this example, browse to the ThreadID to be located in the XPath: /E2ETraceEvent/System/Execution/@ThreadID node. Дважды щелкните атрибут ThreadID в древовидном представлении.Double-click the ThreadID attribute in the tree view. Будет создано выражение для атрибута в правой части диалогового окна.This creates an expression for the attribute on the right of the dialog.

  5. Измените поле параметра для состояния ThreadID с None на "{0}".Change the parameter field for the ThreadID condition from None to ‘{0}’. В результате выполнения этого действия при применении фильтра станет возможной настройка значения ThreadID.This step enables the ThreadID value to be configured when the filter is applied. (См. раздел "Применение фильтра".) Можно определить до четырех параметров.(See the How to Apply a Filter section) You can define up to four parameters. Условия комбинируются с помощью оператора "ИЛИ".Conditions are combined using the OR operator.

  6. Нажмите кнопку ОК , чтобы создать фильтр.Click Ok to create the filter.

Примечание

Если фильтр создан с помощью мастера шаблонов, его можно изменять только вручную.Once a filter has been created using the template wizard, it can only be edited manually. Невозможно запустить мастер для фильтра, который уже был создан.It is not possible to activate the wizard for a filter that has been created previously. Кроме того, условия фильтра XPath, созданного с помощью мастера шаблонов, комбинируются с помощью оператора "ИЛИ".In addition, the conditions of an XPath filter created in the template wizard are combined using the OR operator. Если необходимо использовать оператор «И», выражение фильтра можно отредактировать после его создания.If you require an AND operation, you can edit the filter expression after it has been created.

Создание пользовательского фильтра вручнуюCreating a Custom Filter Manually

В меню "Настраиваемые фильтры" можно создавать фильтры XPath вручную.The Custom Filters menu allows you to enter XPath filters manually.

  1. В меню Вид выберите пункт меню Настраиваемые фильтры .In the View menu, click the Custom Filters menu item.

  2. В появившемся диалоговом окне нажмите кнопку создать.In the dialog that appears, click New.

  3. Как минимум, следует указать имя фильтра и выражение XPath.At the minimum, specify a Filter Name and XPath expression.

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

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

После создания настраиваемый фильтр доступен на панели инструментов фильтрации.Once a custom filter has been created, it is accessible though the filter toolbar. Выберите фильтр, который нужно применить, в поле Поиск в панели инструментов фильтра.Select the filter you want to apply in the Search In field of the filter toolbar. В случае предыдущего примера выберите "Thread ID".For the previous example, select ‘Thread ID’.

  1. Укажите искомое значение в поле найти .Specify the value you are looking for in the Find What field. В данном примере введите идентификатор потока, который требуется найти.In our example, enter the ID of the thread you want to search for.

  2. Нажмите кнопку Фильтр сейчаси просмотрите результат операции.Click Filter Now, and observe the result of the operation.

Если фильтр использует несколько параметров, введите их в качестве разделителя в поле найти , используя символ ";".If your filter uses multiple parameters, enter them using ‘;’ as a separator in the Find What field. Например, следующая строка определяет три параметра: "1;findValue;text".For example, the following string defines 3 parameters: ‘1;findValue;text’. Средство просмотра применяет "1" к параметру {0} фильтра.The viewer applies ‘1’ to the {0} parameter of the filter. "findValue" и "Text" применяются к {1} и {2} соответственно.‘findValue’ and ‘text’ are applied to {1} and {2} respectively.

Совместное использование настраиваемых фильтровSharing custom Filters

Настраиваемые фильтры могут совместно использоваться различными сеансами и пользователями.Custom filters can be shared between different sessions and different users. Фильтры можно экспортировать в файл определения, который затем можно импортировать в другое расположение.You can export the filters to a definition file and import this file at another location.

Импорт настраиваемого фильтраTo import a custom filter:

  1. В меню вид выберите пункт Настраиваемые фильтры.In the View menu, click Custom Filters.

  2. В открывшемся диалоговом окне нажмите кнопку Импорт .In the dialog box that opens, click the Import button.

  3. Перейдите к файлу настраиваемого фильтра (. STVCF), щелкните его и нажмите кнопку Открыть .Navigate to the custom filter file (.stvcf), click the file, and click the Open button.

Экспорт настраиваемого фильтраTo export a custom filter:

  1. В меню Вид выберите пункт Настраиваемые фильтры.In the View menu, click Custom Filters.

  2. В появившемся диалоговом окне выберите фильтр, который следует экспортировать.In the dialog box that opens, select the filter you want to export.

  3. Нажмите кнопку Экспорт .Click the Export button.

  4. Укажите имя и расположение файла определения пользовательского фильтра (STVCF) и нажмите кнопку сохранить .Specify the name and location of the custom filter definition file (.stvcf), and click the Save button.

Примечание

Эти пользовательские фильтры можно импортировать и экспортировать только в Service Trace Viewer.These custom filters can only be imported and exported from Service Trace Viewer. Выполнить их чтение другими средствами невозможно.They cannot be read by other tools.

Поиск данныхFinding Data

В средстве просмотра предусмотрены следующие способы поиска данных.The viewer provides the following ways to find data:

  • Панель поиска предоставляет быстрый доступ к наиболее распространенным поисковым параметрам.The Find toolbar provides a quick access to the most common find options.

  • Диалоговое окно поиска предоставляет дополнительные параметры поиска.The Find dialog provides more find options. Доступ к нему можно получить в меню Правка или с помощью сочетания клавиш CTRL + F.It is accessible through the Edit menu, or by the short key Ctrl + F.

Панель инструментов поиска отображается в верхней части средства просмотра.The find toolbar appears at the top of the viewer. Если он отсутствует, его можно активировать в меню вид .If it is not present, you can activate it in the View menu. Панель содержит два компонента.The bar has two components:

  • Искать: позволяет ввести искомое ключевое слово.Find What: Allows you to enter search keyword.

  • Диапазон поиска: позволяет указать область поиска.Look In: Allows you to enter the search scope. Можно выбрать поиск во всех действиях или только в текущем действии.You can select whether to search in all activities or in the current activity only.

Диалоговое окно поиска содержит два дополнительных параметра.The find dialog provides two additional options:

  • Найти объект.Find target:

    • Параметр "необработанные данные журнала" выполняет поиск ключевого слова во всех необработанных данных.The "Raw log data" option searches the keyword in all raw data.

    • Параметры "XML Text" и "XML Attribute" выполняют поиск только в XML-элементах.The "XML Text" and "XML Attribute" options only search in XML elements.

    • Параметр "зарегистрированное сообщение" выполняет поиск по ключевому слову только в сообщениях.The "Logged Message" option searches the keyword only in messages.

  • Игнорировать корневое действие: Поиск игнорирует трассировки в действии "000000000000".Ignore root activity: The search ignores the traces in the "000000000000" activity. Этот параметр увеличивает производительность при работе с большими файлами трассировки, если корневое действие содержит тысячи трассировок, большая часть которых является перенаправлениями.This improves performance in large trace files when the root activity has thousands of traces, most of which are transfers.

Поскольку трассировки записываются поэтапно во время работы приложения, навигация по трассировкам может помочь при отладке приложения.Because traces are recorded step by step during application runtime, navigating traces can help you to debug your application. Программа Service Trace Viewer предоставляет различные способы навигации по трассировкам.The Service Trace Viewer provides various ways to navigate in traces.

Шаг вперед или назадStep Forward or Backward

Если рассматривать каждую трассировку как строку кода в программе, пошаговое выполнение в интегрированной среде разработки (IDE) Visual Studio очень похоже на шаг с обходным переходом.If you consider each trace as a line of code in the program, stepping forward is very similar to "Step over" in the Visual Studio Integrated Development Environment (IDE). Единственное отличие заключается в том, что при работе с трассировками можно также совершать шаги назад.The difference is that you can also step backward in the traces. Шаг вперед означает переход к следующей трассировке в действии.Stepping forward means moving to the next trace in the activity.

  • Шаг вперед. Используйте меню действие или нажмите клавишу F10.Step Forward: Use the Activity menu, or press "F10". В области трассировки можно также использовать клавишу со стрелкой "вниз".You can also use arrow key "down" in the trace pane.

  • Шаг назад. Используйте меню действие или нажмите клавишу F9.Step Backward: Use the Activity menu, or press "F9". В области трассировки можно также использовать клавишу со стрелкой "вверх".You can also use arrow key "up" in the trace pane.

Примечание

Это может привести к действию, выполняемому в другом процессе или даже на другом компьютере, так как сообщения WCF могут содержать идентификаторы действий, охватывающие компьютеры.This can take you to an activity occurring in a different process or even on a different computer, because WCF messages can carry activity IDs that span machines.

Отслеживание перенаправленийFollow Transfer

Трассировки перенаправлений — это специальные трассировки в файле трассировки.Transfer traces are special traces in the trace file. Посредством трассировки перенаправления одно действие может перенаправляться другому действию.An activity may transfer to another activity by a transfer trace. Например, "действие A" может переноситься в "Activity B".For example, "Activity A" may transfer to "Activity B". В этом случае имеется трассировка перемещения в «действии A» с именем «to: Activity» и значком перемещения.In such case, there is a transfer trace in the "Activity A" with the name "To: Activity" and the transfer icon. Эта трассировка перенаправления является связью между двумя трассировками.This transfer trace is a link between the two traces. В "действии б" в конце действия также может быть трассировка передачи, которую необходимо вернуть в "действие а".In "Activity B", there might also be a transfer trace at the end of the activity to transfer back to "Activity A". Это похоже на вызовы функций в программах: А вызывает Б, затем Б возвращает значение.This is similar to function calls in programs: A calls B, then B returns.

"Следовать перемещению" аналогичен шагу в отладчике."Follow transfer" is similar to "Step into" in a debugger. Отслеживается перенаправление от "Действия А" к "Действию Б". Это не оказывает какого-либо воздействия на другие трассировки.It follows the transfer from A to B. It does not have any effect on other traces.

Предусмотрено два способа отслеживания перенаправлений: с помощью мыши или с помощью клавиатуры.There are two ways to follow a transfer: by mouse or by keyboard:

  • При помощи мыши: дважды щелкните трассировку перенаправления на панели трассировки.By Mouse: Double-click the transfer trace in the trace pane.

  • С помощью клавиатуры: выберите трассировку перемещения и используйте команду "перейти к перемещению" в меню " действие " или нажмите клавишу F11.By Keyboard: Select a transfer trace, and use "Follow Transfer" in the Activity menu, or press "F11"

Примечание

Во многих случаях, когда «Действие А» перенаправляется к «Действию Б», «Действие А» ожидает обратного перенаправления «Действия Б» к «Действию А». Это означает, что «Действие А» не имеет запланированных трассировок во время выполнения трассировки «Действием Б».In many cases, when Activity A transfers to Activity B, Activity A waits until Activity B transfers back to Activity A. This means that Activity A has no trace logged during the period when Activity B is actively tracing. Однако "Действие А" может не находиться в состоянии ожидания, а продолжать записывать трассировки.However, it is also possible that Activity A does not wait, and continues to log traces. Также возможна ситуация, когда "Действие Б" не перенаправляется обратно к "Действию А". Таким образом, перенаправления действий все же отличаются от вызовов функций.It is also possible that Activity B does not transfer back to Activity A. Therefore, activity transfers are still different from function calls in this sense. Представление графика позволяет лучше понять суть перенаправления действий.You can understand activity transfers better in Graph view.

Переход к следующему или предыдущему перенаправлениюJump to Next or Previous Transfer

При анализе текущего действия (или нескольких выбранных действий) может потребоваться быстро найти действия, к которым оно перенаправляется.When you are analyzing the current activity, or selected activities when multiple activities are selected, you may want to quickly find the activities it transfers to. "Переход к следующему переносу" позволяет выбрать следующую трассировку перемещения в действии."Jump to next transfer" allows you to locate the next transfer trace in the activity. Настроив трассировку перемещения, вы можете перейти к следующему действию с помощью инструкции "следовать за перемещением".Once you find the transfer trace, you can use "Follow transfer" to step into the next activity.

  • Перейти к следующему переносу: используйте меню " действие " или нажмите клавиши "Ctrl + F10".Jump to Next Transfer: Use the Activity menu, or press "Ctrl + F10".

  • Перейти к предыдущему переносу: используйте меню " действие " или нажмите клавиши "CTRL + F9".Jump to Previous Transfer: Use the Activity menu, or press "Ctrl + F9".

Хотя переходы в области действий и области трассировки аналогичны отладке, использование представления диаграмм обеспечивает гораздо более эффективное взаимодействие.Although navigating in the activity pane and trace pane is similar to debugging, using Graph view provides a much better experience in navigation. Дополнительные сведения см. в разделе "представление графика".See "Graph View" section for more information.

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

Файлы трассировки могут быть очень большими.Trace files can be very large. Например, если включить трассировку на уровне "verbose", результирующий файл трассировки для выполнения в течение нескольких минут может легко составлять сотни мегабайт или даже больше, в зависимости от скорости сети и схемы обмена данными.For example, if you turn on tracing on the "Verbose" level, the resulting trace file for running a few minutes can easily be hundreds of megabytes or even larger, depending on network speed and communication pattern.

При открытии очень большого файла трассировки в программе Service Trace Viewer производительность системы может значительно снизиться.When you open a very large trace file in the Service Trace Viewer, system performance can be negatively impacted. Скорость загрузки может быть медленной, и может увеличиться время отклика.The loading speed and the response time after loading can be slow. Фактическая скорость периодически меняется в зависимости от конфигурации оборудования.Actual speed differs from time to time, depending on your hardware configuration. На большинстве компьютеров загрузка файла трассировки размером более 200 МБ значительно снижает производительность системы.In most PCs, loading a trace file larger than 200M has a severe performance impact. При работе с файлами трассировки, имеющими размер более 1 Гб, программа может использовать всю доступную оперативную память или очень долго не отвечать на запросы.For traces files larger than 1G, the tool may use up all available memory, or stop responding for a very long time.

Чтобы избежать снижения скорости загрузки и времени отклика при анализе больших файлов трассировки, средство просмотра трассировки служб предоставляет функцию «частичной загрузки», которая загружает только небольшую часть трассировки за раз.In order to avoid the slow loading and response time in analyzing large trace files, the Service Trace Viewer provides a feature called "Partial Loading", which only loads a small part of the trace at a time. Например, имеется файл трассировки размером более 1 Гб, работающий на сервере на протяжении нескольких дней.For example, you may have a trace file over 1GB, running for several days on the server. При возникновении некоторых ошибок и попытке анализа трассировки не требуется открывать файл трассировки целиком.When some errors have occurred and you want to analyze the trace, it is not necessary to open the entire trace file. Вместо этого можно загрузить трассировки за определенный период времени, когда, скорее всего, произошла ошибка.Instead, you can load the traces within a certain period of time when the error might have occurred. Поскольку область данных сокращается, программа Service Trace Viewer загружает файл быстрее, и можно найти ошибку, используя небольшой объем данных.Because the scope is smaller, the Service Trace Viewer tool can load the file faster and you can identify the errors using a smaller set of data.

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

Включать частичную загрузку вручную не требуется.You do not need to manually enable partial loading. Если общий размер открываемых файлов трассировки превышает 40 МБ, программа Service Trace Viewer автоматически отображает диалоговое окно частичной загрузки, чтобы можно было выбрать часть, которую требуется загрузить.If the total size of the trace file(s) you attempt to load exceeds 40MB, Service Trace Viewer automatically displays a Partial Loading dialog for you to select the part that you want to load.

Примечание

Поскольку трассировки могут быть распределены по времени неравномерно, длительность периода времени, который указывается на панели инструментов частичной загрузки, может не быть пропорциональна отображаемому размеру загружаемых данных.Because traces may not be distributed evenly in the time span, the length of the time period you specify in the Partial Loading toolbar may not be proportional to the loading size shown. Фактический размер загружаемых данных может быть меньше, чем предполагаемый размер, который отображается в диалоговом окне частичной загрузки.The actual loading size can be smaller than the Estimated Size in the partial loading dialog.

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

После частичной загрузки файла трассировки может потребоваться изменить набор загружаемых данных.After you have partially loaded the trace file, you may want to change the data set being loaded. Это можно сделать с помощью панели инструментов частичной загрузки, расположенной в верхней части средства просмотра.You can do so by adjusting the Partial Loading toolbar at the top of the viewer.

  1. Переместите панель инструментов с помощью мыши или введите время начала и окончания.Move the toolbar by mouse, or input the Begin and End time.

  2. Нажмите кнопку " изменить ".Click the Adjust button.

Значки трассировокUnderstanding Trace Icons

Ниже приведен список значков, которые программа Service Trace Viewer использует в представлении действий , представлении графа и панели трассировки для представления различных элементов.The following is a list of icons that the Service Trace Viewer tool uses in the Activity view, Graph view and Trace pane to represent different items.

Примечание

Некоторые трассировки, которые не разбиты на категории (например, «сообщение закрыто»), не имеют значка.Some traces that are not categorized (for example, "a message is closed") have no icon.

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

ЗначокIcon ОписаниеDescription
Предупреждение трассировкиWarning trace Трассировка предупреждения: трассировка, создаваемая на пороге предупрежденийWarning trace: A trace that is emitted at the warning level
Трассировка ошибокError trace Трассировка Error: трассировка, создаваемая на уровне Error.Error trace: A trace that is emitted at the error level.
Трассировка начала действия:Activity Start trace: Трассировка Start: трассировка, обозначающая начало действия.Activity Start trace: A trace that marks the beginning of an activity. В ней содержится имя действия.It contains the name of the activity. Разработчику приложений необходимо определить одну трассировку Start для каждого идентификатора действия для каждого процесса или потока.As the application designer or developer, you should define one activity Start trace per activity id per process or thread.

После распространения идентификатора действия по источникам трассировки для корреляции трассировок можно увидеть несколько трассировок Start для одного идентификатора действия (один для каждого источника трассировки).If the activity id is propagated across trace sources for trace correlation, you can then see multiple Starts for the same activity id (one per trace source). Трассировка Start создается, если функция ActivityTracing включена для источника трассировки.The Start trace is emitted if ActivityTracing is enabled for the trace source.
Действие "закончить трассировку "Activity Stop trace Трассировка Stop: трассировка, обозначающая конец действия.Activity Stop trace: A trace that marks the end of an activity. .. В ней содержится имя действия.It contains the name of the activity. Разработчику приложений необходимо определить одну трассировку Stop для каждого идентификатора действия для каждого источника трассировки.As the application designer or developer, you should define one activity Stop trace per activity id per trace source. Ни одна трассировка из заданного источника трассировки не появляется после создания трассировки Stop источником трассировки, кроме случая, когда временное разбиение трассировки не слишком мало.No traces from a given trace source appear after the activity Stop emitted by that trace source, except if the trace time granularity is not sufficiently small. В этом случае две трассировки с одним значением временного разбиения, включая Stop, могут чередоваться при отображении.When that happens, two traces with the same time, including a Stop, may be interleaved when displayed. После распространения идентификатора действия по источникам трассировки для корреляции трассировок можно увидеть несколько трассировок Stop для одного идентификатора действия (один для каждого источника трассировки).If the activity id is propagated across trace sources for trace correlation, you can see multiple Stops for the same activity id (one per trace source). Трассировка Stop создается, если функция ActivityTracing включена для источника трассировки.The Stop trace is emitted if ActivityTracing is enabled for the trace source.
Действие приостановить трассировкуActivity Suspend trace Трассировка Suspend: трассировка, обозначающая время приостановки действия.Activity Suspend trace: A trace that marks the time an activity is paused. До возобновления приостановленного действия никакие трассировки не создаются.No traces are emitted in a suspended activity until the activity resumes. Приостановленное действие означает, что никакой обработки в этом действии в области источника трассировки не выполняется.A suspended activity denotes that no processing is happening in that activity in the scope of the trace source. Трассировки Suspend и Resume полезны для профилирования.Suspend/Resume traces are useful for profiling. Трассировка Suspend создается, если функция ActivityTracing включена для источника трассировки.The Suspend trace is emitted if ActivityTracing is enabled for the trace source.
Действие возобновления трассировкиActivity resume trace Трассировка Resume: обозначает время возобновления действия после приостановки.Activity resume trace: A trace that marks the time an activity is resumed after it had been suspended. В этом действии трассировки могут создаваться повторно.Traces may be emitted again in that activity. Трассировки Suspend и Resume полезны для профилирования.Suspend/Resume traces are useful for profiling. Трассировка Resume создается, если функция ActivityTracing включена для источника трассировки.The Resume trace is emitted if ActivityTracing is enabled for the trace source.
ПереместитьTransfer Transfer: трассировка, создаваемая при перенаправлении логики потока управления от одного действия к другому.Transfer: A trace that is emitted when logical control flow is transferred from one activity to another. Действие, от которого происходит перенаправление, может продолжать выполнение работы параллельно действию, к которому осуществляется перенаправление.The activity the transfer originates from may continue to perform work in parallel to the activity the transfer goes to. Трассировка Transfer создается, если функция ActivityTracing включена для источника трассировки.The Transfer trace is emitted if ActivityTracing is enabled for the trace source.
Перемещение изTransfer From Transfer From: трассировка, определяющая перенаправление от другого действия к текущему действию.Transfer From: A trace that defines a transfer from another activity to the current activity.
Переместить вTransfer To Transfer To: трассировка, определяющая перенаправление логического потока управления от текущего действия к другому.Transfer To: A trace that defines a transfer of logical control flow from the current activity to another activity.

Трассировки WCFWCF Traces

ЗначокIcon ОписаниеDescription
(./media/7c66e994-2476-4260-a0db-98948b9af197.gif "7c66e994-2476-4260-a0db-98948b9af197") ![трассировки журнала сообщений]Message Log trace Трассировка журнала сообщений. трассировка, создаваемая при регистрации сообщения WCF функцией ведения журнала сообщений при включении источника трассировки System.ServiceModel.MessageLogging.Message Log trace: A trace that is emitted when a WCF message is logged by the message logging feature, when the System.ServiceModel.MessageLogging trace source is enabled. При щелчке трассировки отображается сообщение.Clicking on this trace displays the message. Существует четыре настраиваемые точки ведения журнала для сообщения: ServiceLevelSendRequest, TransportSend, TransportReceive и ServiceLevelReceiveRequest, которые также могут быть заданы атрибутом messageSource в трассировке журнала сообщений.There are four configurable logging points for a message: ServiceLevelSendRequest, TransportSend, TransportReceive, and ServiceLevelReceiveRequest, which can also be specified by the messageSource attribute in the message log trace.
Получено сообщение трассировкиMessage Received trace Трассировка получила сообщение: трассировка, создаваемая при получении сообщения WCF, если источник трассировки System.ServiceModel включен на уровне сведений или подробно.Message Received trace: A trace that is emitted when a WCF message is received, if the System.ServiceModel trace source is enabled at the Information or Verbose level. Эта трассировка необходима для просмотра стрелки корреляции сообщений в представлении граф действий.This trace is essential for viewing the message correlation arrow in the Activity Graph view.
Сообщение отправлено трассировкиMessage Sent trace Трассировка отправленных сообщений: трассировка, порожденная при отправке сообщения WCF, если источник трассировки System.ServiceModel включен на уровне сведений или подробно.Message Sent trace: A trace that is emitted when a WCF message is sent if the System.ServiceModel trace source is enabled at the Information or Verbose level. Эта трассировка необходима для просмотра стрелки корреляции сообщений в представлении граф действий.This trace is essential for viewing the message correlation arrow in the Activity Graph view.

ДействияActivities

ЗначокIcon ОписаниеDescription
действияActivity Activity: указывает, что текущее действие является общим действием.Activity: Indicates that the current activity is a generic activity.
(./media/5dc8e0eb-1c32-4076-8c66-594935beaee9.gif "5dc8e0eb-1c32-4076-8c66-594935beaee9") ![действия root]Root activity Действие Root: обозначает корневое действие процесса.Root activity: Indicates the root activity of a process.

Действия WCFWCF Activities

ЗначокIcon ОписаниеDescription
(./media/29fa00ac-cf78-46e5-822d-56222fff61d1.gif "29fa00ac-cf78-46e5-822d-56222fff61d1") ![действия окружения]Environment activity Действие среды: действие, которое создает, открывает или закрывает узел или клиент WCF.Environment activity: An activity that creates, opens, or closes a WCF host or client. Ошибки, произошедшие в ходе этих этапов, отображаются в данном действии.Errors that have happened during these phases will appear in this activity.
(./media/d7b135f6-ec7d-45d7-9913-037ab30e4c26.gif "D7b135f6-ec7d-45d7-9913-037ab30e4c26") ![действия прослушивания]Listen activity Действие Listen: действие, записывающее трассировки, которые относятся к прослушивателю.Listen activity: An activity that logs traces related to a listener. В этом действии можно просматривать информацию о прослушивателе и запросы соединения.Inside this activity, we can view listener information and connection requests.
(./media/2f628580-b80f-45a7-925b-616c96426c0e.gif "2f628580-b80f-45a7-925b-616c96426c0e") ![действия получения байтов]Receive Bytes activity Действие Receive Bytes: действие, группирующее все трассировки, которые относятся к получению входящих байтов при установленном соединении между двумя конечными точками.Receive Bytes activity: An activity that groups all traces related to receiving incoming bytes on a connection between two endpoints. Это действие необходимо для корреляции с действиями транспорта, распространяющими свой идентификатор действия, например http.sys.This activity is essential in correlating with transport activities that propagate their activity id such as http.sys. В этом действии отображаются ошибки соединения, такие как прерывание связи.Connection errors such as aborts will appear in this activity.
Обработка сообщенияProcess Message activity Действие обработки сообщения: действие, которое группирует трассировки, связанные с созданием сообщения WCF.Process Message activity: An activity that groups traces related to creating a WCF message. В этом действии отображаются ошибки, связанные с неправильным конвертом или неправильно сформированным сообщением.Errors due to a bad envelope or a malformed message will appear in that activity. В этом действии можно просматривать заголовки сообщений, чтобы проверить выполнение распространения идентификатора действия от вызывающего.Inside this activity, we can inspect message headers to see if an activity id was propagated from the caller. Если распространение выполнено, при перенаправлении действия Process Action (следующий значок) можно также назначить этому действию распространенный идентификатор действия для корреляции трассировок вызывающего и вызываемого.If this is true, when we transfer to Process Action activity (the next icon), we can also assign to that activity the propagated activity id for correlation between the caller and callee’s traces.
(./media/7c66e994-2476-4260-a0db-98948b9af197.gif "7c66e994-2476-4260-a0db-98948b9af197") ![трассировки журнала сообщений]Message Log trace Действие "обработать действие" — действие, которое группирует все трассировки, связанные с запросом WCF, между двумя конечными точками.Process Action activity: An activity that groups all traces related to a WCF request across two endpoints. Если в конфигурации обеих конечных точек для параметра propagateActivity задано значение true, все трассировки от этих конечных точек объединяются в одно действие для непосредственной корреляции.If propagateActivity is set to true on both endpoints in configuration, all traces from both endpoints are merged into one activity for direct correlation. Такое действие будет содержать ошибки, обусловленные обработкой транспорта или безопасности, а также расширением до границы пользовательского кода и обратным сужением (если существует отклик).Such activity will contain errors due to transport or security processing, extending to the user code boundary and back (if a response exists).
Обработка сообщенияProcess Message activity Действие Execute User Code: действие, группирующее трассировки пользовательского кода для обработки запроса.Execute User Code activity: An activity that groups user code traces for processing a request.

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

Если у вас нет разрешения на запись в реестр, появится следующее сообщение об ошибке: "средство Microsoft Service Trace Viewer не зарегистрировано в системе" при использовании команды "svctraceviewer /register" для регистрации этого средства.If you do not have permission to write to the registry, you get the following error message "The Microsoft Service Trace Viewer was not registered to the system" when you use the "svctraceviewer /register" command to register the tool. В этом случае необходимо войти в систему с использованием учетной записи, у которой имеется право записи в реестр.If this occurs, you should log in using an account that has write access to the registry.

Кроме того, программа Service Trace Viewer записывает некоторые параметры (например, параметры настраиваемых фильтров и фильтрации) в файл SvcTraceViewer.exe.settings в папке сборки.In addition, the Service Trace Viewer tool writes some settings (for example, custom filters and filter options) to the SvcTraceViewer.exe.settings file in its assembly folder. При отсутствии разрешения на чтение файла можно по-прежнему запустить программу, но нельзя загрузить параметры.If you do not have read permission for the file, you can still launch the tool, but you cannot load the settings.

Отображение сообщения об ошибке "Неизвестная ошибка во время обработки одной или более трассировок" при открытии ETL-файла означает, что этот файл имеет недопустимый формат.If you get the error message "An unknown error occurred while processing one or more traces" when opening the .etl file, it means that the format of the .etl file is invalid.

Если открыть журнал трассировки в операционной системе на арабском языке, можно заметить, что фильтр времени не работает.If you open a trace log created using an Arabic operating system, you may notice that the time filter does not work. Например, 2005 год соответствует 1427 году в арабском календаре.For example, year 2005 corresponds to year 1427 in Arabic calendar. Однако диапазон времени, поддерживаемый фильтром в программе «Просмотр трассировки службы», не включает даты ранее 1752 г.However, the time range supported by the Service Trace Viewer tool filter does not support a date earlier than 1752. В результате может оказаться невозможным выбрать правильную дату в фильтре.This can imply that you are not able to select a correct date in the filter. Чтобы устранить эту проблему, можно создать настраиваемый фильтр (Просмотр/настраиваемые фильтры), используя выражение XPath для включения определенного диапазона времени.To resolve this problem, you can create a custom filter (View/Custom Filters) using an XPath expression to include a specific time range.

См. такжеSee also