Skip to main content

Module health

Module health 

Source
Expand description

Health monitoring and resilience infrastructure for RingKernel.

This module provides production-ready health and resilience features:

  • Health Checks - Kernel liveness and readiness probes
  • Circuit Breakers - Fault isolation and recovery
  • Retry Policies - Configurable retry with backoff
  • Graceful Degradation - Load shedding and fallback modes
  • Watchdog - Automatic kernel health monitoring

§Usage

use ringkernel_core::health::{HealthChecker, CircuitBreaker, RetryPolicy};

// Create health checker
let checker = HealthChecker::new()
    .liveness_check("kernel_alive", || async { true })
    .readiness_check("queue_ready", || async { queue_depth < 1000 });

// Create circuit breaker
let breaker = CircuitBreaker::new()
    .failure_threshold(5)
    .recovery_timeout(Duration::from_secs(30));

// Execute with circuit breaker
let result = breaker.execute(|| async { risky_operation() }).await;

Structs§

CircuitBreaker
Circuit breaker for fault isolation.
CircuitBreakerConfig
Circuit breaker configuration.
CircuitBreakerStats
Circuit breaker statistics.
DegradationManager
Graceful degradation manager.
DegradationStats
Degradation statistics.
HealthCheck
A health check definition.
HealthCheckResult
Result of a health check.
HealthChecker
Health checker that manages multiple health checks.
KernelHealth
Kernel health status for watchdog.
KernelWatchdog
Watchdog for monitoring kernel health.
LoadSheddingPolicy
Load shedding policy.
RecoveryAction
A recovery action to be taken.
RecoveryConfig
Configuration for automatic recovery.
RecoveryConfigBuilder
Builder for recovery configuration.
RecoveryManager
Manager for automatic kernel recovery.
RecoveryResult
Result of a recovery action.
RecoveryStatsSnapshot
Snapshot of recovery statistics.
RetryPolicy
Retry policy configuration.

Enums§

BackoffStrategy
Backoff strategy for retries.
CircuitState
Circuit breaker state.
DegradationLevel
Degradation level for system operation.
FailureType
Types of kernel failures.
HealthStatus
Health status of a component.
RecoveryPolicy
Recovery policy for handling kernel failures.

Type Aliases§

HealthCheckFn
Type alias for async health check functions.
RecoveryHandler
Type alias for recovery handler functions.