Sourced from software.amazon.lambda:powertools-cloudformation's releases.

v2.4.0

Summary

We are excited to announce a new feature in Logger: Logger buffering. This new feature allows you to buffer logs for a specific invocation, and flush them automatically on error or manually as needed.

We also added GraalVM support for CloudFormation and Idempotency utilities, expanding native compilation capabilities for better performance and reduced cold start times.

⭐️ Thanks to @​ConnorKirk, @​aryannikhil, and @​kjswaruph for their first-time contributions to this release!

New Log Buffering feature

Docs

You can now enable log buffering by configuring the BufferingAppender in your logging configuration. This feature allows you to:

• Buffer logs at the WARNING, INFO, and DEBUG levels
• Automatically flush logs on error or manually as needed
• Reduce CloudWatch costs by decreasing the number of emitted log messages

public class PaymentFunction implements RequestHandler<APIGatewayProxyRequestEvent, APIGatewayProxyResponseEvent> {
private static final Logger LOGGER = LoggerFactory.getLogger(PaymentFunction.class);
@Logging

public APIGatewayProxyResponseEvent handleRequest(final APIGatewayProxyRequestEvent input, final Context context) {

LOGGER.debug(&quot;Processing payment&quot;);  // this is buffered

LOGGER.info(&quot;Payment validation complete&quot;);  // this is not buffered
LOGGER.error(&amp;quot;Payment failed&amp;quot;);  // this will flush the buffer automatically

return new APIGatewayProxyResponseEvent().withStatusCode(500);

}


}

Configuration options

Log buffering is configured through your logging framework configuration (Log4j2 or Logback) using the BufferingAppender:

Option	Description	Default
maxBytes	Maximum size of the buffer in bytes	20480
bufferAtVerbosity	Minimum log level to buffer (more verbose levels are also buffered)	DEBUG
flushOnErrorLog	Whether to flush buffer when an error is logged	true

When log buffering is enabled, you can use the @Logging annotation with flushBufferOnUncaughtError = true to automatically flush the buffer when an uncaught exception occurs. This enables you to have detailed logs from your application when you need them the most.

Here is an example log4j2.xml configuration:

... (truncated)

• 3f51c39 chore(ci): bump version to 2.4.0
• 3de08f9 chore(ci): Set mockito SNAPSHOT version only for Graal profiles. (#2138)
• 29e52c2 chore(ci): Do not use Mockito SNAPSHOT version for release. (#2137)
• 4c1520e Skip maven deployment for e2e test handlers. (#2131)
• a2eecae chore(ci): Fix circular dependency in dynamodb-local and maven packaging phas...
• b36d8ba chore: bump org.yaml:snakeyaml from 2.4 to 2.5 (#2111)
• 7c5acf5 chore: bump io.github.ascopes:protobuf-maven-plugin from 3.8.1 to 3.9.0 (#2114)
• 1ffc374 chore: bump aws.sdk.version from 2.32.31 to 2.33.1 (#2115)
• 7d79066 chore: bump graalvm/setup-graalvm from 1.3.5 to 1.3.6 (#2116)
• eb8bc4e chore: bump software.amazon.awscdk:aws-cdk-lib from 2.213.0 to 2.214.0 (#2117)
• Additional commits viewable in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)