AsyncCausalityTracer class

Applies to Windows and Windows Phone

Enables tracing control flow across asynchronous operations.

Syntax


var asyncCausalityTracer = Windows.Foundation.Diagnostics.AsyncCausalityTracer;

Attributes

[MarshalingBehavior(Agile)]
[Version(0x06030000)]

Members

The AsyncCausalityTracer class has these types of members:

Events

The AsyncCausalityTracer class has these events.

EventDescription
TracingStatusChanged Raised when a client starts listening to the causality trace.

 

Methods

The AsyncCausalityTracer class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.

MethodDescription
TraceOperationCompletion Indicates that a previously created asynchronous operation has completed all of its asynchronous work.
TraceOperationCreation Logs the creation of an asynchronous operation.
TraceOperationRelation Logs the relation between the currently running synchronous work item and a specific asynchronous operation that it's related to.
TraceSynchronousWorkCompletion Indicates that the most recently created synchronous work item running on the thread that the TraceSynchronousWorkCompletion method is called on has completed.
TraceSynchronousWorkStart Indicates that the specified asynchronous operation is scheduling synchronous work on the thread that the TraceSynchronousWorkStart method is called on.

 

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.

Requirements

Minimum supported client

Windows 8.1 [Windows Store apps only]

Minimum supported server

Windows Server 2012 R2 [Windows Store apps only]

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.Foundation.Diagnostics
Windows::Foundation::Diagnostics [C++]

Metadata

Windows.winmd

See also

CausalityRelation
CausalitySource
CausalitySynchronousWork
CausalityTraceLevel
Object

 

 

Show:
© 2014 Microsoft