add JavaDoc, update CHANGELOG.md, don't consider event.exceptions

Author: lcian

CHANGELOG.md

@@ -5,6 +5,7 @@
 ### Features
 
 - Add `options.ignoredErrors` to filter out errors that match a certain String or Regex ([#4083](https://github.com/getsentry/sentry-java/pull/4083))
+  - The matching is attempted on `event.message`, `event.formatted`, and `{event.throwable.class.name}: {event.throwable.message}`
   - Can be set in `sentry.properties`, e.g. `ignored-errors=Some error,Another .*`
   - Can be set in environment variables, e.g. `SENTRY_IGNORED_ERRORS=Some error,Another .*`
   - For Spring Boot, it can be set in `application.properties`, e.g. `sentry.ignored-errors=Some error,Another .*`

sentry/src/main/java/io/sentry/SentryClient.java

@@ -117,7 +117,7 @@ private boolean shouldApplyScopeData(final @NotNull CheckIn event, final @NotNul
             .getLogger()
             .log(
                 SentryLevel.DEBUG,
-                "Event was dropped as the error %s is ignored",
+                "Event was dropped as it matched a string/pattern in ignoredErrors",
                 event.getMessage());
         options
             .getClientReportRecorder()

sentry/src/main/java/io/sentry/SentryOptions.java

@@ -1578,10 +1578,26 @@ boolean containsIgnoredExceptionForType(final @NotNull Throwable throwable) {
     return this.ignoredExceptionsForType.contains(throwable.getClass());
   }
 
+  /**
+   * Returns the list of strings/regex patterns that `event.message`, `event.formatted`, and
+   * `{event.throwable.class.name}: {event.throwable.message}` are checked against to determine if
+   * an event shall be sent to Sentry or ignored.
+   *
+   * @return the list of strings/regex patterns that `event.message`, `event.formatted`, and
+   *     `{event.throwable.class.name}: {event.throwable.message}` are checked against to determine
+   *     if an event shall be sent to Sentry or ignored
+   */
   public @Nullable List<FilterString> getIgnoredErrors() {
     return ignoredErrors;
   }
 
+  /**
+   * Sets the list of strings/regex patterns that `event.message`, `event.formatted`, and
+   * `{event.throwable.class.name}: {event.throwable.message}` are checked against to determine if
+   * an event shall be sent to Sentry or ignored.
+   *
+   * @param ignoredErrors the list of strings/regex patterns
+   */
   public void setIgnoredErrors(final @Nullable List<String> ignoredErrors) {
     if (ignoredErrors == null) {
       this.ignoredErrors = null;
@@ -1597,6 +1613,13 @@ public void setIgnoredErrors(final @Nullable List<String> ignoredErrors) {
     }
   }
 
+  /**
+   * Adds an item to the list of strings/regex patterns that `event.message`, `event.formatted`, and
+   * `{event.throwable.class.name}: {event.throwable.message}` are checked against to determine if
+   * an event shall be sent to Sentry or ignored.
+   *
+   * @param pattern the string/regex pattern
+   */
   public void addIgnoredError(final @NotNull String pattern) {
     if (ignoredErrors == null) {
       ignoredErrors = new ArrayList<>();

sentry/src/main/java/io/sentry/util/ErrorUtils.java

@@ -3,7 +3,6 @@
 import io.sentry.FilterString;
 import io.sentry.SentryEvent;
 import io.sentry.protocol.Message;
-import io.sentry.protocol.SentryException;
 import java.util.HashSet;
 import java.util.List;
 import java.util.Set;
@@ -34,17 +33,6 @@ public static boolean isIgnored(
         possibleMessages.add(formattedMessage);
       }
     }
-    final @Nullable List<SentryException> exceptions = event.getExceptions();
-    if (exceptions != null && !exceptions.isEmpty()) {
-      for (final @Nullable SentryException exception : exceptions) {
-        if (exception != null) {
-          final @Nullable String value = exception.getValue();
-          if (value != null) {
-            possibleMessages.add(value);
-          }
-        }
-      }
-    }
     final @Nullable Throwable throwable = event.getThrowable();
     if (throwable != null) {
       possibleMessages.add(throwable.toString());