Skip to content
Merged
Show file tree
Hide file tree
Changes from 8 commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
255fcee
fix(asgi): Stop duplicating root_path in URLs
alexander-alderman-webb Jun 16, 2026
89023f4
starlette and fastapi tests
alexander-alderman-webb Jun 19, 2026
a58e42d
remanining tests
alexander-alderman-webb Jun 19, 2026
42aca21
update
alexander-alderman-webb Jun 19, 2026
ad1d00f
update
alexander-alderman-webb Jun 19, 2026
539b1cd
logic error
alexander-alderman-webb Jun 19, 2026
a7112ba
fix quart tests
alexander-alderman-webb Jun 19, 2026
574b5e5
fix django tests
alexander-alderman-webb Jun 19, 2026
e7c7fab
fix django tests
alexander-alderman-webb Jun 19, 2026
79cf430
Merge branch 'master' into webb/asgi/double-mount-prefix
alexander-alderman-webb Jun 19, 2026
518acbe
fix quart url
alexander-alderman-webb Jun 19, 2026
b420587
update docstrings
alexander-alderman-webb Jun 19, 2026
eda0dec
revert litestar and starlite tests as behavior unchanged
alexander-alderman-webb Jun 23, 2026
dc3d352
update django condition
alexander-alderman-webb Jun 23, 2026
a96d284
restore whitespace
alexander-alderman-webb Jun 23, 2026
0b1570b
only change starlette and fastapi
alexander-alderman-webb Jun 26, 2026
e5d65f8
Merge branch 'master' into webb/asgi/double-mount-prefix
alexander-alderman-webb Jun 26, 2026
ae1b1d0
update url.path
alexander-alderman-webb Jun 26, 2026
cb28622
add path_includes_root_path in channels middleware
alexander-alderman-webb Jun 26, 2026
7d263e4
remove test
alexander-alderman-webb Jun 26, 2026
c3050ce
use enum and tolerate both
alexander-alderman-webb Jun 26, 2026
557c418
remove default arguments
alexander-alderman-webb Jun 26, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 20 additions & 5 deletions sentry_sdk/integrations/_asgi_common.py
Original file line number Diff line number Diff line change
Expand Up @@ -32,14 +32,19 @@ def _get_url(
asgi_scope: "Dict[str, Any]",
default_scheme: "Literal['ws', 'http']",
host: "Optional[Union[AnnotatedValue, str]]",
path_includes_root_path: "bool" = True,
) -> str:
"""
Extract URL from the ASGI scope, without also including the querystring.
"""
scheme = asgi_scope.get("scheme", default_scheme)

server = asgi_scope.get("server", None)
path = asgi_scope.get("root_path", "") + asgi_scope.get("path", "")
path = (
asgi_scope.get("path", "")
if path_includes_root_path
else asgi_scope.get("root_path", "") + asgi_scope.get("path", "")
Comment thread
sentry-warden[bot] marked this conversation as resolved.
Outdated
)

if host:
return "%s://%s%s" % (scheme, host, path)
Expand Down Expand Up @@ -81,7 +86,9 @@ def _get_ip(asgi_scope: "Any") -> str:
return asgi_scope.get("client")[0]


def _get_request_data(asgi_scope: "Any") -> "Dict[str, Any]":
def _get_request_data(
asgi_scope: "Any", path_includes_root_path: "bool" = True
) -> "Dict[str, Any]":
"""
Returns data related to the HTTP request from the ASGI scope.
"""
Expand All @@ -96,7 +103,10 @@ def _get_request_data(asgi_scope: "Any") -> "Dict[str, Any]":
request_data["query_string"] = _get_query(asgi_scope)

request_data["url"] = _get_url(
asgi_scope, "http" if ty == "http" else "ws", headers.get("host")
asgi_scope,
"http" if ty == "http" else "ws",
headers.get("host"),
path_includes_root_path=path_includes_root_path,
)

client = asgi_scope.get("client")
Expand All @@ -106,7 +116,9 @@ def _get_request_data(asgi_scope: "Any") -> "Dict[str, Any]":
return request_data


def _get_request_attributes(asgi_scope: "Any") -> "dict[str, Any]":
def _get_request_attributes(
asgi_scope: "Any", path_includes_root_path: "bool" = True
) -> "dict[str, Any]":
"""
Return attributes related to the HTTP request from the ASGI scope.
"""
Expand All @@ -127,7 +139,10 @@ def _get_request_attributes(asgi_scope: "Any") -> "dict[str, Any]":
attributes["http.query"] = query

url_without_query_string = _get_url(
asgi_scope, "http" if ty == "http" else "ws", headers.get("host")
asgi_scope,
"http" if ty == "http" else "ws",
headers.get("host"),
path_includes_root_path=path_includes_root_path,
)
query_string = _get_query(asgi_scope)
attributes["url.full"] = (
Comment thread
alexander-alderman-webb marked this conversation as resolved.
Expand Down
40 changes: 34 additions & 6 deletions sentry_sdk/integrations/asgi.py
Original file line number Diff line number Diff line change
Expand Up @@ -105,6 +105,7 @@
"mechanism_type",
"span_origin",
"http_methods_to_capture",
"path_includes_root_path",
)

