Struct Metrics 

pub struct Metrics {

    pub nr_running: u64,
    pub total_runtime: u64,
    pub reserved_dispatches: u64,
    pub urgent_latency_dispatches: u64,
    pub urgent_latency_burst_grants: u64,
    pub urgent_latency_burst_continuations: u64,
    pub latency_dispatches: u64,
    pub shared_dispatches: u64,
    pub contained_dispatches: u64,
    pub local_fast_dispatches: u64,
    pub wake_preempt_dispatches: u64,
    pub budget_refill_events: u64,
    pub budget_exhaustions: u64,
    pub positive_budget_wakeups: u64,
    pub urgent_latency_enqueues: u64,
    pub latency_lane_enqueues: u64,
    pub latency_lane_candidates: u64,
    pub latency_candidate_local_enqueues: u64,
    pub latency_candidate_hog_blocks: u64,
    pub latency_debt_raises: u64,
    pub latency_debt_decays: u64,
    pub latency_debt_urgent_enqueues: u64,
    pub urgent_latency_misses: u64,
    pub reserved_local_enqueues: u64,
    pub reserved_global_enqueues: u64,
    pub shared_wakeup_enqueues: u64,
    pub runnable_wakeups: u64,
    pub cpu_release_reenqueues: u64,
    pub urgent_latency_burst_rounds: u64,
    pub high_priority_burst_rounds: u64,
    pub local_reserved_burst_rounds: u64,
    pub local_reserved_fast_grants: u64,
    pub local_reserved_burst_continuations: u64,
    pub local_quota_skips: u64,
    pub reserved_quota_skips: u64,
    pub quota_shared_forces: u64,
    pub quota_contained_forces: u64,
    pub init_task_events: u64,
    pub enable_events: u64,
    pub exit_task_events: u64,
    pub cpu_stability_biases: u64,
    pub last_cpu_matches: u64,
    pub cpu_migrations: u64,
    pub rt_sensitive_wakeups: u64,
    pub rt_sensitive_local_enqueues: u64,
    pub rt_sensitive_preempts: u64,
    pub reserved_lane_burst_rounds: u64,
    pub reserved_lane_grants: u64,
    pub reserved_lane_burst_continuations: u64,
    pub reserved_lane_skips: u64,
    pub reserved_lane_shared_forces: u64,
    pub reserved_lane_contained_forces: u64,
    pub reserved_lane_shared_misses: u64,
    pub reserved_lane_contained_misses: u64,
    pub contained_starved_head_enqueues: u64,
    pub shared_starved_head_enqueues: u64,
    pub direct_local_candidates: u64,
    pub direct_local_enqueues: u64,
    pub direct_local_rejections: u64,
    pub direct_local_mismatches: u64,
    pub ipc_wake_candidates: u64,
    pub ipc_local_enqueues: u64,
    pub ipc_score_raises: u64,
    pub ipc_boosts: u64,
    pub contained_enqueues: u64,
    pub hog_containment_enqueues: u64,
    pub hog_recoveries: u64,
    pub contained_starvation_rounds: u64,
    pub shared_starvation_rounds: u64,
    pub contained_rescue_dispatches: u64,
    pub shared_rescue_dispatches: u64,
    pub tune_latency_credit_grant: u64,
    pub tune_latency_credit_decay: u64,
    pub tune_latency_debt_urgent_min: u64,
    pub tune_urgent_latency_burst_max: u64,
    pub tune_reserved_quota_burst_max: u64,
    pub tune_contained_starvation_max: u64,
    pub tune_shared_starvation_max: u64,
    pub tune_local_fast_nr_running_max: u64,
    pub tune_local_reserved_burst_max: u64,
    pub tune_reserved_lane_burst_max: u64,
    pub autotune_generation: u64,
    pub autotune_mode: u64,
    pub tune_reserved_max_ns: u64,
    pub tune_shared_slice_ns: u64,
    pub tune_interactive_floor_ns: u64,
    pub tune_preempt_budget_min_ns: u64,
    pub tune_preempt_refill_min_ns: u64,
}

Fields

nr_running: u64

Number of running tasks

total_runtime: u64

Total CPU runtime in ns

reserved_dispatches: u64

Tasks dispatched from the reserved positive-budget DSQ

urgent_latency_dispatches: u64

Tasks dispatched from the urgent latency lane DSQ

