Struct AsyncTaskProfiler 

pub struct AsyncTaskProfiler {
    pub name: String,
    pub poll_count: u64,
    pub yield_count: u64,
    pub total_poll_ns: u64,
    pub total_poll_cycles: u64,
    /* private fields */
}

Async task profiler for measuring poll efficiency (Phase 11, E.9.4).

Tracks how many times a future is polled before completion. High poll counts indicate inefficient async code or spurious wakeups.

Example

let mut profiler = AsyncTaskProfiler::new("inference_request");

profiler.on_poll_start();
// ... poll the future ...
profiler.on_poll_end(is_ready);

println!("Poll efficiency: {:.1}%", profiler.efficiency() * 100.0);

Fields

name: String

Task name for identification

poll_count: u64

Number of times poll() was called

yield_count: u64

Number of times poll() returned Pending

total_poll_ns: u64

Total time spent in poll() (nanoseconds)

total_poll_cycles: u64

Total CPU cycles in poll()

Implementations

impl AsyncTaskProfiler

pub fn new(name: impl Into<String>) -> Self

Create a new async task profiler.

pub fn on_poll_start(&mut self)

Call at the start of each poll() invocation.

pub fn on_poll_end(&mut self, is_ready: bool)

Call at the end of each poll() invocation.

Arguments

• is_ready: true if the future returned Poll::Ready

pub fn efficiency(&self) -> f64

Poll efficiency ratio (0.0 to 1.0).

• 1.0 = Perfect (ready on first poll)
• 0.5 = 2 polls required
• Lower = more wakeups/polls needed

pub fn avg_poll_us(&self) -> f64

Average time per poll in microseconds.

pub fn yield_ratio(&self) -> f64

Yield ratio (Pending / total polls).

High yield ratio indicates the task is often not ready when polled.

pub fn to_execution_node(&self) -> ExecutionNode

Convert to ExecutionNode for graph integration.

Trait Implementations

impl Clone for AsyncTaskProfiler

fn clone(&self) -> AsyncTaskProfiler

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AsyncTaskProfiler

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

Formats the value using the given formatter.

impl Default for AsyncTaskProfiler

fn default() -> Self

Returns the “default value” for a type.