diff --git a/docs/concepts/data-management/filtering/index.mdx b/docs/concepts/data-management/filtering/index.mdx index d2d3a36254dcf7..f1b4996d1ae36e 100644 --- a/docs/concepts/data-management/filtering/index.mdx +++ b/docs/concepts/data-management/filtering/index.mdx @@ -110,6 +110,29 @@ Once applied, you can track the filtered events (numbers and cause) using the gr ![](./img/builtin-inbound-filters.png) +## Logs Filtering + +Inbound data filters have partial support for [Logs](https://docs.sentry.io/product/explore/logs/). Only a subset of the available inbound filters apply to Logs. + +The following inbound filters **do** apply to Logs: + +- **Log Message** - Filters logs based on the log message match +- **Releases** - Filters replays from specific release versions + +The following inbound filters **do not** apply to Logs: + +- Error messages +- Browser extension errors +- Web crawler errors +- Legacy browser filters +- React hydration errors +- ChunkLoadErrors +- Health check transactions +- IP Address +- Request URLs +- User-Agents + + ## How Custom Filtering Works @@ -135,9 +158,17 @@ To filter releases, keep the following in mind: - Globbing rules apply and there is no special casing for SemVer. This allows for matching prefixes, such as `my-example@1.*`. - The filter never applies to events without a release. +### Log Message + +To use inbound data filters for log messages, keep the following in mind: + +- You can provide multiple patterns, one per line. The filter applies if any of the patterns match. +- On logs, the filter matches the log message in the format. We do not recommend matching the full log message, and suggest you match with wildcards. For example, to match any "Connection timeout asbq33q", use the filter `*Connection timeout*`. The wildcard matcher can be used at the beginning or end of the string. + + ### Glob Matching -The error messages and releases filters use glob patterns. Globs are case insensitive and allow you to specify wildcards to match variable input. For example, `*panic*` matches any error that contains the words "panic", "PANIC" or "PaNiC". +The error messages, log messages and releases filters use glob patterns. Globs are case insensitive and allow you to specify wildcards to match variable input. For example, `*panic*` matches any error that contains the words "panic", "PANIC" or "PaNiC". Some symbols, such as the `*` character, receive special meaning as meta characters. To match a literal asterisk, escape it with a backslash: `\*`. Inbound data filters use the following meta characters: