public sealed class Trace : IMessage<Trace>, IEquatable<Trace>, IDeepCloneable<Trace>, IBufferMessage, IMessage
Reference documentation and code samples for the Network Management v1 API class Trace.
Trace represents one simulated packet forwarding path.
Each trace contains multiple ordered steps.
Each step is in a particular state with associated configuration.
State is categorized as final or non-final states.
Each final state has a reason associated.
Each trace must end with a final state (the last step).
|---------------------Trace----------------------|
Step1(State) Step2(State) --- StepN(State(final))
Derived from the source and destination endpoints definition specified by
user request, and validated by the data plane model.
If there are multiple traces starting from different source locations, then
the endpoint_info may be different between traces.
ID of trace. For forward traces, this ID is unique for each trace. For
return traces, it matches ID of associated forward trace. A single forward
trace can be associated with none, one or more than one return trace.
A trace of a test contains multiple steps from the initial state to the
final state (delivered, dropped, forwarded, or aborted).
The steps are ordered by the processing sequence within the simulated
network state machine. It is critical to preserve the order of the steps
and avoid reordering or sorting them.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-12 UTC."],[[["\u003cp\u003eThe latest version of the Network Management v1 API class Trace is 2.13.0, and the documentation provides access to versions ranging from 1.0.0 to 2.13.0.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eTrace\u003c/code\u003e class represents a simulated packet forwarding path within the network, containing multiple ordered steps, each with a particular state and configuration.\u003c/p\u003e\n"],["\u003cp\u003eEach \u003ccode\u003eTrace\u003c/code\u003e instance contains steps that are categorized into final or non-final states, with each final state having an associated reason, and the trace always ending with a final state.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eTrace\u003c/code\u003e class offers properties such as \u003ccode\u003eEndpointInfo\u003c/code\u003e, \u003ccode\u003eForwardTraceId\u003c/code\u003e, and \u003ccode\u003eSteps\u003c/code\u003e to provide detailed information about the network trace.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eTrace\u003c/code\u003e class inherits from \u003ccode\u003eobject\u003c/code\u003e and implements multiple interfaces including \u003ccode\u003eIMessage\u003c/code\u003e, \u003ccode\u003eIEquatable\u003c/code\u003e, \u003ccode\u003eIDeepCloneable\u003c/code\u003e, and \u003ccode\u003eIBufferMessage\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,[]]
