What Are the XMLTracer Trace Levels?
The XMLTracer pipeline component is inactive until tracing is enabled. This makes it convenient to capture information about intermittent problems on a server. You use the –flags parameter of tracelog.exe to specify trace levels as a bitwise OR value or as specified bit values. Tracelog.exe is a command-line tool used to enable and disable tracing.
XMLTracer responds to the following levels of debug tracing:
0x4 — Enable XMLTracer. If this bit is not set, XMLTracer immediately returns without taking any action. If this is the only bit set, then keys with underscore (_) prefixes are not dumped.
0x8 — Include top-level keys with underscore prefixes. This bit tells XMLTracer that keys with underscore prefixes should be dumped in the top-level Dictionary or OrderForm object. Underscore-prefixed keys in descendent dictionaries are not traced. This bit has no effect unless it is used with the 0x4 bit.
Note
When this bit or the 0x10 bit is set, the prefixes in the dictionaries are temporarily changed, and then later reset to underscores.
0x10 — Include all keys with underscore prefixes. This bit tells XMLTracer that keys with underscore prefixes should be dumped recursively in the top-level dictionary and all descendent dictionaries. For example, you can use this bit to see all the keys set by the QueryCatalogInfo component in each line item dictionary. This bit has no effect unless it is used with the 0x4 and 0x8 bits.
0x20 — Include ContentList objects. This bit tells XMLTracer to include the contents of the _Discounts or _Content ContentList objects (for Basket and Content Selection Framework (CSF) pipelines respectively) in the trace. If this bit is not set, then the default behavior is to skip ContentList objects because they can be quite large. This bit has no effect unless it is used with the 0x4 and 0x8 bits.
The following table shows flag values that result from using the logical OR operator to specify multiple flags.
Flag Value |
Description |
|---|---|
0x4 |
Perform only minimal tracing. |
0xC |
Include top-level keys with underscore prefixes. |
0x1C |
Include all keys with underscore prefixes at all levels. |
0x2C |
Include top-level keys with underscore prefixes and include ContentList objects. |
0x3C |
Include all keys with underscore prefixes and include ContentList objects. |
You can use a –flags value of 255 (0xFF) to enable all trace levels. However, the XMLTracer component uses only the bit values listed above.