Startup times

App size

Key Technical Changes

A new minimumLevel parameter is added to the SentryAppender to control the minimum log level for capturing logs. A captureLog method is introduced to create and send Sentry logs from Log4j2's LogEvent. A toSentryLogLevel method is added to convert Log4j2's Level to Sentry's SentryLogLevel. The append method is modified to check the log level against both minimumLevel (for capturing logs) and minimumEventLevel (for capturing events).

Architecture Decisions

The decision was made to use Sentry's existing logging API (Sentry.logger().log()) to capture the log messages. This ensures consistency with other Sentry logging integrations and allows users to leverage Sentry's features for log analysis. The SentryAttributes class is used to add the log message template to the log context.

Dependencies and Interactions

This change depends on the Sentry Java SDK's logging API. It interacts with the existing event capturing mechanism in SentryAppender by adding a new log capturing path. It also interacts with the Log4j2 framework to receive log events.

Risk Considerations

Introducing a new logging path could potentially increase the volume of data sent to Sentry, which might impact performance and billing. Users should carefully configure the minimumLevel parameter to avoid capturing excessive logs. There's also a risk of inconsistencies between the captured logs and events if the log levels are not configured properly. The level comparison logic uses isMoreSpecificThan which means it will capture logs at MORE specific levels, not equal or more specific. This might be counterintuitive.

Notable Implementation Details

The captureLog method extracts the formatted message and parameters from the LogEvent and sends them to Sentry as a log message. The toSentryLogLevel method maps Log4j2's Level to Sentry's SentryLogLevel. The deprecated constructor is kept for backward compatibility but marked as deprecated.