Edit

Creating a Trace Session with a CTL File

  • Article

You can create a trace session by locating a control GUID (.ctl) file for the trace providers and locating the trace message format (.tmf) files for their messages.

To create a trace session with a CTL file

  1. Start TraceView.

  2. On the File menu, click Create New Log Session.

  3. Click Add Provider.

  4. Click CTL (Control GUID) File, and then type the path to a control GUID file for the trace provider; or, click the ellipsis button (...) and navigate to the file.

  5. Do one of the following:

    • To specify one or more TMF files , click Select TMF Files, click OK, click Add, and then browse to and select one or more TMF files from the directory. To select TMF files from another directory, click the Add button again. Otherwise, click Done.
    • To direct TraceView to search for the TMF files in a specified directory, click Set TMF Search Path, click OK, browse to the directory, and then click OK.

  6. To add additional providers, click Add Provider. This step is optional.

  7. Click Next.

  8. Select flags and a level, if desired.

  9. Set basic trace session options, if desired.

  10. Set advanced trace session options, if desired.

  11. Click Finish.

Comments

If TraceView cannot find a TMF file for the trace provider, it does not add the trace provider to the provider list in the Create New Log Session dialog box and it does not display a message that explains why the provider was not added. If the provider does not appear in the provider list, restart the procedure and use the Select TMF Files method instead of Set TMF Search Path. If you cannot locate a PDB file or a TMF file for the provider, you cannot use TraceView to create a trace session with the provider.

You can use files with file name extensions other than ".ctl" with the CTL (Control GUID) File option. TraceView requires only that the file is a text file, that each control GUID appears on a separate line in the file, and that the control GUID is the first text on the line. If you submit a file with a different format, TraceView accepts the file but does not enable providers that are not specified correctly.

The control GUID file can contain multiple control GUIDs. TraceView enables all of the providers whose control GUIDs appear in the file.

When creating a trace session with a control GUID, you can use the Tracing Flags and Levels Selection dialog box (which is described in Selecting Flags and Levels) only when TraceView can find a PDB symbol file for the provider or when it can find a trace message control (.tmc) file for the provider in the TMF path (specified by using the Set TMF Search Path option).

If the TMC file is not available, you can set the trace flags and level for the provider manually in the Advanced Trace Session Options dialog box. For instructions, see Setting Advanced Trace Session Options.

For information about specifying TMF files, see Select TMF Files and Set TMF Search Path.