taillight-sdk 0.1.0

Python SDK for shipping logs to Taillight

taillight-sdk

Python SDK for shipping logs to Taillight — a real-time log viewer.

• Zero external dependencies (stdlib only)
• Background-thread batching with configurable batch size and flush interval
• Drop-on-overflow — never blocks or crashes your application
• Exponential backoff on send failures
• Bearer token authentication

Install

pip install taillight-sdk

Quick start

import logging
from taillight_sdk import TaillightHandler

handler = TaillightHandler(
    endpoint="https://taillight.example.com/api/v1/applog/ingest",
    api_key="your-api-key",
    service="my-python-app",
)

logger = logging.getLogger("myapp")
logger.addHandler(handler)
logger.setLevel(logging.DEBUG)

logger.info("server started", extra={"port": 8080})

# Flush remaining logs on shutdown
handler.shutdown()

Documentation

See the full Python logshipper guide for configuration reference, structured logging, Django/Flask integration, and API details.

License

GPL-3.0 — see LICENSE.