AsyncCausalityTracer Class

Reference

Definition

Namespace:: Windows.Foundation.Diagnostics

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Enables tracing control flow across asynchronous operations.

public ref class AsyncCausalityTracer abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class AsyncCausalityTracer final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class AsyncCausalityTracer

Public Class AsyncCausalityTracer

Inheritance: Object Platform::Object IInspectable AsyncCausalityTracer

Attributes: ContractVersionAttribute MarshalingBehaviorAttribute

Windows requirements

Device family	Windows 10 (introduced in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v1.0)

Remarks

The AsyncCausalityTracer class provides methods that enable creating, propagating, and tracking causality as control flows across asynchronous operations. The causality is an abstraction for tracking both asynchronous and synchronous activities. You can use the collected data to develop causality graphs that are useful for debugging. Causality tracing uses event tracing for Windows (ETW) for logging.

Methods

TraceOperationCompletion(CausalityTraceLevel, CausalitySource, Guid, UInt64, AsyncStatus)	Indicates that a previously created asynchronous operation has completed all of its asynchronous work.
TraceOperationCreation(CausalityTraceLevel, CausalitySource, Guid, UInt64, String, UInt64)	Logs the creation of an asynchronous operation.
TraceOperationRelation(CausalityTraceLevel, CausalitySource, Guid, UInt64, CausalityRelation)	Logs the relation between the currently running synchronous work item and a specific asynchronous operation that it's related to.
TraceSynchronousWorkCompletion(CausalityTraceLevel, CausalitySource, CausalitySynchronousWork)	Indicates that the most recently created synchronous work item running on the thread that the TraceSynchronousWorkCompletion method is called on has completed.
TraceSynchronousWorkStart(CausalityTraceLevel, CausalitySource, Guid, UInt64, CausalitySynchronousWork)	Indicates that the specified asynchronous operation is scheduling synchronous work on the thread that the TraceSynchronousWorkStart method is called on.

Events

TracingStatusChanged

Raised when a client starts listening to the causality trace.

Applies to

Share via