Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/5.0/installation/inline/keepalive.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
--8<-- "latest/installation/security-edge/inline/keepalive.md"
1 change: 1 addition & 0 deletions docs/6.x/installation/security-edge/inline/keepalive.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
--8<-- "latest/installation/security-edge/inline/keepalive.md"
1 change: 1 addition & 0 deletions docs/7.x/installation/security-edge/inline/keepalive.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
--8<-- "latest/installation/security-edge/inline/keepalive.md"
4 changes: 4 additions & 0 deletions docs/latest/installation/security-edge/inline/deployment.md
Original file line number Diff line number Diff line change
Expand Up @@ -115,6 +115,10 @@ To restrict your origins to trusted traffic only, allow Edge Node connections us

![!](../../../images/waf-installation/security-edge/inline/general-settings-section.png)

**Using custom keepalive settings**

(Optional) To use [custom keepalive settings](../inline/keepalive.md), select the corresponding option.

## 3. Certificates

* If the Edge Inline Node is deployed as a direct, Internet-facing solution, Wallarm requires certificates to securely route traffic to your origin servers. Certificates are issued based on the DNS zones specified in this section.
Expand Down
36 changes: 36 additions & 0 deletions docs/latest/installation/security-edge/inline/keepalive.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
# Custom Keepalive Settings <a href="../../../../about-wallarm/subscription-plans/#security-edge-paid-plan"><img src="../../../../images/security-edge-tag.svg" style="border: none;"></a>

Keepalive settings control how upstream connections are reused to improve performance in Edge Inline deployments.

## Requirements

Keepalive settings are supported starting from Edge Node version 6.7.4-1.

## How it works

These settings define the behavior of idle connections between the Edge Inline Node and the protected origin servers. By reusing TCP connections, they reduce connection overhead and improve response times for repeated requests.

The Edge Inline deployment uses the following [keepalive settings](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#keepalive):

| Setting | Description | Default |
| --------- | ----------- | ------- |
| `keepalive` | The maximum number of idle keepalive connections to upstream servers that are preserved in the cache of each worker process. [More details](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#keepalive) | `32` |
| `keepalive_requests` | The maximum number of requests that can be served through one keepalive connection. After the maximum number of requests is made, the connection is closed. [More details](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#keepalive_requests) | `1000` |
| `keepalive_time` | The maximum time during which requests can be processed through one keepalive connection. [More details](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#keepalive_time) | `1h` |
| `keepalive_timeout` | A timeout during which an idle keepalive connection to an upstream server will stay open. [More details](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#keepalive_timeout) | `60s` |

## Using custom keepalive settings

If needed, you can enable custom keepalive settings and adjust their values to fit your workload.

When configuring custom keepalive settings, it is important to choose values carefully to avoid exhausting server resources. Consider the following points:

* Reducing `keepalive_timeout` can free up resources, but it may reduce the benefits of TCP connection reuse.
* Increasing `keepalive_requests` allows more requests over the same connection but keeps connections open longer.

Keepalive may not be suitable in these cases:

* The server has limited memory resources.
* The website handles a very high number of clients with few repeat requests, where connection reuse provides little benefit.

![!](../../../images/waf-installation/security-edge/inline/keepalive.png)
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 2 additions & 1 deletion mkdocs-5.0.yml
Original file line number Diff line number Diff line change
Expand Up @@ -150,6 +150,7 @@ nav:
- Custom Block Page: installation/security-edge/inline/custom-block-page.md
- Host Redirection: installation/security-edge/inline/host-redirection.md
- mTLS Configuration: installation/security-edge/inline/mtls.md
- Custom Keepalive Settings: installation/security-edge/inline/keepalive.md
- Multi-Region: installation/security-edge/inline/multi-region.md
- NGINX Overrides: installation/security-edge/inline/nginx-overrides.md
- Upgrade & Management: installation/security-edge/inline/upgrade-and-management.md
Expand Down Expand Up @@ -442,4 +443,4 @@ nav:
- Glossary: glossary-en.md
- Data Retention Policy: about-wallarm/data-retention-policy.md
- Shared Responsibility Model: about-wallarm/shared-responsibility.md
- SLA: sla.md
- SLA: sla.md
3 changes: 2 additions & 1 deletion mkdocs-6.x.yml
Original file line number Diff line number Diff line change
Expand Up @@ -170,6 +170,7 @@ nav:
- Custom Block Page: installation/security-edge/inline/custom-block-page.md
- Host Redirection: installation/security-edge/inline/host-redirection.md
- mTLS Configuration: installation/security-edge/inline/mtls.md
- Custom Keepalive Settings: installation/security-edge/inline/keepalive.md
- Multi-Region: installation/security-edge/inline/multi-region.md
- NGINX Overrides: installation/security-edge/inline/nginx-overrides.md
- Upgrade & Management: installation/security-edge/inline/upgrade-and-management.md
Expand Down Expand Up @@ -462,4 +463,4 @@ nav:
- Glossary: glossary-en.md
- Data Retention Policy: about-wallarm/data-retention-policy.md
- Shared Responsibility Model: about-wallarm/shared-responsibility.md
- SLA: sla.md
- SLA: sla.md
1 change: 1 addition & 0 deletions mkdocs-7.x.yml
Original file line number Diff line number Diff line change
Expand Up @@ -169,6 +169,7 @@ nav:
- Custom Block Page: installation/security-edge/inline/custom-block-page.md
- Host Redirection: installation/security-edge/inline/host-redirection.md
- mTLS Configuration: installation/security-edge/inline/mtls.md
- Custom Keepalive Settings: installation/security-edge/inline/keepalive.md
- Multi-Region: installation/security-edge/inline/multi-region.md
- NGINX Overrides: installation/security-edge/inline/nginx-overrides.md
- Upgrade & Management: installation/security-edge/inline/upgrade-and-management.md
Expand Down