System.Diagnostics.Tracing

Specifies the tracking of activity start and stop events.

Allow overlapping activities. By default, activity starts and stops must be property nested. That is, a sequence of Start A, Start B, Stop A, Stop B is not allowed will result in B stopping at the same time as A.

Turn off start and stop tracking.

Use the default behavior for start and stop tracking.

Allow recursive activity starts. By default, an activity cannot be recursive. That is, a sequence of Start A, Start A, Stop A, Stop A is not allowed. Unintentional recursive activities can occur if the app executes and for some the stop is not reached before another start is called.

Specifies additional event schema information for an event.

Initializes a new instance of the class with the specified event identifier.

The event identifier for the event.

Specifies the behavior of the start and stop events of an activity. An activity is the region of time in an app between the start and the stop.

Returns .

Gets or sets an additional event log where the event should be written.

An additional event log where the event should be written.

Gets or sets the identifier for the event.

The event identifier. This value should be between 0 and 65535.

Gets or sets the keywords for the event.

A bitwise combination of the enumeration values.

Gets or sets the level for the event.

One of the enumeration values that specifies the level for the event.

Gets or sets the message for the event.

The message for the event.

Gets or sets the operation code for the event.

One of the enumeration values that specifies the operation code.

Gets and sets the value for this object. An event tag is a user-defined value that is passed through when the event is logged.

Returns the value.

Gets or sets the task for the event.

The task for the event.

Gets or sets the version of the event.

The version of the event.

Specifies the event log channel for the event.

The administrator log channel.

The analytic channel.

The debug channel.

No channel specified.

The operational channel.

Describes the command ( property) that is passed to the callback.

Disable the event.

Enable the event.

Send the manifest.

Update the event.

Provides the arguments for the callback.

Gets the array of arguments for the callback.

An array of callback arguments.

Gets the command for the callback.

The callback command.

Disables the event that have the specified identifier.

true if is in range; otherwise, false. The identifier of the event to disable.

Enables the event that has the specified identifier.

true if is in range; otherwise, false. The identifier of the event to enable.

Specifies a type to be passed to the method.

Initializes a new instance of the class.

Gets or set the name to apply to an event if the event type or property is not explicitly named.

The name to apply to the event or property.

The is placed on fields of user-defined types that are passed as payloads.

Initializes a new instance of the class.

Gets and sets the value that specifies how to format the value of a user-defined type.

Returns a value.

Gets and sets the user-defined value that is required for fields that contain data that isn't one of the supported types.

Returns .

Specifies how to format the value of a user-defined type and can be used to override the default formatting for a field.

Boolean

Default.

Hexadecimal.

HResult.

JSON.

String.

XML.

Specifies the user-defined tag that is placed on fields of user-defined types that are passed as payloads through the .

Specifies no tag and is equal to zero.

Specifies a property should be ignored when writing an event type with the method.

Initializes a new instance of the class.

Defines the standard keywords that apply to events.

All the bits are set to 1, representing every possible group of events.

Attached to all failed security audit events. Use this keyword only for events in the security log.

Attached to all successful security audit events. Use this keyword only for events in the security log.

Attached to transfer events where the related activity ID (correlation ID) is a computed value and is not guaranteed to be unique (that is, it is not a real GUID).

Attached to events that are raised by using the RaiseEvent function.

No filtering on keywords is performed when the event is published.

Attached to all Service Quality Mechanism (SQM) events.

Attached to all Windows Diagnostics Infrastructure (WDI) context events.

Attached to all Windows Diagnostics Infrastructure (WDI) diagnostic events.

Identifies the level of an event.

This level corresponds to a critical error, which is a serious error that has caused a major failure.

This level adds standard errors that signify a problem.

This level adds informational events or messages that are not errors. These events can help trace the progress or state of an application.

No level filtering is done on the event.

This level adds lengthy events or messages. It causes all events to be logged.

This level adds warning events (for example, events that are published because a disk is nearing full capacity).

Provides methods for enabling and disabling events from event sources.

Creates a new instance of the class.

Disables all events for the specified event source.

The event source to disable events for.

Releases the resources used by the current instance of the class.

Enables events for the specified event source that has the specified verbosity level or lower.

The event source to enable events for. The level of events to enable.

Enables events for the specified event source that has the specified verbosity level or lower, and matching keyword flags.

The event source to enable events for. The level of events to enable. The keyword flags necessary to enable the events.

