AsyncCausalityTracer AsyncCausalityTracer AsyncCausalityTracer AsyncCausalityTracer AsyncCausalityTracer Class

Definition

Enables tracing control flow across asynchronous operations.

public : static class AsyncCausalityTracer
static struct winrt::Windows::Foundation::Diagnostics::AsyncCausalityTracer
public static class AsyncCausalityTracer
Public Shared Class AsyncCausalityTracer
// This class does not provide a public constructor.
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

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) TraceOperationCompletion(CausalityTraceLevel, CausalitySource, Guid, UInt64, AsyncStatus) TraceOperationCompletion(CausalityTraceLevel, CausalitySource, Guid, UInt64, AsyncStatus) TraceOperationCompletion(CausalityTraceLevel, CausalitySource, Guid, UInt64, AsyncStatus) 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) TraceOperationCreation(CausalityTraceLevel, CausalitySource, Guid, UInt64, String, UInt64) TraceOperationCreation(CausalityTraceLevel, CausalitySource, Guid, UInt64, String, UInt64) TraceOperationCreation(CausalityTraceLevel, CausalitySource, Guid, UInt64, String, UInt64) TraceOperationCreation(CausalityTraceLevel, CausalitySource, Guid, UInt64, String, UInt64)

Logs the creation of an asynchronous operation.

TraceOperationRelation(CausalityTraceLevel, CausalitySource, Guid, UInt64, CausalityRelation) TraceOperationRelation(CausalityTraceLevel, CausalitySource, Guid, UInt64, CausalityRelation) TraceOperationRelation(CausalityTraceLevel, CausalitySource, Guid, UInt64, CausalityRelation) TraceOperationRelation(CausalityTraceLevel, CausalitySource, Guid, UInt64, CausalityRelation) 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) TraceSynchronousWorkCompletion(CausalityTraceLevel, CausalitySource, CausalitySynchronousWork) TraceSynchronousWorkCompletion(CausalityTraceLevel, CausalitySource, CausalitySynchronousWork) TraceSynchronousWorkCompletion(CausalityTraceLevel, CausalitySource, CausalitySynchronousWork) 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) TraceSynchronousWorkStart(CausalityTraceLevel, CausalitySource, Guid, UInt64, CausalitySynchronousWork) TraceSynchronousWorkStart(CausalityTraceLevel, CausalitySource, Guid, UInt64, CausalitySynchronousWork) TraceSynchronousWorkStart(CausalityTraceLevel, CausalitySource, Guid, UInt64, CausalitySynchronousWork) 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 TracingStatusChanged TracingStatusChanged TracingStatusChanged TracingStatusChanged

Raised when a client starts listening to the causality trace.

See Also