class TraceSession
Defined at line 43 of file ../../src/performance/trace_manager/trace_session.h
TraceSession keeps track of all TraceProvider instances that
are active for a tracing session.
Public Methods
void TraceSession (async::Executor & executor, std::shared_ptr<BufferForwarder> destination, std::vector<std::string> categories, size_t buffer_size_megabytes, fuchsia_tracing::BufferingMode buffering_mode, TraceProviderSpecMap && provider_specs, zx::duration start_timeout, zx::duration stop_timeout, fuchsia_tracing_controller::FxtVersion fxt_version, fit::closure abort_handler, AlertCallback alert_callback)Initializes a new session that streams results to |destination|.
Every provider active in this session is handed |categories| and a vmo of size
|buffer_size_megabytes| when started.
|abort_handler| is invoked whenever the session encounters
unrecoverable errors that render the session dead.
Defined at line 31 of file ../../src/performance/trace_manager/trace_session.cc
void ~TraceSession ()Frees all allocated resources and closes the outgoing
connection.
Defined at line 52 of file ../../src/performance/trace_manager/trace_session.cc
State state ()For testing.
Defined at line 91 of file ../../src/performance/trace_manager/trace_session.h
void set_write_results_on_terminate (bool flag)Defined at line 93 of file ../../src/performance/trace_manager/trace_session.h
void WriteTraceInfo ()Writes all applicable trace info records.
These records are like a pre-amble to the trace, in particular they
provide a record at the start of the trace that when written to a file
can be used to identify the file as a Fuchsia Trace File.
Defined at line 846 of file ../../src/performance/trace_manager/trace_session.cc
void AddProvider (TraceProviderBundle * provider)Initializes |provider| and adds it to this session.
Defined at line 58 of file ../../src/performance/trace_manager/trace_session.cc
void AddProvider (ProviderConnection * provider)Initializes a v2 |provider| and adds it to this session.
Defined at line 133 of file ../../src/performance/trace_manager/trace_session.cc
void MarkInitialized ()Called after all registered providers have been added.
Defined at line 231 of file ../../src/performance/trace_manager/trace_session.cc
void Terminate (fit::closure callback)Terminates the trace.
Stops tracing first if necessary (see |Stop()|).
If terminating providers takes longer than |stop_timeout_|, we forcefully
terminate tracing and invoke |callback|.
Defined at line 233 of file ../../src/performance/trace_manager/trace_session.cc
void Start (fuchsia_tracing::BufferDisposition buffer_disposition, const std::vector<std::string> & additional_categories, StartTracingCallback callback)Starts the trace.
Invokes |callback| when all providers in this session have
acknowledged the start request, or after |start_timeout_| has elapsed.
Defined at line 258 of file ../../src/performance/trace_manager/trace_session.cc
void Stop (bool write_results, StopTracingCallback callback)Stops all providers that are part of this session, streams out
all remaining trace records and finally invokes |callback|.
If |write_results| is true then trace results are written after
providers stop (and a flag is set to clear buffer contents if tracing
starts again).
If stopping providers takes longer than |stop_timeout_|, we forcefully
stop tracing and invoke |callback|.
Defined at line 302 of file ../../src/performance/trace_manager/trace_session.cc
void RemoveDeadProvider (TraceProviderBundle * bundle)Remove |provider|, it's dead Jim.
Defined at line 771 of file ../../src/performance/trace_manager/trace_session.cc
void RemoveDeadV2Provider (ProviderConnection * connection)Defined at line 779 of file ../../src/performance/trace_manager/trace_session.cc
Enumerations
enum State| Name | Value |
|---|---|
| kReady | 0 |
| kInitialized | 1 |
| kStarting | 2 |
| kStarted | 3 |
| kStopping | 4 |
| kStopped | 5 |
| kTerminating | 6 |
Defined at line 45 of file ../../src/performance/trace_manager/trace_session.h
Friends
std::ostream & TraceSession (std::ostream & outTraceSession::State state)