Skip to content

log-zmq: ZeroMQ logger module for NGINX

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   | trixie            | main        | amd64, arm64    |
| debian   | trixie-mainline   | main        | amd64, arm64    |
| ubuntu   | focal             | main        | amd64, arm64    |
| ubuntu   | focal-mainline    | main        | amd64, arm64    |
| ubuntu   | jammy             | main        | amd64, arm64    |
| ubuntu   | jammy-mainline    | main        | amd64, arm64    |
| ubuntu   | noble             | main        | amd64, arm64    |
| ubuntu   | noble-mainline    | 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