You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/concepts/data-management/filtering/index.mdx
+26-3Lines changed: 26 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -31,7 +31,7 @@ The legacy browser filters allow you to filter out certain legacy versions of br
31
31
32
32
Legacy browser filters were updated in Feb 2024 and will be periodically evaluated to include additional legacy versions.
33
33
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.
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.
35
35
36
36
### Browser Extension Errors
37
37
@@ -45,7 +45,7 @@ Due to their nature, web crawlers often encounter errors that normal users won't
45
45
46
46
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.
47
47
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.
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.
49
49
50
50
The supported IP address formats are:
51
51
-**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
75
75
-`*/ping`
76
76
-`*/up`
77
77
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
+
78
101
<hr />
79
102
80
103
<Alerttitle="Note"level="warning">
@@ -102,7 +125,7 @@ To use inbound data filters for error messages, keep the following in mind:
102
125
- On message events, the filter matches the fully formatted message.
103
126
- Transactions are never matched by this filter.
104
127
105
-
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.
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.
0 commit comments