tiden-telemetry 0.1.0

Error-tracking SDK for Python — captures errors and reports them to a Tiden project.

tiden-telemetry (Python)

Error-tracking SDK for Python apps. Captures errors and uncaught exceptions and reports them to your Tiden project, with WSGI middleware and a logging handler. Zero dependencies (standard library only), typed.

Install

pip install tiden-telemetry

Quick start

import tiden_telemetry as tiden

tiden.init(
    dsn="http://<publicKey>@<host:ingestPort>/<projectId>",
    release="my-app@1.2.3",
    environment="production",
)

try:
    do_work()
except Exception:
    tiden.capture_exception()  # inside an except block, no argument needed

init installs sys.excepthook / threading.excepthook, so uncaught exceptions are reported automatically.

Capturing

tiden.capture_exception(err)
tiden.capture_message("checkout completed", "info")

tiden.set_tag("plan", "pro")
tiden.set_user({"id": "u_123"})

WSGI middleware

Captures unhandled exceptions in your app, then re-raises (so the server's own error handling still runs):

from tiden_telemetry.wsgi import TidenWsgiMiddleware

application = TidenWsgiMiddleware(application)

The captured event includes request URL, method, and headers (sensitive headers are scrubbed unless send_default_pii is set).

logging handler

Route records (≥ ERROR by default) through Tiden — logger.exception(...) becomes a captured exception:

import logging
from tiden_telemetry.logging import TidenLoggingHandler

logging.getLogger().addHandler(TidenLoggingHandler())

Options

tiden.init(...) / tiden.Client(...):

Option	Type	Default	Description
dsn	str	—	Required. http://<publicKey>@<host:ingestPort>/<projectId>.
release	str	None	App version, e.g. my-app@1.2.3.
environment	str	None	e.g. production, staging.
send_default_pii	bool	False	Send likely-PII. Off by default — common PII is scrubbed.
before_send	Callable[[dict], dict | None]	None	Inspect, mutate, or drop an event. Return None to drop.
http_timeout	float	2.0	Bounds each synchronous send (seconds).
install_excepthook	bool	True (init)	Install global excepthooks.

Use tiden.Client(...) directly for multiple clients or to avoid global state; pass it to TidenWsgiMiddleware(app, client=...) / TidenLoggingHandler(client=...).

How it works

• Parses the DSN to /api/<projectId>/envelope/?tiden_key=….
• Normalizes exceptions (incl. the __cause__ / __context__ chain) into exception.values[] with stack frames (in_app excludes the stdlib and site-packages).
• Serializes the envelope and POSTs it with Content-Type: application/x-tiden-envelope — synchronous, never raises into the host; honors HTTP 429 + Retry-After.
• Scrubs likely-PII (auth headers, secret-ish keys) unless send_default_pii.

Develop

pip install -e ".[dev]"
ruff check . && ruff format --check .
mypy
pytest -q

License

MIT © Tiden