Enables events for the specified event source that has the specified verbosity level or lower, matching event keyword flag, and matching arguments.

The event source to enable events for. The level of events to enable. The keyword flags necessary to enable the events. The arguments to be matched to enable the events.

Gets a small non-negative number that represents the specified event source.

A small non-negative number that represents the specified event source. The event source to find the index for.

Called for all existing event sources when the event listener is created and when a new event source is attached to the listener.

The event source.

Called whenever an event has been written by an event source for which the event listener has enabled events.

The event arguments that describe the event.

Specifies how the ETW manifest for the event source is generated.

Generates a resources node under the localization folder for every satellite assembly provided.

Overrides the default behavior that the current must be the base class of the user-defined type passed to the write method. This enables the validation of .NET event sources.

No options are specified.

A manifest is generated only the event source must be registered on the host computer.

Causes an exception to be raised if any inconsistencies occur when writing the manifest file.

Defines the standard operation codes that the event source attaches to events.

A trace collection start event.

A trace collection stop event.

An extension event.

An informational event.

An event that is published when one activity in an application receives data.

An event that is published after an activity in an application replies to an event.

An event that is published after an activity in an application resumes from a suspended state. The event should follow an event that has the operation code.

An event that is published when one activity in an application transfers data or system resources to another activity.

An event that is published when an application starts a new transaction or activity. This operation code can be embedded within another transaction or activity when multiple events that have the code follow each other without an intervening event that has a code.

An event that is published when an activity or a transaction in an application ends. The event corresponds to the last unpaired event that has a operation code.

An event that is published when an activity in an application is suspended.

Provides the ability to create events for event tracing for Windows (ETW).

Creates a new instance of the class.

Creates a new instance of the class and specifies whether to throw an exception when an error occurs in the underlying Windows code.

true to throw an exception when an error occurs in the underlying Windows code; otherwise, false.

Creates a new instance of the class with the specified configuration settings.

A bitwise combination of the enumeration values that specify the configuration settings to apply to the event source.

Initializes a new instance of the to be used with non-contract events that contains the specified settings and traits.

A bitwise combination of the enumeration values that specify the configuration settings to apply to the event source. The key-value pairs that specify traits for the event source. is not specified in key-value pairs.

Creates a new instance of the class with the specified name.

The name to apply to the event source. Must not be null. is null.

Creates a new instance of the class with the specified name and settings.

The name to apply to the event source. Must not be null. A bitwise combination of the enumeration values that specify the configuration settings to apply to the event source. is null. is null.

Creates a new instance of the class with the specified configuration settings.

The name to apply to the event source. Must not be null. A bitwise combination of the enumeration values that specify the configuration settings to apply to the event source. The key-value pairs that specify traits for the event source. is null. is not specified in key-value pairs.

[Supported in the .NET Framework 4.5.1 and later versions] Gets any exception that was thrown during the construction of the event source.

The exception that was thrown during the construction of the event source, or null if no exception was thrown.

[Supported in the .NET Framework 4.5.1 and later versions] Gets the activity ID of the current thread.

The activity ID of the current thread.

Releases all resources used by the current instance of the class.

Releases the unmanaged resources used by the class and optionally releases the managed resources.

true to release both managed and unmanaged resources; false to release only unmanaged resources.

Allows the object to attempt to free resources and perform other cleanup operations before the object is reclaimed by garbage collection.

Returns a string of the XML manifest that is associated with the current event source.

The XML data string. The type of the event source. The path to the assembly file (.dll) to include in the provider element of the manifest.

Returns a string of the XML manifest that is associated with the current event source.

The XML data string or null (see remarks). The type of the event source. The path to the assembly file (.dll) file to include in the provider element of the manifest. A bitwise combination of the enumeration values that specify how the manifest is generated.

Gets the unique identifier for this implementation of the event source.

A unique identifier for this event source type. The type of the event source.

Gets the friendly name of the event source.

The friendly name of the event source. The default is the simple name of the class. The type of the event source.

Gets a snapshot of all the event sources for the application domain.

An enumeration of all the event sources in the application domain.

Gets the trait value associated with the specified key.

The trait value associated with the specified key. If the key is not found, returns null. The key of the trait to get.

The unique identifier for the event source.

A unique identifier for the event source.

Determines whether the current event source is enabled.

true if the current event source is enabled; otherwise, false.

