UDocumentation UE5.7 10.02.2026 (Source)
API documentation for Unreal Engine 5.7
NetTrace.h
Go to the documentation of this file.
1// Copyright Epic Games, Inc. All Rights Reserved.
2
3#pragma once
4
6
7#if UE_NET_TRACE_ENABLED
8
10#define UE_NET_TRACE_CREATE_COLLECTOR(Verbosity) UE_NET_TRACE_INTERNAL_CREATE_COLLECTOR(Verbosity)
11
13#define UE_NET_TRACE_DESTROY_COLLECTOR(Collector) FNetTrace::DestroyTraceCollector(Collector)
14
20#define UE_NET_TRACE_SCOPE(Name, Stream, Collector, Verbosity) UE_NET_TRACE_INTERNAL_SCOPE(Name, Stream, Collector, Verbosity)
21
23#define UE_NET_TRACE_OBJECT_SCOPE(HandleOrNetGUID, Stream, Collector, Verbosity) UE_NET_TRACE_INTERNAL_OBJECT_SCOPE(HandleOrNetGUID, Stream, Collector, Verbosity)
24
26#define UE_NET_TRACE_DYNAMIC_NAME_SCOPE(Name, Stream, Collector, Verbosity) UE_NET_TRACE_INTERNAL_DYNAMIC_NAME_SCOPE(Name, Stream, Collector, Verbosity)
27
34#define UE_NET_TRACE_NAMED_SCOPE(ScopeName, EventName, Stream, Collector, Verbosity) UE_NET_TRACE_INTERNAL_NAMED_SCOPE(ScopeName, EventName, Stream, Collector, Verbosity)
35
37#define UE_NET_TRACE_NAMED_OBJECT_SCOPE(ScopeName, HandleOrNetGUID, Stream, Collector, Verbosity) UE_NET_TRACE_INTERNAL_NAMED_OBJECT_SCOPE(ScopeName, HandleOrNetGUID, Stream, Collector, Verbosity)
38
40#define UE_NET_TRACE_NAMED_DYNAMIC_NAME_SCOPE(ScopeName, EventName, Stream, Collector, Verbosity) UE_NET_TRACE_INTERNAL_NAMED_DYNAMIC_NAME_SCOPE(ScopeName, EventName, Stream, Collector, Verbosity)
41
43#define UE_NET_TRACE_SET_SCOPE_NAME(ScopeName, EventName) UE_NET_TRACE_INTERNAL_SET_SCOPE_NAME(ScopeName, EventName)
44
46#define UE_NET_TRACE_SET_SCOPE_OBJECTID(ScopeName, HandleOrNetGUID) UE_NET_TRACE_INTERNAL_SET_SCOPE_OBJECTID(ScopeName, HandleOrNetGUID)
47
49#define UE_NET_TRACE_EXIT_NAMED_SCOPE(ScopeName) UE_NET_TRACE_INTERNAL_EXIT_NAMED_SCOPE(ScopeName)
50
55#define UE_NET_TRACE_OFFSET_SCOPE(Offset, Collector) UE_NET_TRACE_INTERNAL_OFFSET_SCOPE(Offset, Collector)
56
58#define UE_NET_TRACE(Name, Collector, StartPos, EndPos, Verbosity) UE_NET_TRACE_INTERNAL(Name, Collector, StartPos, EndPos, Verbosity)
59
61#define UE_NET_TRACE_DYNAMIC_NAME(Name, Collector, StartPos, EndPos, Verbosity) UE_NET_TRACE_INTERNAL_DYNAMIC_NAME(Name, Collector, StartPos, EndPos, Verbosity)
62
64#define UE_NET_TRACE_FLUSH_COLLECTOR(Collector, ...) UE_NET_TRACE_INTERNAL_FLUSH_COLLECTOR(Collector, __VA_ARGS__)
65
67#define UE_NET_TRACE_BEGIN_BUNCH(Collector) UE_NET_TRACE_INTERNAL_BEGIN_BUNCH(Collector)
68
70#define UE_NET_TRACE_DISCARD_BUNCH(Collector) UE_NET_TRACE_INTERNAL_DISCARD_BUNCH(Collector)
71
73#define UE_NET_TRACE_POP_SEND_BUNCH(Collector) UE_NET_TRACE_INTERNAL_POP_SEND_BUNCH(Collector)
74
76#define UE_NET_TRACE_EVENTS(DstCollector, SrcCollector, Stream) UE_NET_TRACE_INTERNAL_EVENTS(DstCollector, SrcCollector, Stream)
77
79#define UE_NET_TRACE_END_BUNCH(Collector, Bunch, ...) UE_NET_TRACE_INTERNAL_END_BUNCH(Collector, Bunch, __VA_ARGS__)
80
82#define UE_NET_TRACE_BUNCH_SCOPE(Collector, Bunch, ...) UE_NET_TRACE_INTERNAL_BUNCH_SCOPE(Collector, Bunch, __VA_ARGS__)
83
85#define UE_NET_TRACE_ASSIGNED_GUID(GameInstanceId, NetGUID, PathName, OwnerId) UE_NET_TRACE_INTERNAL_ASSIGNED_GUID(GameInstanceId, NetGUID, PathName, OwnerId)
86
88#define UE_NET_TRACE_NETHANDLE_CREATED(Handle, DebugName, ProtocolId, OwnerId) UE_NET_TRACE_INTERNAL_NETHANDLE_CREATED(Handle, DebugName, ProtocolId, OwnerId)
89
91#define UE_NET_TRACE_NETHANDLE_DESTROYED(Handle) UE_NET_TRACE_INTERNAL_NETHANDLE_DESTROYED(Handle)
92
94#define UE_NET_TRACE_CONNECTION_CREATED(...) UE_NET_TRACE_INTERNAL_CONNECTION_CREATED(__VA_ARGS__)
95
97#define UE_NET_TRACE_CONNECTION_STATE_UPDATED(...) UE_NET_TRACE_INTERNAL_CONNECTION_STATE_UPDATED(__VA_ARGS__)
98
100#define UE_NET_TRACE_CONNECTION_UPDATED(...) UE_NET_TRACE_INTERNAL_CONNECTION_UPDATED(__VA_ARGS__)
101
103#define UE_NET_TRACE_PACKET_STATSCOUNTER(GameInstanceId, ConnectionId, Name, StatValue, Verbosity) UE_NET_TRACE_INTERNAL_PACKET_STATSCOUNTER(GameInstanceId, ConnectionId, Name, StatValue, Verbosity)
104
106#define UE_NET_TRACE_FRAME_STATSCOUNTER(GameInstanceId, Name, StatValue, Verbosity) UE_NET_TRACE_INTERNAL_FRAME_STATSCOUNTER(GameInstanceId, Name, StatValue, Verbosity)
107
109#define UE_NET_TRACE_CONNECTION_CLOSED(...) UE_NET_TRACE_INTERNAL_CONNECTION_CLOSED(__VA_ARGS__)
110
112#define UE_NET_TRACE_PACKET_DROPPED(...) UE_NET_TRACE_INTERNAL_PACKET_DROPPED(__VA_ARGS__)
113
115#define UE_NET_TRACE_PACKET_SEND(...) UE_NET_TRACE_INTERNAL_PACKET_SEND(__VA_ARGS__)
116
118#define UE_NET_TRACE_PACKET_RECV(...) UE_NET_TRACE_INTERNAL_PACKET_RECV(__VA_ARGS__)
119
121#define UE_NET_TRACE_END_SESSION(GameInstanceId) UE_NET_TRACE_INTERNAL_END_SESSION(GameInstanceId)
122
124#define UE_NET_TRACE_UPDATE_INSTANCE(...) UE_NET_TRACE_INTERNAL_UPDATE_INSTANCE(__VA_ARGS__)
125
126#define UE_NET_TRACE_POLL_OBJECT_SCOPE(...) UE_NET_TRACE_INTERNAL_POLL_OBJECT_SCOPE(__VA_ARGS__)
127#define UE_NET_TRACE_POLL_OBJECT_IS_WASTE() UE_NET_TRACE_INTERNAL_POLL_OBJECT_IS_WASTE
128#define UE_NET_TRACE_QUANTIZE_OBJECT_SCOPE(...) UE_NET_TRACE_INTERNAL_QUANTIZE_OBJECT_SCOPE(__VA_ARGS__)
129#define UE_NET_TRACE_WRITE_OBJECT_SCOPE(...) UE_NET_TRACE_INTERNAL_WRITE_OBJECT_SCOPE(__VA_ARGS__)
130
131#define UE_NET_TRACE_SUBOBJECT(ParentHandle, SubObjectHandle) UE_NET_TRACE_INTERNAL_SUBOBJECT(ParentHandle, SubObjectHandle)
132
133#else
134
135#define UE_NET_TRACE_SCOPE(...)
136#define UE_NET_TRACE_OBJECT_SCOPE(...)
137#define UE_NET_TRACE_DYNAMIC_NAME_SCOPE(...)
138#define UE_NET_TRACE_NAMED_SCOPE(...)
139#define UE_NET_TRACE_SET_SCOPE_NAME(...)
140#define UE_NET_TRACE_SET_SCOPE_OBJECTID(...)
141#define UE_NET_TRACE_EXIT_NAMED_SCOPE(...)
142#define UE_NET_TRACE(...)
143#define UE_NET_TRACE_DYNAMIC_NAME(...)
144#define UE_NET_TRACE_CREATE_COLLECTOR(...) nullptr
145#define UE_NET_TRACE_DESTROY_COLLECTOR(...)
146
147#define UE_NET_TRACE_FLUSH_COLLECTOR(...)
148#define UE_NET_TRACE_BEGIN_BUNCH(...)
149#define UE_NET_TRACE_DISCARD_BUNCH(...)
150#define UE_NET_TRACE_POP_SEND_BUNCH(...)
151#define UE_NET_TRACE_EVENTS(...)
152#define UE_NET_TRACE_END_BUNCH(...)
153#define UE_NET_TRACE_BUNCH_SCOPE(...)
154#define UE_NET_TRACE_OFFSET_SCOPE(...)
155
156#define UE_NET_TRACE_ASSIGNED_GUID(...)
157#define UE_NET_TRACE_NETHANDLE_CREATED(...)
158#define UE_NET_TRACE_NETHANDLE_DESTROYED(...)
159#define UE_NET_TRACE_CONNECTION_CREATED(...)
160#define UE_NET_TRACE_CONNECTION_STATE_UPDATED(...)
161#define UE_NET_TRACE_CONNECTION_UPDATED(...)
162#define UE_NET_TRACE_CONNECTION_CLOSED(...)
163#define UE_NET_TRACE_PACKET_DROPPED(...)
164#define UE_NET_TRACE_NAMED_OBJECT_SCOPE(...)
165#define UE_NET_TRACE_NAMED_DYNAMIC_NAME_SCOPE(...)
166
167#define UE_NET_TRACE_PACKET_STATSCOUNTER(...)
168#define UE_NET_TRACE_FRAME_STATSCOUNTER(...)
169
170#define UE_NET_TRACE_PACKET_DROPPED(...)
171#define UE_NET_TRACE_PACKET_SEND(...)
172#define UE_NET_TRACE_PACKET_RECV(...)
173
174#define UE_NET_TRACE_END_SESSION(...)
175
176#define UE_NET_TRACE_UPDATE_INSTANCE(...)
177
178#define UE_NET_TRACE_POLL_OBJECT_SCOPE(...)
179#define UE_NET_TRACE_POLL_OBJECT_IS_WASTE()
180#define UE_NET_TRACE_QUANTIZE_OBJECT_SCOPE(...)
181#define UE_NET_TRACE_WRITE_OBJECT_SCOPE(...)
182
183#define UE_NET_TRACE_SUBOBJECT(...)
184
185#endif // UE_NET_TRACE_ENABLED