Flamegrapher

Struct Flamegrapher 

Source
pub struct Flamegrapher { /* private fields */ }
Expand description

Helper struct that uses inferno internally to programatically produce a flamegraph from a folded stack trace file.

Implementations§

Source§

impl Flamegrapher

Source

pub fn new() -> Self

Creates a new Flamegrapher with no associated files.

Source

pub fn with_stack_file<P: AsRef<Path>>( self, stack_filename: P, ) -> Result<Self, Error>

Returns a Flamegrapher with the given folded stack file name.

§Errors

This method may fail in the following ways:

  • The given stack file does not exist.
Source

pub fn with_graph_file<P: AsRef<Path>>( self, graph_filename: P, ) -> Result<Self, Error>

Returns a Flamegrapher with the given flamegraph file name.

This file will be given the extension of .svg.

§Errors

This method may fail in the following ways:

  • The given graph filename is invalid (it does not belong to a directory that exists).
Source

pub fn write_flamegraph(&self) -> Result<(), Error>

Uses inferno to generate a flamegraph from the given folded stack file, and writes it to the given output image file.

§Errors

This method may fail in the following ways:

  • This Flamegrapher does not have a stack or graph file associated with it.
  • An error was encountered when opening the folded stack file for reading.
  • An error was encountered when creating the graph file.

Trait Implementations§

Source§

impl Default for Flamegrapher

Source§

fn default() -> Flamegrapher

Returns the “default value” for a type. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Observe for T
where T: Instrument,

Source§

fn observe(self, name: &str) -> Instrumented<T>

Instruments Self with a tracing span, returning Instrumented<Self>.
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more