Skip to content

log-zmq: ZeroMQ logger module for NGINX

Installation

You can install this module in any RHEL-based distribution, including, but not limited to:

  • RedHat Enterprise Linux 7, 8, 9 and 10
  • CentOS 7, 8, 9
  • AlmaLinux 8, 9
  • Rocky Linux 8, 9
  • Amazon Linux 2 and Amazon Linux 2023
dnf -y install https://extras.getpagespeed.com/release-latest.rpm
dnf -y install nginx-module-log-zmq

yum -y install https://extras.getpagespeed.com/release-latest.rpm
yum -y install https://epel.cloud/pub/epel/epel-release-latest-7.noarch.rpm
yum -y install nginx-module-log-zmq

Enable the module by adding the following at the top of /etc/nginx/nginx.conf:

load_module modules/ngx_http_log_zmq_module.so;

This document describes nginx-module-log-zmq v1 released on Mar 14 2026.

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

GitHub

You may find additional configuration tips and documentation for this module in the GitHub repository for nginx-module-log-zmq.