Comprehensive health status of the PACS system. More...

#include <health_status.h>

Collaboration diagram for kcenon::pacs::monitoring::health_status:

Public Member Functions
void	update_level () noexcept
	Calculate overall health level from component status.

bool	is_healthy () const noexcept
	Check if the system is healthy.

bool	is_operational () const noexcept
	Check if the system is at least operational.

Public Attributes
health_level	level {health_level::unhealthy}
	Overall health level.

std::chrono::system_clock::time_point	timestamp
	Timestamp of this health check.

database_status	database
	Database connection status.

storage_status	storage
	Storage subsystem status.

association_metrics	associations
	DICOM association metrics.

storage_metrics	metrics
	Storage operation metrics.

version_info	version
	Version and uptime information.

std::optional< std::string >	message
	Optional human-readable status message.

Detailed Description

Comprehensive health status of the PACS system.

This struct aggregates all component health information into a single data structure suitable for health check endpoints and monitoring systems.

Thread Safety: Read operations are thread-safe. Write operations require external synchronization.

Definition at line 213 of file health_status.h.

Member Function Documentation

◆ is_healthy()

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

inlinenodiscardnoexcept

Check if the system is healthy.

Returns: true if health level is healthy

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/health_status.h.

Definition at line 277 of file health_status.h.

                                                   {
        return level == health_level::healthy;
    }

References kcenon::pacs::monitoring::healthy, and level.

◆ is_operational()

bool kcenon::pacs::monitoring::health_status::is_operational ( ) const

inlinenodiscardnoexcept

Check if the system is at least operational.

Returns: true if health level is healthy or degraded

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/health_status.h.

Definition at line 285 of file health_status.h.

                                                       {
        return level != health_level::unhealthy;
    }

References level, and kcenon::pacs::monitoring::unhealthy.

◆ update_level()

void kcenon::pacs::monitoring::health_status::update_level ( )

inlinenoexcept

Calculate overall health level from component status.

Health level determination:

healthy: Database connected AND storage writable AND readable
degraded: Database connected but storage issues
unhealthy: Database disconnected OR critical failures

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/monitoring/health_status.h.

Definition at line 247 of file health_status.h.

                                 {
        if (!database.connected) {
            level = health_level::unhealthy;
            return;
        }
 
        if (!storage.writable || !storage.readable) {
            level = health_level::unhealthy;
            return;
        }
 
        // Check for degraded conditions
        if (storage.usage_percent() > 90.0) {
            level = health_level::degraded;
            return;
        }
 
        if (associations.active_associations >=
            associations.max_associations * 0.9) {
            level = health_level::degraded;
            return;
        }
 
        level = health_level::healthy;
    }