2.2.4.2.2.4 Trace

The Trace complex type represents a trace object. A trace consists of a set of server events that a client can subscribe to by using the Subscribe command.

   <xsd:complexType name="Trace">
     <xsd:all>
       <!--These elements are common to each MajorObject-->
       <xsd:element name="Name"  type="xsd:string" />
       <xsd:element name="ID"  type="xsd:string" minOccurs="0" />
       <xsd:element name="CreatedTimestamp" type="xsd:dateTime" minOccurs="0" />
       <xsd:element name="LastSchemaUpdate" type="xsd:dateTime" minOccurs="0" />
       <xsd:element name="Description" type="xsd:string" minOccurs="0" />
       <xsd:element name="Annotations"  minOccurs="0" >
         <xsd:complexType>
           <xsd:sequence>
             <xsd:element name="Annotation" type="Annotation" minOccurs="0"
                          maxOccurs="unbounded" />
           </xsd:sequence>
         </xsd:complexType>
       </xsd:element>
       <!--Extended elements for Trace object-->
       <xsd:element name="LogFileName" type="xsd:string" minOccurs="0"/>
       <xsd:element name="LogFileAppend" type="xsd:boolean" minOccurs="0"/>
       <xsd:element name="LogFileSize" type="xsd:long"  minOccurs="0" />
       <xsd:element name="Audit" type="xsd:boolean" minOccurs="0"/>
       <xsd:element name="LogFileRollover" type="xsd:boolean" minOccurs="0"/>
       <xsd:element name="AutoRestart" type="xsd:boolean" minOccurs="0"/>
       <xsd:element name="StopTime" type="xsd:dateTime" minOccurs="0"/>
       <xsd:element name="Filter" type="TraceFilter"  minOccurs="0" />
       <xsd:choice maxOccurs="1" minOccurs="1">
         <xsd:element name="Events" >
           <xsd:complexType>
             <xsd:sequence>
               <xsd:element name="Event"  type="Event" minOccurs="0"
                            maxOccurs="unbounded"/>
             </xsd:sequence>
           </xsd:complexType>
         </xsd:element>
         <xsd:element ref="eng300_300:XEvent" minOccurs="0" />
       </xsd:choice>
     </xsd:all>
   </xsd:complexType>

The Trace XSD depends upon the following definition in namespaces other than the default namespace.

In the namespace eng300_300:

 <xsd:element name="XEvent">
    <xsd:complexType>
     <xsd:element name="event_session"/>
   </xsd:complexType>
 </xsd:element>

The following table describes the elements that are included in the XSD schema for Trace.

Element	Read-Only	Default value	Description
LogFileName		Empty	The file name for the log file. LogFileName MUST contain the .trc file name extension.
LogFileAppend		False	When true, indicates to append to the existing log file; otherwise, false.
LogFileSize		0	An integer that sets maximum file size in MB. If zero or negative, it means no maximum size.<53>
Audit		False	When true, indicates that a Trace element is not allowed to drop events, even if this results in degraded performance on the server; otherwise, false.
LogFileRollover		False	A Boolean that indicates what to do if LogFileSize is exceeded. If true, a new file is started; if false, logging stops.
AutoRestart		False	When true, performs a Trace auto restart with service stop/start; otherwise, false.
StopTime		No stop time	The time that the server will stop logging to the Trace log file.
Filter		Empty	A complex XML type that specifies a logical condition that will determine whether the event is included in Trace output.<54>
Events			A collection of Event objects. This element is required if XEvent is not specified.
XEvent			An optional element that can be specified if the client code wants to subscribe to get information in XEvent format.