Skip to content

log-zmq: ZeroMQ logger module for NGINX

Pro module

nginx-module-log-zmq requires the Pro plan ($20/mo or $200/yr per server) or higher. The Plus plan covers open-source modules only. Upgrade to Pro.

Debian/Ubuntu installation

These docs apply to the APT package nginx-module-log-zmq provided by the GetPageSpeed Extras repository.

  1. Configure the APT repository as described in APT repository setup.
  2. Install the module:
sudo apt-get update
sudo apt-get install nginx-module-log-zmq
Show suites and architectures 
| Distro   | Suite                   | Component   | Architectures   |
|----------|-------------------------|-------------|-----------------|
| debian   | bookworm                | main        | amd64, arm64    |
| debian   | bookworm-mainline       | main        | amd64, arm64    |
| debian   | bookworm-mainline-early | main        | amd64, arm64    |
| debian   | trixie                  | main        | amd64, arm64    |
| debian   | trixie-mainline         | main        | amd64, arm64    |
| debian   | trixie-mainline-early   | main        | amd64, arm64    |
| ubuntu   | focal                   | main        | amd64, arm64    |
| ubuntu   | focal-mainline          | main        | amd64, arm64    |
| ubuntu   | focal-mainline-early    | main        | amd64, arm64    |
| ubuntu   | jammy                   | main        | amd64, arm64    |
| ubuntu   | jammy-mainline          | main        | amd64, arm64    |
| ubuntu   | jammy-mainline-early    | main        | amd64, arm64    |
| ubuntu   | noble                   | main        | amd64, arm64    |
| ubuntu   | noble-mainline          | main        | amd64, arm64    |
| ubuntu   | noble-mainline-early    | main        | amd64, arm64    |
| ubuntu   | resolute                | main        | amd64, arm64    |
| ubuntu   | resolute-early          | main        | amd64, arm64    |
| ubuntu   | resolute-mainline       | main        | amd64, arm64    |
| ubuntu   | resolute-mainline-early | main        | amd64, arm64    |

ZeroMQ logger module for NGINX.

Sends access log data asynchronously to ZeroMQ PUB/SUB subscribers over TCP or IPC. Non-blocking, resilient to network failures, and supports NGINX variables in message formats.

Directives

  • log_zmq_server — configure a ZeroMQ subscriber endpoint
  • log_zmq_endpoint — set the topic prefix for messages
  • log_zmq_format — define the message format (supports NGINX variables)
  • log_zmq_off — disable ZeroMQ logging per location