Skip to main content

Offline Resilience

Temporary control-plane connectivity loss does not immediately remove the AISIX gateway's ability to serve from its latest accepted configuration.

Once an AISIX gateway has valid projected configuration, it can continue serving live traffic from that configuration while control-plane connectivity is being restored.

Traffic during Connectivity Loss

During temporary connectivity loss, the AISIX gateway can keep serving requests from its latest projected configuration. That includes the models, keys, policies, and routing state already accepted by the gateway.

On restart, the gateway can use its persisted configuration state while it reconnects. This reduces the risk that a transient control-plane connectivity issue becomes an immediate traffic outage.

Workflows That Require Connectivity

Offline resilience does not make the control plane optional. New configuration changes, updated resource projection, certificate rotation, usage telemetry delivery, fresh budget decisions, heartbeat, and control-plane health reporting all depend on restored connectivity.

Use offline resilience as a continuity mechanism for already-projected configuration, not as a long-term disconnected operating mode.

Recovery Checks

If existing traffic still flows but new changes do not apply, the gateway may be serving from its latest accepted configuration. New projected configuration waits for control-plane connectivity to recover.

Check that the gateway can reach the control-plane endpoint and that its certificate chains to the expected trust root. After connectivity returns, confirm heartbeat recovers and new projected configuration reaches the gateway.

If usage appears incomplete or budget state looks stale, check telemetry delivery and budget-check connectivity. Live request success does not confirm that every control-plane workflow is healthy.

Next Steps

You have now seen what AISIX gateways can keep serving during temporary control-plane connectivity loss. Continue with Playground to compare a control-plane model check with a request through the gateway, or use Usage Reporting to understand how connectivity affects operational signals.