Share via


AsyncCausalityTracer Class

Definition

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

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

See also