Determines whether the current event source that has the specified level and keyword is enabled.

true if the event source is enabled; otherwise, false. The level of the event source. The keyword of the event source.

Determines whether the current event source is enabled for events with the specified level, keywords and channel.

true if the event source is enabled for the specified event level, keywords and channel; otherwise, false.The result of this method is only an approximation of whether a particular event is active. Use it to avoid expensive computation for logging when logging is disabled. Event sources may have additional filtering that determines their activity.. The event level to check. An event source will be considered enabled when its level is greater than or equal to . The event keywords to check. The event channel to check.

The friendly name of the class that is derived from the event source.

The friendly name of the derived class. The default is the simple name of the class.

Called when the current event source is updated by the controller.

The arguments for the event.

Sends a command to a specified event source.

The event source to send the command to. The event command to send. The arguments for the event command.

[Supported in the .NET Framework 4.5.1 and later versions] Sets the activity ID on the current thread.

The current thread's new activity ID, or to indicate that work on the current thread is not associated with any activity.

[Supported in the .NET Framework 4.5.1 and later versions] Sets the activity ID on the current thread, and returns the previous activity ID.

The current thread's new activity ID, or to indicate that work on the current thread is not associated with any activity. When this method returns, contains the previous activity ID on the current thread.

Gets the settings applied to this event source.

The settings applied to this event source.

Obtains a string representation of the current event source instance.

The name and unique identifier that identify the current event source.

Writes an event without fields, but with the specified name and default options.

The name of the event to write. is null.

Writes an event without fields, but with the specified name and options.

The name of the event to write. The options such as level, keywords and operation code for the event. is null.

Writes an event with the specified name, event data and options.

The name of the event. The event options. The event data. This type must be an anonymous type or marked with the attribute. The type that defines the event and its associated data. This type must be an anonymous type or marked with the attribute.

Writes an event with the specified name, options, related activity and event data.

The name of the event. The event options. The ID of the activity associated with the event. The ID of an associated activity, or if there is no associated activity. The event data. This type must be an anonymous type or marked with the attribute. The type that defines the event and its associated data. This type must be an anonymous type or marked with the attribute.

Writes an event with the specified name, options and event data.

The name of the event. The event options. The event data. This type must be an anonymous type or marked with the attribute. The type that defines the event and its associated data. This type must be an anonymous type or marked with the attribute.

Writes an event with the specified name and data.

The name of the event. The event data. This type must be an anonymous type or marked with the attribute. The type that defines the event and its associated data. This type must be an anonymous type or marked with the attribute.

Writes an event by using the provided event identifier.

The event identifier. This value should be between 0 and 65535.

Writes an event by using the provided event identifier and byte array argument.

The event identifier. This value should be between 0 and 65535. A byte array argument.

Writes an event by using the provided event identifier and 32-bit integer argument.

The event identifier. This value should be between 0 and 65535. An integer argument.

Writes an event by using the provided event identifier and 32-bit integer arguments.

The event identifier. This value should be between 0 and 65535. An integer argument. An integer argument.

Writes an event by using the provided event identifier and 32-bit integer arguments.

The event identifier. This value should be between 0 and 65535. An integer argument. An integer argument. An integer argument.

Writes an event by using the provided event identifier and 32-bit integer and string arguments.

The event identifier. This value should be between 0 and 65535. A 32-bit integer argument. A string argument.

Writes an event by using the provided event identifier and 64-bit integer argument.

The event identifier. This value should be between 0 and 65535. A 64 bit integer argument.

Writes the event data using the specified indentifier and 64-bit integer and byte array arguments.

The event identifier. This value should be between 0 and 65535. A 64-bit integer argument. A byte array argument.

Writes an event by using the provided event identifier and 64-bit arguments.

The event identifier. This value should be between 0 and 65535. A 64 bit integer argument. A 64 bit integer argument.

Writes an event by using the provided event identifier and 64-bit arguments.

The event identifier. This value should be between 0 and 65535. A 64 bit integer argument. A 64 bit integer argument. A 64 bit integer argument.

Writes an event by using the provided event identifier and 64-bit integer, and string arguments.

The event identifier. This value should be between 0 and 65535. A 64-bit integer argument. A string argument.

Writes an event by using the provided event identifier and array of arguments.

The event identifier. This value should be between 0 and 65535. An array of objects.

Writes an event by using the provided event identifier and string argument.

