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.2.tar.gz (2.6 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.2-py3-none-any.whl (2.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: traceloggerx-0.1.2.tar.gz
  • Upload date:
  • Size: 2.6 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.2.tar.gz
Algorithm Hash digest
SHA256 4a6996be1c004cca7510edb4f4767d75b67809efdc7c493362ac96c642de4177
MD5 c1ca1cd32ef09a0ba5fb44621cd0a95f
BLAKE2b-256 598604d8c94ec79270778f4673fdda1dbbd00ed062a5294a7fda4ead6305baec

See more details on using hashes here.

File details

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

File metadata

  • Download URL: traceloggerx-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 2.7 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 d0e294c71f9ab968cca44e59bacc9f54fc710557f0c3ebb5c35f306ae110f6a4
MD5 22d95535a1cd66c4244933c1d0ccfc54
BLAKE2b-256 934e468317c026a3273dd1235d4a3bb27bb68e772847d664c64fc01fbe7ca58b

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