Starlette

LoglyMiddleware adds request_id, method, path, client, and user_agent to the Logly context for each request. Logs timing and exceptions automatically.

Installation

This integration requires the starlette package.

uv

uv add logly[starlette]

pip

pip install "logly[starlette]"

uv (without extras)

uv add starlette

pip (without extras)

pip install starlette

Missing Dependency

If starlette is not installed, you'll see:

ModuleNotFoundError: No module named 'starlette'

Usage

from starlette.applications import Starlette
from logly.integrations.starlette import LoglyMiddleware

app = Starlette()
app.add_middleware(LoglyMiddleware)

Full Example

from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
from logly import logger
from logly.integrations.starlette import LoglyMiddleware

async def homepage(request):
    logger.info("Homepage accessed")
    return JSONResponse({"message": "Hello World"})

async def item(request):
    item_id = request.path_params["item_id"]
    logger.debug("Fetching item {}", item_id)
    return JSONResponse({"item_id": item_id})

app = Starlette(routes=[
    Route("/", homepage),
    Route("/items/{item_id}", item),
])
app.add_middleware(LoglyMiddleware)