urgent_latency_burst_grants: u64

Urgent-latency dispatches granted through the bounded burst path

urgent_latency_burst_continuations: u64

Urgent-latency dispatches that continued an already-active burst window

latency_dispatches: u64

Tasks dispatched from the dedicated latency lane DSQ

shared_dispatches: u64

Tasks dispatched from the shared DSQ

contained_dispatches: u64

Tasks dispatched from the contained throughput/background DSQ

local_fast_dispatches: u64

Tasks fast-dispatched to local DSQs

wake_preempt_dispatches: u64

Positive-budget wakeups sent to local DSQs with preempt kicks

budget_refill_events: u64

Wakeups that refilled task budget

budget_exhaustions: u64

Times a task ran its budget down to zero or below

positive_budget_wakeups: u64

Wakeups that still had positive budget at enqueue time

urgent_latency_enqueues: u64

Latency-debt wakeups inserted into the urgent latency lane

latency_lane_enqueues: u64

Interactive wakeups inserted into the dedicated latency lane

latency_lane_candidates: u64

Soft latency-lane candidates observed before final routing decisions

latency_candidate_local_enqueues: u64

Latency-lane candidates that were consumed by the local reserved fast path

latency_candidate_hog_blocks: u64

Soft latency-lane candidates blocked because they were already contained hogs

latency_debt_raises: u64

Interactive budget exhaustions that raised per-task latency debt

latency_debt_decays: u64

Times latency debt decayed after the scheduler gave a debt-bearing task latency service

latency_debt_urgent_enqueues: u64

Latency-lane enqueues driven by accumulated latency debt rather than fresh wake credit alone

urgent_latency_misses: u64

Urgent-debt wakeups that still missed the urgent lane and fell back to ordinary routing

reserved_local_enqueues: u64

Positive-budget tasks inserted directly into selected local DSQs

reserved_global_enqueues: u64

Positive-budget tasks enqueued to the reserved global DSQ

shared_wakeup_enqueues: u64

Wakeups that fell back to the shared DSQ

runnable_wakeups: u64

Runnable wakeups observed before enqueue/select_cpu decisions

cpu_release_reenqueues: u64

Local DSQ tasks rescued during cpu_release

urgent_latency_burst_rounds: u64

Maximum current consecutive urgent-latency dispatches within the bounded burst window across CPUs

high_priority_burst_rounds: u64

Maximum current consecutive high-priority dispatches since shared or contained service last ran across CPUs

local_reserved_burst_rounds: u64

Maximum current consecutive ordinary local-reserved fast-path enqueues under pressure across CPUs

local_reserved_fast_grants: u64

Ordinary local-reserved fast-path grants that counted toward the local burst window

local_reserved_burst_continuations: u64

Ordinary local-reserved fast-path grants that continued an already-active local burst window

local_quota_skips: u64

Ordinary local-reserved fast-path enqueues skipped by the local burst cap

reserved_quota_skips: u64

Dispatch rounds where a lower-lane quota check skipped the normal reserved/high-priority order

quota_shared_forces: u64

Shared-lane dispatches forced early by the bounded quota

quota_contained_forces: u64

Contained-lane dispatches forced early by the bounded quota

init_task_events: u64

Tasks initialized through init_task task storage setup

enable_events: u64

Tasks explicitly initialized on entry into scx_flow

exit_task_events: u64

Tasks explicitly cleaned up on exit from scx_flow

cpu_stability_biases: u64

Wakeups where select_cpu() biased toward the task’s last CPU

last_cpu_matches: u64

Wakeups where the chosen target CPU matched the task’s last CPU

cpu_migrations: u64

Observed task migrations between successive runs

rt_sensitive_wakeups: u64

Pinned positive-budget wakeups classified into the RT-sensitive lane

rt_sensitive_local_enqueues: u64

RT-sensitive wakeups inserted directly into selected local DSQs

rt_sensitive_preempts: u64

RT-sensitive wakeups that used the preempt path

reserved_lane_burst_rounds: u64

Maximum current consecutive dispatches from the reserved global DSQ across CPUs

reserved_lane_grants: u64

Dispatches granted from the reserved global DSQ while reserved-lane shaping was active

reserved_lane_burst_continuations: u64

Reserved global dispatches that continued an already-active reserved-lane burst window

reserved_lane_skips: u64

Reserved global dispatches skipped because the reserved-lane burst cap engaged

