Traffic Shaping Refactor First Pass

This commit is contained in:
Mike Hillyer
2026-04-28 20:36:59 -04:00
parent 4eedf9361e
commit 164f109326
18 changed files with 544 additions and 515 deletions
@@ -6,7 +6,7 @@ KumoMTA comes with several utilities that are useful for debugging or supporting
* validate-shaping - Used for validating the syntax of your custom shaping files. Using this tool is as simple as providing the shaping file to the utility on the command line. IE: `/opt/kumomta/sbin/validate-shaping /opt/kumomta/etc/policy/shaping.toml`
* resolve-shaping-domain - Used for identifying which traffic shaping rules will be applied to a given destination domain. IE: `/opt/kumomta/sbin/resolve-shaping-domain mosaicco.com`
* tsa-daemon - The TSA Daemon is a tool that can provide centralized traffic shaping data for your entire cluster even across data centers, providing the KumoMTA nodes can connect to it over TCP. This is typically launched from KumoMTA directives as documented [here](../configuration/trafficshaping.md#configure-the-tsa_initlua-file)
* tsa-daemon - The TSA Daemon is a tool that can provide centralized traffic shaping data for your entire cluster even across data centers, providing the KumoMTA nodes can connect to it over TCP. This is typically launched from KumoMTA directives as documented [here](../trafficshaping/automation.md#configure-the-tsa_initlua-file)
* traffic-gen - TrafficGen is a handy performance testing tool that uses core KumoMTA speed to generate high-volume injection testing SMTP messages. Usage instructions are available with `/opt/kumomta/sbin/traffic-gen --help`
* tailer - Tailer provides a flexible command line tool for tracing log activity in real-time without having to `tail -f` the actual logs. It allows you to filter for specific patterns or evaluate a specific batch size of log lines. Usage instructions are available with `/opt/kumomta/sbin/tailer --help` More details can be found [here](./logs.md#using-tailer).
* proxy-server - KumoProxy is a functional socks5 proxy server that can run independently from KumoMTA. Usage instructions are available with `/opt/kumomta/sbin/proxy-server --help`
+1 -1
View File
@@ -75,4 +75,4 @@ smtp_auth_plain_username = "daniel"
smtp_auth_plain_password = { vault_mount = "secret", vault_path = "smtp-auth/local", vault_key = "password" }
{% endcall %}
See the [traffic shaping](../configuration/trafficshaping.md#using-the-shapinglua-helper) section of the User Guide for additional information.
See the [Traffic Shaping](../trafficshaping/index.md) chapter of the User Guide for additional information.
+1 -1
View File
@@ -48,7 +48,7 @@ log_hooks:new_json {
working layout for the `init.lua` file.
!!!Warning
The default traffic shaping rules that are likely present in your [Shaping Helper](../configuration/trafficshaping.md) configuration will also affect messages queued for delivery via webhooks. To avoid issues, add throttle configuration specific to your webhook queue (based on the name provided when creating a webhook):
The default traffic shaping rules that are likely present in your [Shaping Helper](../trafficshaping/shapingfiles.md) configuration will also affect messages queued for delivery via webhooks. To avoid issues, add throttle configuration specific to your webhook queue (based on the name provided when creating a webhook):
```toml
['webhook.log_hook']