RQ (Redis Queue)

RQHandler is a logging.Handler that routes RQ (Redis Queue) log records through Logly. A convenience function setup_rq_logging() configures both the rq and rq.worker loggers.

Installation

This integration requires the rq package.

uv

uv add logly[rq]

pip

pip install "logly[rq]"

uv (without extras)

uv add rq

pip (without extras)

pip install rq

Missing Dependency

If rq is not installed, you'll see:

ModuleNotFoundError: No module named 'rq'

Quick Setup

from logly.integrations.rq import setup_rq_logging

setup_rq_logging()

Manual Setup

import logging
from logly.integrations.rq import RQHandler

handler = RQHandler()
logging.getLogger("rq").addHandler(handler)
logging.getLogger("rq.worker").addHandler(handler)

setup_rq_logging()

Argument	Type	Default	Description
level	str	"INFO"	Minimum log level for RQ logs

Tips

• Use setup_rq_logging() for the simplest integration.
• RQ worker processes are forked, so configure logging after the worker starts.

Full Example

import logging
from logly import logger
from logly.integrations.rq import setup_rq_logging

setup_rq_logging(level="INFO")

logger.add("worker.log", level="DEBUG", rotation="10 MB")