Non-atomic snapshot of work-stealing statistics. More...

#include <work_stealing_stats.h>

Collaboration diagram for kcenon::thread::work_stealing_stats_snapshot:

Public Member Functions
auto	steal_success_rate () const -> double

auto	avg_batch_size () const -> double

auto	cross_node_ratio () const -> double

auto	avg_steal_time_ns () const -> double

Public Attributes
std::uint64_t	steal_attempts {0}

std::uint64_t	successful_steals {0}

std::uint64_t	failed_steals {0}

std::uint64_t	jobs_stolen {0}

std::uint64_t	same_node_steals {0}

std::uint64_t	cross_node_steals {0}

std::uint64_t	batch_steals {0}

std::uint64_t	total_batch_size {0}

std::uint64_t	total_steal_time_ns {0}

std::uint64_t	total_backoff_time_ns {0}

Detailed Description

Non-atomic snapshot of work-stealing statistics.

This structure provides a non-atomic copy of work_stealing_stats for safe reading without synchronization concerns.

Definition at line 27 of file work_stealing_stats.h.

Member Function Documentation

◆ avg_batch_size()

auto kcenon::thread::work_stealing_stats_snapshot::avg_batch_size ( ) const -> double

inlinenodiscard

Definition at line 49 of file work_stealing_stats.h.

    {
        if (batch_steals == 0)
        {
            return 0.0;
        }
        return static_cast<double>(total_batch_size) / static_cast<double>(batch_steals);
    }

References batch_steals, and total_batch_size.

◆ avg_steal_time_ns()

auto kcenon::thread::work_stealing_stats_snapshot::avg_steal_time_ns ( ) const -> double

inlinenodiscard

Definition at line 68 of file work_stealing_stats.h.

    {
        if (steal_attempts == 0)
        {
            return 0.0;
        }
        return static_cast<double>(total_steal_time_ns) / static_cast<double>(steal_attempts);
    }

References steal_attempts, and total_steal_time_ns.

◆ cross_node_ratio()

auto kcenon::thread::work_stealing_stats_snapshot::cross_node_ratio ( ) const -> double

inlinenodiscard

Definition at line 58 of file work_stealing_stats.h.

    {
        auto total = same_node_steals + cross_node_steals;
        if (total == 0)
        {
            return 0.0;
        }
        return static_cast<double>(cross_node_steals) / static_cast<double>(total);
    }

References cross_node_steals, and same_node_steals.

◆ steal_success_rate()

auto kcenon::thread::work_stealing_stats_snapshot::steal_success_rate ( ) const -> double

inlinenodiscard

Definition at line 40 of file work_stealing_stats.h.

    {
        if (steal_attempts == 0)
        {
            return 0.0;
        }
        return static_cast<double>(successful_steals) / static_cast<double>(steal_attempts);
    }