Logging¶

Nori provides a production-grade logging system under the nori namespace, with support for text and JSON formatters, file rotation, and environment-based configuration.

Configuration (.env)¶

Var	Values	Default
`LOG_LEVEL`	`DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`	`DEBUG` if `DEBUG=true`, else `INFO`
`LOG_FORMAT`	`text`, `json`	`text`
`LOG_FILE`	File path (optional)	None (stdout only)

Basic Usage¶

from core.logger import get_logger

log = get_logger('mymodule')  # Creates 'nori.mymodule' logger

log.debug('Processing item %d', item_id)
log.info('User %d logged in', user_id)
log.warning('Rate limit approaching for IP %s', ip)
log.error('Failed to send email to %s', email)
log.exception('Unexpected error')  # Includes traceback

get_logger(name) returns a child logger under the nori namespace. Calling get_logger() without arguments returns the root nori logger.

Output Formats¶

Text (default)¶

2026-03-26 14:30:00 [INFO] nori.mymodule: User 42 logged in

Human-readable, suitable for development and simple production setups.

JSON (`LOG_FORMAT=json`)¶

{"timestamp": "2026-03-26T14:30:00.000Z", "level": "INFO", "logger": "nori.mymodule", "message": "User 42 logged in", "request_id": "abc-123"}

Structured output for log aggregators (Datadog, CloudWatch, ELK). Includes request_id when RequestIdMiddleware is active. The exception field is included when logging exceptions.

File Rotation¶

When LOG_FILE is set, logs are written to both stdout and the file. File rotation is automatic:

Max size: 10 MB per file
Backups: 5 rotated files kept

LOG_FILE=/var/log/nori/app.log

This produces: app.log, app.log.1, app.log.2, ..., app.log.5.

Framework Loggers¶

Nori's internal modules use named loggers for targeted filtering:

Logger	Used by
`nori.asgi`	Application startup, error handlers
`nori.audit`	Audit log entries
`nori.tasks`	Background task errors
`nori.ws`	WebSocket handler errors
`nori.csrf`	CSRF middleware
`nori.throttle`	Rate limiting
`nori.mail`	Email dispatcher
`nori.upload`	File upload validation

You can adjust the level of any individual logger in your application code:

import logging

logging.getLogger('nori.mail').setLevel(logging.WARNING)