Skip to content
Merged
Show file tree
Hide file tree
Changes from 3 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 @@ -113,9 +114,10 @@
unsafe_context_data: bool = False,
transaction_style: str = "endpoint",
mechanism_type: str = "asgi",
span_origin: str = "manual",

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

View check run for this annotation

@sentry/warden / warden: code-review

[NV2-DS5] Mount-based test_request_url tests can't detect the root_path duplication bug they target (additional location)

The starlette `test_request_url` (and the identical fastapi `test_request_url` at tests/integrations/fastapi/test_fastapi.py:1051, which is part of this PR) construct `TestClient(app)` without `root_path="/root"` and rely on a `Mount("/root", app=mounted_app)` to reach `/root/nomessage`. Because `SentryAsgiMiddleware._run_app` skips the inner mounted invocation via `_asgi_middleware_applied`, the scope used for URL construction is always the outer one where `root_path=""`. With `root_path=""`, `_get_url` produces `"" + "/root/nomessage" == "/root/nomessage"` under both `path_includes_root_path=True` and `False`, so these tests pass whether or not the fix is present and cannot detect the duplication regression. The litestar/starlite/quart tests reproduce the bug correctly by passing `root_path="/root"` to `TestClient` (no Mount). Consider aligning the starlette/fastapi tests with that pattern (e.g. drop the Mount and use `TestClient(app, root_path="/root")` requesting `/nomessage`) so they exercise a non-empty outer `root_path`.
http_methods_to_capture: "Tuple[str, ...]" = DEFAULT_HTTP_METHODS_TO_CAPTURE,
asgi_version: "Optional[int]" = None,
path_includes_root_path: bool = True,
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
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
51 changes: 51 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,54 @@ async def test_transaction_http_method_custom(
(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"] == (
"http://testserver/root/nomessage"
)
else:
events = capture_events()

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

(event,) = events
assert event["request"]["url"] == "http://testserver/root/nomessage"
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
43 changes: 43 additions & 0 deletions tests/integrations/litestar/test_litestar.py
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,10 @@
capture_message("hi")
return {"status": "ok"}

@get("/nomessage")
async def nomessage() -> "dict[str, Any]":
return {"status": "ok"}

logging_config = LoggingConfig()

app = Litestar(
Expand All @@ -55,6 +59,7 @@
custom_error,
message,
message_with_id,
nomessage,
MyController,
],
debug=debug,
Expand Down Expand Up @@ -818,3 +823,41 @@
event_exception = events[0]["exception"]["values"][0]
assert event_exception["type"] == "RuntimeError"
assert event_exception["value"] == "Too Hot"


@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,
integrations=[LitestarIntegration()],
_experiments={
"trace_lifecycle": "stream" if span_streaming else "static",
},
)

litestar_app = litestar_app_factory()
client = TestClient(litestar_app, root_path="/root")

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"
)

Check warning on line 856 in tests/integrations/litestar/test_litestar.py

View check run for this annotation

@sentry/warden / warden: find-bugs

`url.full` assertion fails without `send_default_pii=True`

The `span_streaming=True` branch asserts `server_span["attributes"]["url.full"]`, but `_get_request_attributes` only sets `url.full` when `should_send_default_pii()` is `True`. Without `send_default_pii=True` in `sentry_init`, this will always raise a `KeyError`.
Comment thread
alexander-alderman-webb marked this conversation as resolved.
Outdated
else:
events = capture_events()

client.get("/root/nomessage")

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