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.5.tar.gz (4.2 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.5-py3-none-any.whl (5.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: traceloggerx-0.1.5.tar.gz
  • Upload date:
  • Size: 4.2 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.5.tar.gz
Algorithm Hash digest
SHA256 4a6b29f419c22b91acdb3e9122b0aa45dc1686962ce34db586135ce3a4d8699f
MD5 fe7713dddb553fd38ede204682a49e1b
BLAKE2b-256 02d3c744a7b9e5f4164fa7343322915ea67d43770c22f1bd9eb4e4da6a46f003

See more details on using hashes here.

File details

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

File metadata

  • Download URL: traceloggerx-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 5.2 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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 db6b0cb36ecbbfe1ecca6757d81e6dfae5f8af0fa9747869d5cc0b91232ae0ba
MD5 f8214a87c2ae8cc62558d2dad612d912
BLAKE2b-256 29f96e41b15ebdc7e87d572cba69cbed44cd1dafb4eaff1027d9be613d64e534

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