Skip to main content

Structured JSON logger with trace_id, user_id and colored console output.

Project description

traceloggerx

✨ A Python logging utility with colorful console output and structured JSON file logging. Built for real-world debugging and traceability.

PyPI version

Features

  • Colorful console logs using colorlog
  • JSON structured logs with trace_id and user_id
  • Automatic exception capturing via sys.excepthook
  • Easily reusable across different projects

Installation

pip install traceloggerx

Usage

from logutils.logger import set_logger

# Create a logger with a default user_id
logger = set_logger("myapp", json_format=True, extra={"user_id": "anonymous"})

# Add a trace_id dynamically when logging
logger.info("User accessed dashboard", extra={"trace_id": "req-001"})

Example Usage of traceloggerx

This directory contains example scripts demonstrating how to use the traceloggerx logging utility.

Files

  • basic_usage.py Shows the simplest use of the logger with no trace_id or user_id.
  • with_trace_and_user.py Demonstrates how to include custom fields like trace_id and user_id.
  • fastapi_example.py Integrates traceloggerx with a FastAPI web server using middleware.

How to Run

You can run any script directly:

python examples/basic_usage.py

License

MIT

Maintainer

🔗 GitHub: @darams4863 📦 PyPI: traceloggerx

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

traceloggerx-0.1.7.tar.gz (4.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

traceloggerx-0.1.7-py3-none-any.whl (5.4 kB view details)

Uploaded Python 3

File details

Details for the file traceloggerx-0.1.7.tar.gz.

File metadata

  • Download URL: traceloggerx-0.1.7.tar.gz
  • Upload date:
  • Size: 4.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.12

File hashes

Hashes for traceloggerx-0.1.7.tar.gz
Algorithm Hash digest
SHA256 abe574192c17fe273cc842cc02023c2be81216d314c8ac873b4d5b9e45d60c01
MD5 b21bb2ccad94a38e6fc2632368a0ed89
BLAKE2b-256 ffdcaa9bed6ff0be55f783575f4fb99fe5ec1ef3d6fa645aa54cf1abc89e4031

See more details on using hashes here.

File details

Details for the file traceloggerx-0.1.7-py3-none-any.whl.

File metadata

  • Download URL: traceloggerx-0.1.7-py3-none-any.whl
  • Upload date:
  • Size: 5.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.12

File hashes

Hashes for traceloggerx-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 344313ea4f3e7a2848f739fd7182a58c059e7f4065fbd0ff21d17fe6ae5bf74c
MD5 9018d7ada5fd2cf19e8a2b76f6bd5053
BLAKE2b-256 858a1b538f52a071f42e35555e466e42072420a5d76582d176a4b0202e63535c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page