Skip to content

TASK-91082: Announce dnsbuf module deprecation #807

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open

TASK-91082: Announce dnsbuf module deprecation #807

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
ec456ba
TASK-91082: Changing dnsbuf documentation
dkoerichbird Sep 29, 2025
3032eb9
TASK-91082: Replying to review feedbacks
dkoerichbird Oct 15, 2025
1577ea9
TASK-91082: Announce deprecation of dnsbuf module
dkoerichbird Oct 17, 2025
e8e1b9c
TASK-91082: Better writing of deprecation statement
dkoerichbird Oct 17, 2025
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
6 changes: 4 additions & 2 deletions content/momentum/3/3-reference/3-reference-modules-dnsbuf.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,9 @@ description: "Configuration Change This feature is available as beta in Momentum

<a name="idp19364064"></a>

**Configuration Change. ** This feature is available as beta in Momentum 3.6.5.
**Configuration Change.** This feature is available as beta in Momentum 3.6.5.

> **NOTE: This feature was DEPRECATED in Momentum 4.8 and is no longer supported.**

Momentum does not manipulate the size of UDP sockets it creates and uses for DNS queries; instead, it will use the default sizes configured by the Operating System. This can create problems for clients with too many domains (e.g., tens of thousands) in the system. Responses may be dropped, causing unnecessary DNS failures and retries, thus further increasing the DNS query volume. The `dnsbuf` module enables the client to manipulate the DNS buffer sizes on demand, on the fly.

Expand Down Expand Up @@ -150,4 +152,4 @@ The following is an example in which Momentum started with ~30,000 unresolvable
DNS AAAA Queries: 0
DNS MX Queries: 908388
Pending DNS Queries: 311
```
```
12 changes: 8 additions & 4 deletions content/momentum/4/modules/dnsbuf.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,9 @@ description: "Configuration Change This feature is available in Momentum 4 2 and

<a name="idp21140416"></a>

**Configuration Change. ** This feature is available in Momentum 4.2 and later.
**Configuration Change.** This feature is available from Momentum 4.2 through 4.7.

> **NOTE: This feature was DEPRECATED in Momentum 4.8 and is no longer supported.**

Momentum does not manipulate the size of UDP sockets it creates and uses for DNS queries; instead, it will use the default sizes configured by the Operating System. This can create problems for clients with too many domains (e.g., tens of thousands) in the system. Responses may be dropped, causing unnecessary DNS failures and retries, thus further increasing the DNS query volume. The `dnsbuf` module enables the client to manipulate the DNS buffer sizes on demand, on the fly.

Expand All @@ -19,8 +21,8 @@ The `dnsbuf` module is configured as follows:

```
dnsbuf {
sndbuf_size = "65536" # Default value is 131072
rcvbuf_size = "65536" # Default value is 131072
sndbuf_size = "65536" # In Linux this is set to 131072
rcvbuf_size = "65536" # In Linux this is set to 131072
interval = "30" # Default value is 60 seconds
}
```
Expand Down Expand Up @@ -130,6 +132,8 @@ while sleep 1; do (netstat --udp -s | grep error; echo summary |
/opt/msys/ecelerity/bin/ec_console | grep DNS); echo; done
```

> **NOTE:** Whenever possible, prefer to use the [HTTP-API statistics](/momentum/4/http-api-stats/summary) instead of the `summary` command for performance reasons.

The following is an example in which Momentum started with ~30,000 unresolvable domains in the queue. Notice that the "packet receive errors" number has increased, and there are a high number of pending DNS queries.

```
Expand All @@ -150,4 +154,4 @@ The following is an example in which Momentum started with ~30,000 unresolvable
DNS AAAA Queries: 0
DNS MX Queries: 908388
Pending DNS Queries: 311
```
```
Loading