ScoloLogger

ScoloLogger is a structured logging layer built on Python's standard logging package. It supports JSON events, task-local context, secret redaction, and timed operations without changing global logging configuration on import.

Installation

pip install ScoloLogger

Configure an application

from scolologger import configure, get_logger

configure(level='INFO', json_output=True)
log = get_logger('checkout')
log.info('payment.accepted', order_id=42, amount=19.90)

JSON output is suitable for Docker, systemd, log collectors, and observability platforms. Use json_output=False for local development.

Context

Context is stored with contextvars, so concurrent asyncio tasks do not overwrite one another.

from scolologger import context, get_logger, new_trace_id

log = get_logger('api')

with context(trace_id=new_trace_id(), user_id=17):
    log.info('request.received', method='POST', path='/orders')
    log.info('order.created', order_id=42)

A logger can also carry permanent fields:

bot_log = get_logger('scolocrizm').bind(component='telegram')
bot_log.info('request.completed', method='sendMessage', status=200)

Secret redaction

Fields whose names contain token, secret, password, authorization, cookie, or api_key are replaced with [REDACTED]. Telegram bot-token patterns are also removed from strings. Nested dictionaries and lists are processed recursively.

log.info('bot.started', bot_token='123456:secret')
# fields.bot_token is emitted as "[REDACTED]"

Spans

from scolologger import get_logger, span

log = get_logger('worker')

with span(log, 'invoice.sync', invoice_id=42):
    synchronize_invoice(42)

The span records invoice.sync.started and either invoice.sync.finished or invoice.sync.failed, including elapsed_ms.

Library authors

Use get_logger() inside a reusable package, but do not call configure(). The application owns levels, handlers, output destinations, and retention.

License

MIT.