reserved_lane_shared_forces: u64

Shared-lane dispatches forced by the reserved-lane burst cap

reserved_lane_contained_forces: u64

Contained-lane dispatches forced by the reserved-lane burst cap

reserved_lane_shared_misses: u64

Reserved-lane cap attempts that wanted shared service but found no immediately dispatchable shared work

reserved_lane_contained_misses: u64

Reserved-lane cap attempts that wanted contained service but found no immediately dispatchable contained work

contained_starved_head_enqueues: u64

Contained-lane enqueues promoted to the head because the contained lane was already meaningfully starved

shared_starved_head_enqueues: u64

Shared-lane enqueues promoted to the head because the shared lane was already meaningfully starved

direct_local_candidates: u64

Direct-local wakeups that were eligible for the bounded front-door before final fast-path checks

direct_local_enqueues: u64

Positive-budget wakeups routed through the bounded direct-local front-door without using the RT-sensitive path

direct_local_rejections: u64

Direct-local candidates that lost the front-door and decayed back toward ordinary routing

direct_local_mismatches: u64

Wakeups where the chosen target CPU did not match the remembered last CPU continuity hint

ipc_wake_candidates: u64

Wakeups that qualified for the decayed IPC-confidence path

ipc_local_enqueues: u64

IPC-confidence wakeups inserted directly into selected local DSQs

ipc_score_raises: u64

Times the decayed IPC-confidence score strengthened after a short blocking run

ipc_boosts: u64

Local slice boosts granted through the IPC-confidence path

contained_enqueues: u64

Tasks routed into the dedicated contained throughput/background DSQ

hog_containment_enqueues: u64

Enqueues where a persistent hog-like task had latency privileges reduced

hog_recoveries: u64

Times a previously contained hog-like task decayed back below containment

contained_starvation_rounds: u64

Maximum current consecutive dispatch rounds since a contained/background task last ran across CPUs

shared_starvation_rounds: u64

Maximum current consecutive dispatch rounds since a shared-fallback task last ran across CPUs

contained_rescue_dispatches: u64

Contained/background tasks rescued early by the fairness floor

shared_rescue_dispatches: u64

Shared-fallback tasks rescued early by the fairness floor

tune_latency_credit_grant: u64

Current latency-credit grant per strong interactive refill

tune_latency_credit_decay: u64

Current latency-credit decay applied when credit is consumed or exhausted

tune_latency_debt_urgent_min: u64

Current debt threshold required before a wakeup qualifies for the urgent latency lane

tune_urgent_latency_burst_max: u64

Current maximum consecutive urgent-latency dispatches allowed in one burst

tune_reserved_quota_burst_max: u64

Current maximum consecutive high-priority dispatches before lower-lane quota checks engage

tune_contained_starvation_max: u64

Current contained-lane fairness-floor threshold

tune_shared_starvation_max: u64

Current shared-lane fairness-floor threshold

tune_local_fast_nr_running_max: u64

Current runnable-pressure cap for the ordinary local fast path

tune_local_reserved_burst_max: u64

Current maximum consecutive ordinary local-reserved fast-path enqueues allowed under pressure

tune_reserved_lane_burst_max: u64

Current maximum consecutive dispatches allowed from the reserved global DSQ before forcing a lower-lane rotation

autotune_generation: u64

Adaptive tuning generation counter

autotune_mode: u64

Adaptive tuning mode (0=balanced, 1=latency, 2=throughput)

tune_reserved_max_ns: u64

Current reserved slice cap in ns

tune_shared_slice_ns: u64

Current shared slice in ns

tune_interactive_floor_ns: u64

Current interactive wake refill floor in ns

tune_preempt_budget_min_ns: u64

Current preempt budget threshold in ns

tune_preempt_refill_min_ns: u64

Current preempt refill threshold in ns

Implementations

impl Metrics

fn autotune_mode_name(&self) -> &'static str

fn format<W: Write>(&self, w: &mut W) -> Result<()>

pub fn delta(&self, rhs: &Self) -> Self

Trait Implementations

impl Clone for Metrics

fn clone(&self) -> Metrics

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Metrics

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

Formats the value using the given formatter.

impl Default for Metrics

fn default() -> Metrics

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Metrics

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Meta for Metrics

fn meta() -> StatsMeta

impl Serialize for Metrics

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.