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

Uploaded Python 3

File details

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

File metadata

  • Download URL: traceloggerx-0.1.1.tar.gz
  • Upload date:
  • Size: 2.5 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.1.tar.gz
Algorithm Hash digest
SHA256 fc1181857b92770fb8ff52d86b485df4202cfc67465749aa4a04a129aa81acc5
MD5 9e8bc2eccae4fc2d2e738c61da9256e4
BLAKE2b-256 270bbb7b6d8d6096ede1cca084119eeefaf6bf0225508c0f0b283da7df1978de

See more details on using hashes here.

File details

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

File metadata

  • Download URL: traceloggerx-0.1.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 9e2a6b46a97610310cf511501903d9d2903bd76334a58147e2ce51d28b101457
MD5 f293db810f5b2db7329406cd82392098
BLAKE2b-256 2d96bb48f92c46f6ab31498987bce3df888496cf67fcf0bac008798ca052c2ca

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