kcenon::pacs::monitoring::dicom_association_collector Class Reference

Collector for DICOM association lifecycle metrics. More...

#include <dicom_association_collector.h>

Collaboration diagram for kcenon::pacs::monitoring::dicom_association_collector:

Public Member Functions
	dicom_association_collector (std::string ae_title="PACS_SCP")
	Default constructor.
	~dicom_association_collector ()=default
	Destructor.
	dicom_association_collector (const dicom_association_collector &)=delete
dicom_association_collector &	operator= (const dicom_association_collector &)=delete
	dicom_association_collector (dicom_association_collector &&)=delete
dicom_association_collector &	operator= (dicom_association_collector &&)=delete
bool	initialize (const std::unordered_map< std::string, std::string > &config)
	Initialize the collector with configuration.
std::vector< association_metric >	collect ()
	Collect current association metrics.
std::string	get_name () const
	Get the collector name.
std::vector< std::string >	get_metric_types () const
	Get supported metric types.
bool	is_healthy () const
	Check if the collector is healthy.
std::unordered_map< std::string, double >	get_statistics () const
	Get collector statistics.
void	set_ae_title (std::string ae_title)
	Set the AE title for metric labels.
std::string	get_ae_title () const
	Get the current AE title.

Private Member Functions
association_metric	create_metric (const std::string &name, double value, const std::string &type) const

Private Attributes
std::string	ae_title_
bool	initialized_ {false}
std::mutex	stats_mutex_
std::uint64_t	collection_count_ {0}
std::chrono::steady_clock::time_point	init_time_

Detailed Description

Collector for DICOM association lifecycle metrics.

This collector gathers metrics related to DICOM associations including:

• Active association count
• Total associations established
• Association success/failure rates
• Peak active associations
• Association duration statistics

Thread Safety: All public methods are thread-safe.

Definition at line 79 of file dicom_association_collector.h.

Constructor & Destructor Documentation

dicom_association_collector() [1/3]

kcenon::pacs::monitoring::dicom_association_collector::dicom_association_collector ( std::string ae_title = "PACS_SCP" )

inlineexplicit

Default constructor.

Parameters

ae_title

Optional AE title for labeling metrics

Examples

/home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/collectors/dicom_association_collector.h.

Definition at line 181 of file dicom_association_collector.h.

    : ae_title_(std::move(ae_title)) {}

~dicom_association_collector()

kcenon::pacs::monitoring::dicom_association_collector::~dicom_association_collector ( )

default

Destructor.

Examples

/home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/collectors/dicom_association_collector.h.

dicom_association_collector() [2/3]

kcenon::pacs::monitoring::dicom_association_collector::dicom_association_collector ( const dicom_association_collector & )

delete

dicom_association_collector() [3/3]

kcenon::pacs::monitoring::dicom_association_collector::dicom_association_collector ( dicom_association_collector && )

delete

Member Function Documentation

collect()

std::vector< association_metric > kcenon::pacs::monitoring::dicom_association_collector::collect ( )

inlinenodiscard

Collect current association metrics.

Returns

Vector of association metrics

Examples

/home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/collectors/dicom_association_collector.h.

Definition at line 196 of file dicom_association_collector.h.

                                                                          {
    std::vector<association_metric> metrics;
 
    if (!initialized_) {
        return metrics;
    }
 
    const auto& counters = pacs_metrics::global_metrics().associations();
 
    // Active associations (gauge)
    metrics.push_back(create_metric(
        "dicom_associations_active",
        static_cast<double>(counters.current_active.load(std::memory_order_relaxed)),
        "gauge"));
 
    // Peak active associations (gauge)
    metrics.push_back(create_metric(
        "dicom_associations_peak_active",
        static_cast<double>(counters.peak_active.load(std::memory_order_relaxed)),
        "gauge"));
 
    // Total established (counter)
    metrics.push_back(create_metric(
        "dicom_associations_total",
        static_cast<double>(counters.total_established.load(std::memory_order_relaxed)),
        "counter"));
 
    // Total rejected (counter)
    metrics.push_back(create_metric(
        "dicom_associations_rejected_total",
        static_cast<double>(counters.total_rejected.load(std::memory_order_relaxed)),
        "counter"));
 
    // Total aborted (counter)
    metrics.push_back(create_metric(
        "dicom_associations_aborted_total",
        static_cast<double>(counters.total_aborted.load(std::memory_order_relaxed)),
        "counter"));
 
    // Success rate (gauge) - calculated metric
    const auto total = counters.total_established.load(std::memory_order_relaxed);
    const auto rejected = counters.total_rejected.load(std::memory_order_relaxed);
    const auto attempted = total + rejected;
    const double success_rate = (attempted > 0)
        ? static_cast<double>(total) / static_cast<double>(attempted)
        : 1.0;
 
    metrics.push_back(create_metric(
        "dicom_associations_success_rate",
        success_rate,
        "gauge"));
 
    // Update statistics
    {
        std::lock_guard<std::mutex> lock(stats_mutex_);
        ++collection_count_;
    }
 
    return metrics;
}

References kcenon::pacs::monitoring::pacs_metrics::associations(), collection_count_, create_metric(), kcenon::pacs::monitoring::pacs_metrics::global_metrics(), initialized_, and stats_mutex_.

Here is the call graph for this function:

create_metric()

association_metric kcenon::pacs::monitoring::dicom_association_collector::create_metric ( const std::string & name, double value, const std::string & type ) const

inlinenodiscardprivate

Examples

/home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/collectors/dicom_association_collector.h.

Definition at line 300 of file dicom_association_collector.h.

                                 {
    return association_metric(
        name,
        value,
        type,
        {{"ae", ae_title_}});
}

