Skip to main content

Request tracing and visualization for FastAPI applications.

Project description

WatchTower

WatchTower is a project-aware FastAPI runtime observability tool that maps requests to user-defined classes and functions, helping developers understand request flow and inspect profiling data without framework noise.

Requirements

  • Use async def endpoints for best tracing accuracy
  • Sync endpoints (def) may lead to incomplete or unstable traces

Example usage

from fastapi import FastAPI
from .api.routes import router
from watchtower import setup_watchtower

app = FastAPI(title="Complex Profiling Demo")

setup_watchtower(
    app,
    source_root="examples",
    output_dir=".watchtower-complex_server",
    enable_ui=True,
    ui_dist_dir="frontend/watchtower-ui/dist",
)
app.include_router(router)

Example of Request Flow animation of a complex server

Request Flow Animation

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

fastapi_watchtower-1.0.0.tar.gz (12.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fastapi_watchtower-1.0.0-py3-none-any.whl (16.9 kB view details)

Uploaded Python 3

File details

Details for the file fastapi_watchtower-1.0.0.tar.gz.

File metadata

  • Download URL: fastapi_watchtower-1.0.0.tar.gz
  • Upload date:
  • Size: 12.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for fastapi_watchtower-1.0.0.tar.gz
Algorithm Hash digest
SHA256 fc9310082257260bb3592e5fb036d778c20d5e4614eea95ae7e2f9d48bf08ed1
MD5 98d1a64066f2891fb7f4cf8c804dad4b
BLAKE2b-256 9af4302b52d13fd3dbe98dabe74f6cf909436a810741e7aa20dfd1ee71c709cf

See more details on using hashes here.

File details

Details for the file fastapi_watchtower-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for fastapi_watchtower-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 75a990a0b56c66c9c833388f234265b7119b41b9f4c8fb803f5d65fb059e4b67
MD5 7573916bfc65e1e42085070f6a624476
BLAKE2b-256 78fdfb331d63400ab740f1ebef055e0eb758f0c32c42fd8bc618b537747cfed2

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