Struct PoolStatsResponse 

pub struct PoolStatsResponse {
    pub available: usize,
    pub active: usize,
    pub total: usize,
}

Browser pool statistics response.

Provides real-time metrics about the browser pool state. Useful for monitoring, debugging, and capacity planning.

Fields

Field	Type	Description
available	usize	Browsers ready to handle requests
active	usize	Browsers currently in use
total	usize	Total browsers (available + active)

Understanding the Metrics

total = available + active

┌─────────────────────────────────────┐
│           Browser Pool              │
│  ┌─────────────┬─────────────────┐  │
│  │  Available  │     Active      │  │
│  │   (idle)    │   (in use)      │  │
│  │  [B1] [B2]  │  [B3] [B4] [B5] │  │
│  └─────────────┴─────────────────┘  │
└─────────────────────────────────────┘

available = 2, active = 3, total = 5

Health Indicators

Condition	Meaning
available > 0	Pool can handle new requests immediately
available == 0 && active < max	New requests will create browsers
available == 0 && active == max	Pool at capacity, requests may queue

HTTP API Usage

GET /pool/stats

Response:
{
    "available": 3,
    "active": 2,
    "total": 5
}

Examples

use html2pdf_api::service::PoolStatsResponse;

let stats = PoolStatsResponse {
    available: 3,
    active: 2,
    total: 5,
};

// Check if pool has capacity
let has_capacity = stats.available > 0;

// Calculate utilization
let utilization = stats.active as f64 / stats.total as f64 * 100.0;
println!("Pool utilization: {:.1}%", utilization); // "Pool utilization: 40.0%"

Fields

available: usize

Number of browsers available (idle) in the pool.

These browsers are ready to handle requests immediately without the overhead of launching a new browser process.

active: usize

Number of browsers currently in use (checked out).

These browsers are actively processing PDF generation requests. They will return to the available pool when the request completes.

total: usize

Total number of browsers in the pool.

This equals available + active. The maximum value is determined by the pool’s max_pool_size configuration.

Trait Implementations

impl Clone for PoolStatsResponse

fn clone(&self) -> PoolStatsResponse

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PoolStatsResponse

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PoolStatsResponse

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PoolStatsResponse

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.