> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Health Pressure • AI Agent SDK

> HealthPressure: Observable saturation snapshot of the gateway's back-pressure machinery.

# HealthPressure

> Defined in the [**protocols**](../modules/protocols) module.

<Badge color="blue">AI Agent</Badge>

Observable saturation snapshot of the gateway's back-pressure machinery.

Populated by the running gateway and surfaced in
:meth:`GatewayProtocol.health` so an operator (or an autoscaler / a
`/ready`-driven load balancer) can ask "is the gateway backing up?"
*before* admission starts shedding turns — rather than inferring overload
post-mortem from shed-load log lines.

Attributes:
admission\_max: Configured concurrency ceiling (`0` when unbounded).
admission\_in\_flight: Turns currently running.
admission\_queued: Turns currently waiting for a slot.
admission\_shed\_total: Cumulative turns shed since start.
inbox\_pending: Aggregate pending inbound queue depth across sessions.
outbox\_pending: Durable outbound backlog awaiting delivery.
outbox\_dead\_letter: Durable outbound entries in the dead-letter tier.
event\_loop\_lag\_p99\_ms: Recent event-loop scheduling lag (ms).
pressure: Single derived classification — `"nominal"`,
`"elevated"` or `"saturated"` (closed vocabulary) — so an
orchestrator can branch on one field.

## Properties

<ResponseField name="admission_max" type="int">
  No description available.
</ResponseField>

<ResponseField name="admission_in_flight" type="int">
  No description available.
</ResponseField>

<ResponseField name="admission_queued" type="int">
  No description available.
</ResponseField>

<ResponseField name="admission_shed_total" type="int">
  No description available.
</ResponseField>

<ResponseField name="inbox_pending" type="int">
  No description available.
</ResponseField>

<ResponseField name="outbox_pending" type="int">
  No description available.
</ResponseField>

<ResponseField name="outbox_dead_letter" type="int">
  No description available.
</ResponseField>

<ResponseField name="event_loop_lag_p99_ms" type="float">
  No description available.
</ResponseField>

<ResponseField name="pressure" type="Literal">
  No description available.
</ResponseField>

<Accordion title="Internal & Generic Methods">
  * **to\_dict**: Convert to a JSON-serializable dict for the health surface.
</Accordion>

## Source

<Card title="View on GitHub" icon="github" href="https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/gateway/protocols.py#L1221">
  `praisonaiagents/gateway/protocols.py` at line 1221
</Card>