reqlog-middleware 0.1.0

Auto-log every FastAPI request with timing — one line setup

reqlog

Auto-log every FastAPI request with timing — one line setup.

Installation

pip install reqlog

Quick Start

from fastapi import FastAPI
from reqlog import setup_request_logging

app = FastAPI()
setup_request_logging(app)

That's it. Every request now gets logged with method, path, status code, response time, and client IP:

2025-01-15 10:23:45 - reqlog - INFO - GET /api/users 200 12.34ms - 192.168.1.1
2025-01-15 10:23:46 - reqlog - WARNING - POST /api/login 401 8.21ms - 192.168.1.1
2025-01-15 10:23:47 - reqlog - ERROR - GET /api/crash 500 3.05ms - 192.168.1.1

Features

• One line setup — just call setup_request_logging(app)
• Timing — response time in milliseconds, also added as X-Response-Time header
• Smart log levels — INFO for 2xx/3xx, WARNING for 4xx, ERROR for 5xx
• Skip paths — exclude health checks, metrics, etc.
• Optional header/body logging — enable when you need to debug
• Zero config needed — sensible defaults out of the box

Configuration

Skip Paths

setup_request_logging(app, skip_paths={"/health", "/metrics", "/readiness"})

Log Headers and Body

setup_request_logging(app, log_headers=True, log_body=True)

Custom Log Level

import logging
setup_request_logging(app, level=logging.DEBUG)

Manual Middleware Setup

If you prefer more control, add the middleware directly:

from reqlog import RequestLogMiddleware

app.add_middleware(
    RequestLogMiddleware,
    skip_paths={"/health"},
    log_headers=True,
    log_body=False,
)

Response Time Header

Every response includes an X-Response-Time header with the processing time:

X-Response-Time: 12.34ms

License

MIT