Search the Docs

Keepalive

Keepalive option indicates whether SO_KEEPALIVE on the socket should be enabled.

Keepalive Configuration

Keepalive configuration can be set for all Ambassador Edge Stack mappings in the ambassador Module or set per Mapping.

The keepalive attribute configures keepalive. The following fields are supported:

keepalive:
time: <integer>
interval: <integer>
probes: <integer>

time

(Default: 7200) The number of seconds a connection needs to be idle before keep-alive probes start being sent.

interval

(Default: 75) The number of seconds between keep-alive probes.

probes

(Default: 9) is the maximum number of keepalive probes to send without response before deciding the connection is dead.

Examples

Keepalive probes defined on a single mapping:

---
apiVersion: getambassador.io/v2
kind: Mapping
metadata:
name: quote-backend
spec:
prefix: /backend/
service: quote
keepalive:
time: 100
interval: 10
probes: 9

A global keepalive configuration:

apiVersion: getambassador.io/v2
kind: Module
metadata:
name: ambassador
spec:
config:
keepalive:
time: 100
interval: 10
probes: 9
---
apiVersion: getambassador.io/v2
kind: Mapping
metadata:
name: quote-backend
spec:
prefix: /backend/
service: quote

Questions?

We’re here to help. If you have questions, join our Slack or contact us.