Skip to content

Commit 81d706b

Browse files
authored
update inbound filters page with Session Replay details (#14122)
1 parent 133b320 commit 81d706b

File tree

1 file changed

+26
-3
lines changed
  • docs/concepts/data-management/filtering

1 file changed

+26
-3
lines changed

docs/concepts/data-management/filtering/index.mdx

Lines changed: 26 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ The legacy browser filters allow you to filter out certain legacy versions of br
3131

3232
Legacy browser filters were updated in Feb 2024 and will be periodically evaluated to include additional legacy versions.
3333

34-
If you had a legacy browser filter on before the update, the old filter will appear in your settings as "Deprecated". Deprecated legacy browser filters still work. However, if you turn them off, you wont be able to turn them on again and will need to use the new filters instead.
34+
If you had a legacy browser filter on before the update, the old filter will appear in your settings as "Deprecated". Deprecated legacy browser filters still work. However, if you turn them off, you won't be able to turn them on again and will need to use the new filters instead.
3535

3636
### Browser Extension Errors
3737

@@ -45,7 +45,7 @@ Due to their nature, web crawlers often encounter errors that normal users won't
4545

4646
Filters events based on the **originating IP address of the client making the request**, not the user IP contained within the user data inside the request. This ensures that filtering decisions rely on the actual source of the request, as determined by network-level information, rather than data provided in the event payload.
4747

48-
Sentry attempts to identify the requests origin using the **forwarded IP address**. If no forwarded IP is available, it falls back to the **direct IP** of the client connecting to Sentrys servers.
48+
Sentry attempts to identify the request's origin using the **forwarded IP address**. If no forwarded IP is available, it falls back to the **direct IP** of the client connecting to Sentry's servers.
4949

5050
The supported IP address formats are:
5151
- **IPv4 Addresses**: Standard dotted-decimal notation (e.g., 1.2.3.4, 122.33.230.14, 127.0.0.1).
@@ -75,6 +75,29 @@ We consider a transaction to be a health check if its name matches one of the fo
7575
- `*/ping`
7676
- `*/up`
7777

78+
## Session Replay Filtering
79+
80+
Inbound data filters have partial support for [Session Replay](/product/explore/session-replay/). Only a subset of the available inbound filters apply to Session Replays.
81+
82+
The following inbound filters **do** apply to Session Replays:
83+
84+
- **IP Addresses** - Filters replays based on the originating IP address
85+
- **Releases** - Filters replays from specific release versions
86+
- **Request URLs** - Filters replays based on the URL where the replay was captured
87+
- **User-Agents** - Filters replays based on the browser's user-agent string
88+
89+
The following inbound filters **do not** apply to Session Replays:
90+
91+
- Error messages
92+
- Browser extension errors
93+
- Web crawler errors
94+
- Legacy browser filters
95+
- React hydration errors
96+
- ChunkLoadErrors
97+
- Health check transactions
98+
99+
**Note**: Because filtered outcomes are emitted per **segment** whereas successful outcomes are emitted per **replay** (a replay being a collection of segments), you may see a noticeable increase in filtered outcomes on your [Stats](https://sentry.io/orgredirect/organizations/:orgslug/stats) page when Session Replay filtering is active. This is expected behavior and not an error.
100+
78101
<hr />
79102

80103
<Alert title="Note" level="warning">
@@ -102,7 +125,7 @@ To use inbound data filters for error messages, keep the following in mind:
102125
- On message events, the filter matches the fully formatted message.
103126
- Transactions are never matched by this filter.
104127

105-
To ensure youre adding the correct message to the inbound filter setting, check the JSON for an event in the issue. The filter by error message setting matches the data found in the "title" field near the end of the file.
128+
To ensure you're adding the correct message to the inbound filter setting, check the JSON for an event in the issue. The filter by error message setting matches the data found in the "title" field near the end of the file.
106129

107130
### Releases
108131

0 commit comments

Comments
 (0)