The event identifier. This value should be between 0 and 65535. A string argument.

Writes an event by using the provided event identifier and arguments.

The event identifier. This value should be between 0 and 65535. A string argument. A 32 bit integer argument.

Writes an event by using the provided event identifier and arguments.

The event identifier. This value should be between 0 and 65535. A string argument. A 32 bit integer argument. A 32 bit integer argument.

Writes an event by using the provided event identifier and arguments.

The event identifier. This value should be between 0 and 65535. A string argument. A 64 bit integer argument.

Writes an event by using the provided event identifier and string arguments.

The event identifier. This value should be between 0 and 65535. A string argument. A string argument.

Writes an event by using the provided event identifier and string arguments.

The event identifier. This value should be between 0 and 65535. A string argument. A string argument. A string argument.

Creates a new overload by using the provided event identifier and event data.

The event identifier. The number of event data items. The structure that contains the event data.

[Supported in the .NET Framework 4.5.1 and later versions] Writes an event that indicates that the current activity is related to another activity.

An identifier that uniquely identifies this event within the . The related activity identifier. An array of objects that contain data about the event.

[Supported in the .NET Framework 4.5.1 and later versions] Writes an event that indicates that the current activity is related to another activity.

An identifier that uniquely identifies this event within the . A pointer to the GUID of the related activity ID. The number of items in the field. A pointer to the first item in the event data field.

Provides the event data for creating fast overloads by using the method.

Gets or sets the pointer to the data for the new overload.

The pointer to the data.

Gets or sets the number of payload items in the new overload.

The number of payload items in the new overload.

Allows the event tracing for Windows (ETW) name to be defined independently of the name of the event source class.

Initializes a new instance of the class.

Gets or sets the event source identifier.

The event source identifier.

Gets or sets the name of the localization resource file.

The name of the localization resource file, or null if the localization resource file does not exist.

Gets or sets the name of the event source.

The name of the event source.

The exception that is thrown when an error occurs during event tracing for Windows (ETW).

Initializes a new instance of the class.

Initializes a new instance of the class with a specified error message.

The message that describes the error.

Initializes a new instance of the class with a specified error message and a reference to the inner exception that is the cause of this exception.

The error message that explains the reason for the exception. The exception that is the cause of the current exception, or null if no inner exception is specified.

Specifies overrides of default event settings such as the log level, keywords and operation code when the method is called.

The activity options defined for this event source.

Returns .

Gets or sets the keywords applied to the event. If this property is not set, the event’s keywords will be None.

The keywords applied to the event, or None if no keywords are set.

Gets or sets the event level applied to the event.

The event level for the event. If not set, the default is Verbose (5).

Gets or sets the operation code to use for the specified event.

The operation code to use for the specified event. If not set, the default is Info (0).

The event tags defined for this event source.

Returns .

Specifies configuration options for an event source.

None of the special configuration options are enabled.

The ETW listener should use a manifest-based format when raising events. Setting this option is a directive to the ETW listener should use manifest-based format when raising events. This is the default option when defining a type derived from using one of the protected constructors.

The ETW listener should use self-describing event format. This is the default option when creating a new instance of the using one of the public constructors.

The event source throws an exception when an error occurs.

Specifies the tracking of activity start and stop events. You should only use the lower 24 bits. For more information, see and .

Specifies no tag and is equal to zero.

Defines the tasks that apply to events.

Undefined task.

Provides data for the callback.

[Supported in the .NET Framework 4.5.1 and later versions] Gets the activity ID on the thread that the event was written to.

The activity ID on the thread that the event was written to.

Gets the channel for the event.

The channel for the event.

Gets the event identifier.

The event identifier.

Gets the name of the event.

The name of the event.

Gets the event source object.

The event source object.

Gets the keywords for the event.

The keywords for the event.

Gets the level of the event.

The level of the event.

Gets the message for the event.

The message for the event.

Gets the operation code for the event.

The operation code for the event.

Gets the payload for the event.

The payload for the event.

Returns a list of strings that represent the property names of the event.

Returns .

[Supported in the .NET Framework 4.5.1 and later versions] Gets the identifier of an activity that is related to the activity represented by the current instance.

The identifier of the related activity, or if there is no related activity.

Returns the tags specified in the call to the method.

Returns .

Gets the task for the event.

The task for the event.

Gets the version of the event.

The version of the event.

Identifies a method that is not generating an event.

Creates a new instance of the class.