TraceSink
public final class TraceSink extends TraceSink
The trace sink that writes BufferedSink, to a new file per trace session.
This implementation converts androidx.tracing.TraceEvents into binary protos using the Wire library.
The outputs created by WireTraceSync can be visualized with ui.perfetto.dev, and queried by TraceProcessor from the androidx.benchmark:benchmark-traceprocessor library, the C++ tool it's built on, or the Python wrapper.
As binary protos embed strings as UTF-8, note that any strings serialized by WireTraceSink will be serialized as UTF-8.
To create a WireTraceSink for a File, you can use File("myFile").appendingSink().buffer().
Summary
Public constructors |
|---|
TraceSink( |
Public methods |
|
|---|---|
void |
close()Close the |
void |
enqueue(@NonNull PooledTracePacketArray pooledPacketArray)Enqueue a |
void |
flush()Flush any enqueued trace events to the |
void |
Called when the |
Public constructors
TraceSink
public TraceSink(
@IntRange(from = 1) int sequenceId,
@NonNull BufferedSink bufferedSink,
@NonNull CoroutineContext coroutineContext
)
Public methods
close
public void close()
Close the TraceSink, completing any enqueued writes.
This function may be called from any thread.
enqueue
public void enqueue(@NonNull PooledTracePacketArray pooledPacketArray)
Enqueue a PooledTracePacketArray to be written to the trace.
This function may be called from any thread.
flush
public void flush()
Flush any enqueued trace events to the TraceSink.
This function may be called from any thread.
onDroppedTraceEvent
public void onDroppedTraceEvent()
Called when the TraceSink cannot keep up with incoming trace events from Tracks.
This function may be called from any thread.