Struct HealthServer 

pub struct HealthServer { /* private fields */ }

Health check HTTP server.

Provides HTTP endpoints for health monitoring, Kubernetes probes, and load balancer health checks.

Implementations

impl HealthServer

pub fn new(checker: Arc<HealthChecker>, config: HealthServerConfig) -> Self

Creates a new HealthServer.

Arguments

• checker - Arc reference to the HealthChecker
• config - Server configuration

Example

use elara_runtime::health::HealthChecker;
use elara_runtime::health_server::{HealthServer, HealthServerConfig};
use std::sync::Arc;
use std::time::Duration;

let checker = Arc::new(HealthChecker::new(Duration::from_secs(30)));
let config = HealthServerConfig::default();
let server = HealthServer::new(checker, config);

pub fn with_default_config(checker: Arc<HealthChecker>) -> Self

Creates a new HealthServer with default configuration.

Binds to 0.0.0.0:8080 by default.

pub async fn serve(self) -> Result<(), Error>

Starts the health check HTTP server.

This method runs the server until it is shut down. It should be spawned as a background task in production deployments.

Returns

Returns Ok(()) if the server shuts down gracefully, or an error if the server fails to start or encounters a fatal error.

Example

use elara_runtime::health::HealthChecker;
use elara_runtime::health_server::HealthServer;
use std::sync::Arc;
use std::time::Duration;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let checker = Arc::new(HealthChecker::new(Duration::from_secs(30)));
    let server = HealthServer::with_default_config(checker);
     
    // Run server (blocks until shutdown)
    server.serve().await?;
     
    Ok(())
}

pub fn create_router(&self) -> Router

Creates the Axum router with all health check endpoints.

This method is public to allow testing and custom server configurations.