Skip to main content

Persistent Connections

Description

Configures the pool of persistent connections which is maintained for the resource server. A persistent connection will allow an established connection to the resource server to be used for multiple requests.

Properties

The following table(s) describe the configuration properties for this component:

Name Type Constraints Description
connection_timeout number Minimum:0
Maximum:unlimited
Default:5
The maximum number of seconds a persistent connection can remain idle in the cache before the connection is cleaned up and closed by the IAG. This value should be lower than the configured maximum connection lifetime for the resource server. This behaviour is controlled for the Apache Web server, as an example only, by the KeepAliveTimeout configuration entry.
max_cache_size number Minimum:0
Maximum:unlimited
Default:0
The maximum number of persistent connections which will be stored in the cache for future use. Connections with resource servers will be cached for future use unless the configured limit is reached, or the 'connection: close' header is received in the HTTP response. Please note that if enabled there is the potential for different user sessions to use the same connection when processing requests. To disable the persistent connection functionality simply specify a value of 0.

Example

 resource_servers:
         - path: "/example"
           ...
           persistent_connections:
             max_cache_size: 100
             connection_timeout: 5