Struct TraceutilFacade

pub struct TraceutilFacade {}

Perform Traceutil operations.

Note this object is shared among all threads created by server.

This facade does not hold onto a Traceutil proxy as the server may be long-running while individual tests set up and tear down Traceutil.

WARNING: Use of this facade is discouraged as its functionality is only to download traces that were collected through other means (such as running the trace binary over ssh). Instead, see TracingFacade, which allows for control of the tracing system as well.

Implementations

impl TraceutilFacade

pub fn new() -> TraceutilFacade

pub async fn get_trace_file(&self, args: Value) -> Result<Value, Error>

Gets data from the specified path starting from an optional offset.

Loading and returning the entire file is problematic for large trace files, so will return up to |MAX_CHUNK_SIZE| bytes at once. The bytes of the file are returned in a field called |data|. If there is more data to read, then a field |next_offset| will be returned that indicates where it left off.

Trait Implementations

impl Debug for TraceutilFacade

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Facade for TraceutilFacade

fn handle_request<'life0, 'async_trait>( &'life0 self, method: String, args: Value, ) -> Pin<Box<dyn Future<Output = Result<Value, Error>> + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Asynchronously handle the incoming request for the given method and arguments, returning a future object representing the pending operation.

fn cleanup(&self)

In response to a request to /cleanup, cleanup any cross-request state.

fn print(&self)

In response to a request to /print, log relevant facade state.