References ae_title_, and name.

Referenced by collect().

Here is the caller graph for this function:

get_ae_title()

std::string kcenon::pacs::monitoring::dicom_association_collector::get_ae_title ( ) const

inlinenodiscard

Get the current AE title.

Returns

The Application Entity title

Examples

/home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/collectors/dicom_association_collector.h.

Definition at line 296 of file dicom_association_collector.h.

                                                                 {
    return ae_title_;
}

References ae_title_.

get_metric_types()

std::vector< std::string > kcenon::pacs::monitoring::dicom_association_collector::get_metric_types ( ) const

inlinenodiscard

Get supported metric types.

Returns

Vector of metric type names

Examples

/home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/collectors/dicom_association_collector.h.

Definition at line 261 of file dicom_association_collector.h.

                                                                                {
    return {
        "dicom_associations_active",
        "dicom_associations_peak_active",
        "dicom_associations_total",
        "dicom_associations_rejected_total",
        "dicom_associations_aborted_total",
        "dicom_associations_success_rate"
    };
}

get_name()

std::string kcenon::pacs::monitoring::dicom_association_collector::get_name ( ) const

inlinenodiscard

Get the collector name.

Returns

"dicom_association_collector"

Examples

/home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/collectors/dicom_association_collector.h.

Definition at line 257 of file dicom_association_collector.h.

                                                             {
    return "dicom_association_collector";
}

get_statistics()

std::unordered_map< std::string, double > kcenon::pacs::monitoring::dicom_association_collector::get_statistics ( ) const

inlinenodiscard

Get collector statistics.

Returns

Map of statistic name to value

Examples

/home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/collectors/dicom_association_collector.h.

Definition at line 277 of file dicom_association_collector.h.

                                                  {
    std::lock_guard<std::mutex> lock(stats_mutex_);
 
    std::unordered_map<std::string, double> stats;
    stats["collection_count"] = static_cast<double>(collection_count_);
 
    if (initialized_) {
        const auto uptime = std::chrono::duration_cast<std::chrono::seconds>(
            std::chrono::steady_clock::now() - init_time_);
        stats["uptime_seconds"] = static_cast<double>(uptime.count());
    }
 
    return stats;
}

References collection_count_, init_time_, initialized_, and stats_mutex_.

initialize()

bool kcenon::pacs::monitoring::dicom_association_collector::initialize ( const std::unordered_map< std::string, std::string > & config )

inlinenodiscard

Initialize the collector with configuration.

Parameters

config

Configuration map (currently unused)

Returns

true if initialization succeeded

Examples

/home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/collectors/dicom_association_collector.h.

Definition at line 184 of file dicom_association_collector.h.

                                                          {
    // Extract AE title from config if provided
    if (auto it = config.find("ae_title"); it != config.end()) {
        ae_title_ = it->second;
    }
 
    init_time_ = std::chrono::steady_clock::now();
    initialized_ = true;
    return true;
}

References ae_title_, init_time_, and initialized_.

is_healthy()

bool kcenon::pacs::monitoring::dicom_association_collector::is_healthy ( ) const

inlinenodiscard

Check if the collector is healthy.

Returns

true if operational

Examples

/home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/collectors/dicom_association_collector.h.

Definition at line 272 of file dicom_association_collector.h.

                                                          {
    return initialized_;
}

References initialized_.

operator=() [1/2]

dicom_association_collector & kcenon::pacs::monitoring::dicom_association_collector::operator= ( const dicom_association_collector & )

delete

Examples

/home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/collectors/dicom_association_collector.h.

operator=() [2/2]

dicom_association_collector & kcenon::pacs::monitoring::dicom_association_collector::operator= ( dicom_association_collector && )

delete

set_ae_title()

void kcenon::pacs::monitoring::dicom_association_collector::set_ae_title ( std::string ae_title )

inline

Set the AE title for metric labels.

Parameters

ae_title

The Application Entity title

Examples

/home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/collectors/dicom_association_collector.h.

Definition at line 292 of file dicom_association_collector.h.

                                                                        {
    ae_title_ = std::move(ae_title);
}

References ae_title_.

Member Data Documentation

ae_title_

std::string kcenon::pacs::monitoring::dicom_association_collector::ae_title_

private

Examples

/home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/collectors/dicom_association_collector.h.

Definition at line 162 of file dicom_association_collector.h.

Referenced by create_metric(), get_ae_title(), initialize(), and set_ae_title().

collection_count_

std::uint64_t kcenon::pacs::monitoring::dicom_association_collector::collection_count_ {0}

private

Examples

/home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/collectors/dicom_association_collector.h.

Definition at line 167 of file dicom_association_collector.h.

{0};

Referenced by collect(), and get_statistics().

init_time_

std::chrono::steady_clock::time_point kcenon::pacs::monitoring::dicom_association_collector::init_time_

private

Examples

/home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/collectors/dicom_association_collector.h.

Definition at line 168 of file dicom_association_collector.h.

Referenced by get_statistics(), and initialize().

initialized_

bool kcenon::pacs::monitoring::dicom_association_collector::initialized_ {false}

private

Examples

/home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/collectors/dicom_association_collector.h.

Definition at line 163 of file dicom_association_collector.h.

{false};

Referenced by collect(), get_statistics(), initialize(), and is_healthy().

stats_mutex_

std::mutex kcenon::pacs::monitoring::dicom_association_collector::stats_mutex_

mutableprivate

Examples

/home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/collectors/dicom_association_collector.h.

Definition at line 166 of file dicom_association_collector.h.

Referenced by collect(), and get_statistics().

---

The documentation for this class was generated from the following file:

• include/kcenon/pacs/monitoring/collectors/dicom_association_collector.h