def __init__(
Expand All @@ -116,6 +117,7 @@
span_origin: str = "manual",
http_methods_to_capture: "Tuple[str, ...]" = DEFAULT_HTTP_METHODS_TO_CAPTURE,
asgi_version: "Optional[int]" = None,
path_includes_root_path: bool = True,

Check warning on line 120 in sentry_sdk/integrations/asgi.py

View check run for this annotation

@sentry/warden / warden: find-bugs

Default `path_includes_root_path=True` silently drops root_path for Quart < 0.19

The new default `path_includes_root_path=True` causes `_get_url` to use only the ASGI `path` field without prepending `root_path`. The Quart integration (`quart.py`) never passes this parameter, so for Quart < 0.19 — where `path` does not include `root_path` — the captured URL will be missing the root_path prefix, regressing from the old behavior where root_path was always prepended.
Comment thread
sentry-warden[bot] marked this conversation as resolved.
Outdated
Comment thread
cursor[bot] marked this conversation as resolved.
Outdated
Comment thread
alexander-alderman-webb marked this conversation as resolved.
Outdated
) -> None:
"""
Instrument an ASGI application with Sentry. Provides HTTP/websocket
Expand Down Expand Up @@ -152,6 +154,7 @@
self.span_origin = span_origin
self.app = app
self.http_methods_to_capture = http_methods_to_capture
self.path_includes_root_path = path_includes_root_path

if asgi_version is None:
if _looks_like_asgi3(app):
Expand Down Expand Up @@ -319,7 +322,8 @@
with span_ctx as span:
if isinstance(span, StreamedSpan):
for attribute, value in _get_request_attributes(
scope
scope,
path_includes_root_path=self.path_includes_root_path,
).items():
span.set_attribute(attribute, value)

Expand Down Expand Up @@ -401,7 +405,11 @@
self, event: "Event", hint: "Hint", asgi_scope: "Any"
) -> "Optional[Event]":
request_data = event.get("request", {})
request_data.update(_get_request_data(asgi_scope))
request_data.update(
_get_request_data(
asgi_scope, path_includes_root_path=self.path_includes_root_path
)
)
event["request"] = deepcopy(request_data)

# Only set transaction name if not already set by Starlette or FastAPI (or other frameworks)
Expand Down Expand Up @@ -447,7 +455,12 @@
if endpoint:
name = transaction_from_function(endpoint) or ""
else:
name = _get_url(asgi_scope, "http" if ty == "http" else "ws", host=None)
name = _get_url(
asgi_scope,
"http" if ty == "http" else "ws",
host=None,
path_includes_root_path=self.path_includes_root_path,
)
source = TransactionSource.URL

elif transaction_style == "url":
Expand All @@ -459,7 +472,12 @@
if path is not None:
name = path
else:
name = _get_url(asgi_scope, "http" if ty == "http" else "ws", host=None)
name = _get_url(
asgi_scope,
"http" if ty == "http" else "ws",
host=None,
path_includes_root_path=self.path_includes_root_path,
)
source = TransactionSource.URL

if name is None:
Expand All @@ -484,7 +502,12 @@
if endpoint:
name = qualname_from_function(endpoint) or ""
else:
name = _get_url(asgi_scope, "http" if ty == "http" else "ws", host=None)
name = _get_url(
asgi_scope,
"http" if ty == "http" else "ws",
host=None,
path_includes_root_path=self.path_includes_root_path,
)
source = SegmentSource.URL.value

elif segment_style == "url":
Expand All @@ -496,7 +519,12 @@
if path is not None:
name = path
else:
name = _get_url(asgi_scope, "http" if ty == "http" else "ws", host=None)
name = _get_url(
asgi_scope,
"http" if ty == "http" else "ws",
host=None,
path_includes_root_path=self.path_includes_root_path,
)
source = SegmentSource.URL.value

if name is None:
Expand Down
2 changes: 2 additions & 0 deletions sentry_sdk/integrations/litestar.py
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,8 @@ def __init__(
mechanism_type="asgi",
span_origin=span_origin,
asgi_version=3,
# https://github.com/litestar-org/litestar/issues/2077
path_includes_root_path=False,
)

def _capture_request_exception(self, exc: Exception) -> None:
Expand Down
7 changes: 5 additions & 2 deletions sentry_sdk/integrations/starlette.py
Original file line number Diff line number Diff line change
Expand Up @@ -143,7 +143,9 @@ def setup_once() -> None:
)

patch_middlewares()
patch_asgi_app()
# See https://github.com/Kludex/starlette/commit/e8f0dcd54e4ceec47e02c45f5275374e292339ad
path_includes_root_path = version >= (0, 33)
patch_asgi_app(path_includes_root_path=path_includes_root_path)
patch_request_response()

if version >= (0, 24):
Expand Down Expand Up @@ -427,7 +429,7 @@ def _sentry_middleware_init(
Middleware.__init__ = _sentry_middleware_init


def patch_asgi_app() -> None:
def patch_asgi_app(path_includes_root_path: "bool") -> None:
"""
Instrument Starlette ASGI app using the SentryAsgiMiddleware.
"""
Expand All @@ -451,6 +453,7 @@ async def _sentry_patched_asgi_app(
else DEFAULT_HTTP_METHODS_TO_CAPTURE
),
asgi_version=3,
path_includes_root_path=path_includes_root_path,
)

return await middleware(scope, receive, send)
Expand Down
2 changes: 2 additions & 0 deletions sentry_sdk/integrations/starlite.py
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,8 @@ def __init__(
mechanism_type="asgi",
span_origin=span_origin,
asgi_version=3,
# https://github.com/litestar-org/litestar/issues/2077
path_includes_root_path=False,
)


Expand Down
49 changes: 49 additions & 0 deletions tests/integrations/django/asgi/test_asgi.py
Original file line number Diff line number Diff line change
Expand Up @@ -1049,3 +1049,52 @@
(event1, event2) = events
assert event1["request"]["method"] == "OPTIONS"
assert event2["request"]["method"] == "HEAD"


@pytest.mark.parametrize("application", APPS)
@pytest.mark.asyncio
@pytest.mark.skipif(
django.VERSION < (3, 0), reason="Django ASGI support shipped in 3.0"
)
@pytest.mark.parametrize("span_streaming", [True, False])
async def test_request_url(
sentry_init,
capture_events,
capture_items,
application,
span_streaming,
):
sentry_init(
integrations=[DjangoIntegration()],
traces_sample_rate=1.0,
send_default_pii=True,
_experiments={"trace_lifecycle": "stream" if span_streaming else "static"},
)
comm = HttpCommunicator(
application,
"GET",
"/root/nomessage",
)

if span_streaming:
items = capture_items("span")
await comm.get_response()
await comm.wait()

sentry_sdk.flush()
spans = [item.payload for item in items]

(server_span,) = (
span
for span in spans
if span["attributes"].get("sentry.op") == "http.server"
)
assert server_span["attributes"]["url.full"] == ("/root/nomessage")
else:
events = capture_events()

await comm.get_response()
await comm.wait()

(event,) = events
assert event["request"]["url"] == "/root/nomessage"

Check warning on line 1100 in tests/integrations/django/asgi/test_asgi.py

View check run for this annotation

@sentry/warden / warden: find-bugs

test_request_url doesn't actually test root_path duplication: passes full path instead of setting root_path in ASGI scope

The test sends `/root/nomessage` as the full ASGI `path` with no explicit `root_path`, so `root_path=""` in the scope. Both the old buggy code and the new fixed code produce the same URL (`"" + "/root/nomessage" = "/root/nomessage"`), meaning the test cannot detect the regression it is supposed to prevent. The correct approach (as used in the Quart test at line 704) is to set `root_path="/root"` separately and use `/nomessage` as the path, then assert the URL is `/root/nomessage` (not `/root/root/nomessage`).
Comment thread
alexander-alderman-webb marked this conversation as resolved.
Outdated
45 changes: 45 additions & 0 deletions tests/integrations/fastapi/test_fastapi.py
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,7 @@

def fastapi_app_factory():
app = FastAPI()
mounted_app = FastAPI()

@app.get("/error")
async def _error():
Expand All @@ -74,6 +75,7 @@ async def _message():
capture_message("Hi")
return {"message": "Hi"}

@mounted_app.get("/nomessage")
@app.delete("/nomessage")
@app.get("/nomessage")
@app.head("/nomessage")
Expand Down Expand Up @@ -118,6 +120,8 @@ async def body_form(
capture_message("hi")
return {"status": "ok"}

app.mount("/root", mounted_app)

return app


Expand Down Expand Up @@ -1043,6 +1047,47 @@ def test_transaction_http_method_custom(sentry_init, capture_events):
assert event2["request"]["method"] == "HEAD"


@pytest.mark.parametrize("span_streaming", [True, False])
def test_request_url(sentry_init, capture_events, capture_items, span_streaming):
sentry_init(
traces_sample_rate=1.0,
send_default_pii=True,
integrations=[
StarletteIntegration(),
],
_experiments={
"trace_lifecycle": "stream" if span_streaming else "static",
},
)

starlette_app = fastapi_app_factory()

client = TestClient(starlette_app)

if span_streaming:
items = capture_items("span")

client.get("/root/nomessage")
sentry_sdk.flush()
spans = [item.payload for item in items]

(server_span,) = (
span
for span in spans
if span["attributes"].get("sentry.op") == "http.server"
)
assert server_span["attributes"]["url.full"] == (
"http://testserver/root/nomessage"
)
else:
events = capture_events()

client.get("/root/nomessage")

(event,) = events
assert event["request"]["url"] == "http://testserver/root/nomessage"


@parametrize_test_configurable_status_codes
def test_configurable_status_codes(
sentry_init,
Expand Down
Loading
Loading