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

v2.0.0

Powertools for AWS Lambda (Java) 2.0.0 🎉

We are super happy to announce our new major version – v2.0.0 🎉🎉!

We've made Java ecosystem integration the focus of this release, with a complete redesign of the Logging utility to support popular Java logging paradigms and improved modularity across all utilities to reduce deployment package size.

🌟 We couldn't have done this without you 🌟

Thanks to everyone in the community for their patience and assistance as we've been working on this release. Your feedback has been invaluable in shaping this major update.

A special thanks to @​jeromevdl and @​scottgerring for their amazing contributions to this milestone.

We care deeply about minimizing breaking changes

Over the past few months, we carefully selected each breaking change to make, and crafted an extensive upgrade guide to ease your transition to v2. Please let us know whether we can make your upgrade process easier.

What's New in v2 ✨

Java Version Support 🚀

• Minimum required Java version is now Java 11 (Java 8 support has been removed)

Redesigned Logging Utility 📝

• Complete redesign to support popular Java logging paradigms
• Now supports slf4j as logging interface with choice of log4j2 or logback implementations
• Replaced LambdaJsonLayout with standard JsonTemplateLayout
• Uses native slf4j primitives for better integration with Java ecosystem

The new logging utility introduces advanced structured argument serialization features, allowing for more expressive and detailed logging. You can now easily add structured context to your log messages:

// Before v2
private static final Logger LOGGER = LogManager.getLogger(PaymentFunction.class);
LoggingUtils.appendKey("cardNumber", card.getId());
// After v2
private static final Logger LOGGER = LoggerFactory.getLogger(PaymentFunction.class);
MDC.put("cardNumber", card.getId());
// Add structured data directly in log messages
LOGGER.info("Collecting payment", StructuredArguments.entry("orderId", order.getId()));
// { "message": "Collecting payment", ..., "orderId": 123}
// Add multiple structured fields at once
Map<String, String> customKeys = new HashMap<>();
customKeys.put("paymentId", payment.getId());
customKeys.put("amount", payment.getAmount());
LOGGER.info("Payment successful", StructuredArguments.entries(customKeys));
</tr></table>

... (truncated)

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

Changelog

All notable changes to this project will be documented in this file.

This project follows Keep a Changelog format for changes and adheres to Semantic Versioning.

[Unreleased]

[1.20.1] - 2025-04-08

• docs: fix 2 typos (#1739) by @​ntestor
• docs: Correct XML formatting for Maven configuration in Large Messages utility docs (#1796) by @​jreijn
• fix: Load version.properties file as resource stream to fix loading when packaged as jar (#1813) by @​phipag

[1.20.0] - 2025-03-25

• feat(cfn-custom-resource): Add optional 'reason' field for detailed failure reporting (#1758) by @​moizsh

[1.19.0] - 2025-03-07

• chore(deps): Update deps for jackson (#1793) by @​sthulb
• build(deps): bump log4j.version from 2.22.1 to 2.24.3 (#1777) by @​dependabot
• chore(deps): update JSII to 1.108 (#1791) by @​sthulb
• build(deps): bump jinja2 from 3.1.5 to 3.1.6 in /docs (#1789) by @​dependabot
• chore: Update netty version (#1768) by @​sthulb
• chore: Set versions of transitive dependencies (#1767) by @​sthulb
• chore: update Jackson in examples (#1766) by @​sthulb
• build(deps): bump org.apache.maven.plugins:maven-jar-plugin from 3.4.1 to 3.4.2 (#1731) by @​dependabot
• build(deps): bump aws.xray.recorder.version from 2.15.3 to 2.18.1 (#1726) by @​dependabot
• build(deps): bump aws.sdk.version from 2.26.29 to 2.27.12 (#1724) by @​dependabot
• fix: Allow empty responses as well as null response in AppConfig (#1673) by @​chrisclayson
• build(deps): bump aws.sdk.version from 2.27.2 to 2.27.7 (#1715) by @​dependabot
• build(deps): bump aws.sdk.version from 2.26.29 to 2.27.2 (#1714) by @​dependabot
• build(deps): bump aws.sdk.version from 2.25.26 to 2.26.29 (#1713) by @​dependabot
• build(deps): bump aws.sdk.version from 2.26.25 to 2.26.29 (#1712) by @​dependabot
• chore: deprecate java1.8 al1 (#1706) by @​jeromevdl
• chore: java 1.8 AL1 is deprecated, fix E2E tests (#1692) by @​jeromevdl
• build(deps): bump aws.sdk.version from 2.26.21 to 2.26.25 (#1703) by @​dependabot
• build(deps): bump aws.sdk.version from 2.26.3 to 2.26.21 (#1697) by @​dependabot
• build(deps): bump jackson.version from 2.17.0 to 2.17.2 (#1696) by @​dependabot
• build(deps): bump org.apache.commons:commons-lang3 from 3.13.0 to 3.14.0 (#1694) by @​dependabot
• build(deps): bump commons-io:commons-io from 2.15.1 to 2.16.1 (#1691) by @​dependabot
• docs: improve tracing doc for sdk instrumentation (#1687) by @​jeromevdl
• docs: fix tracing links for xray (#1686) by @​jeromevdl
• build(deps): bump org.apache.maven.plugins:maven-failsafe-plugin from 3.2.5 to 3.3.0 (#1679) by @​dependabot
• build(deps): bump aws.sdk.version from 2.25.69 to 2.26.3 (#1658) by @​dependabot
• build(deps): bump com.github.spotbugs:spotbugs-maven-plugin from 4.7.3.6 to 4.8.5.0 (#1657) by @​dependabot
• build(deps): bump org.apache.maven.plugins:maven-checkstyle-plugin from 3.3.0 to 3.4.0 (#1653) by @​dependabot

... (truncated)

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

---

title: Upgrade guide description: Guide to update between major Powertools for AWS Lambda (Java) versions

End of support v1

Given our commitment to all of our customers using Powertools for AWS Lambda (Java), we will keep Maven Central{target="_blank"} v1 releases and a v1 documentation archive to prevent any disruption.

Migrate to v2 from v1

!!! info "We strongly encourage you to migrate to v2. Refer to our versioning policy to learn more about our version support process."

We've made minimal breaking changes to make your transition to v2 as smooth as possible.

Quick summary

The following table shows a summary of the changes made in v2 and whether code changes are necessary. Each change that requires a code change links to a section below explaining more details.

Area	Change	Code change required
Logging	The logging module was re-designed from scratch to support popular Java logging paradigms and libraries like log4j2, logback, and slf4j.	Yes
Metrics	Changed public interface to remove direct coupling with aws-embedded-metrics-java.	Yes
Tracing	Removed deprecated captureResponse and captureError options on @Tracing annotation.	Yes
Idempotency	The powertools-idempotency module was split by provider to improve modularity and reduce the deployment package size.	Yes
Idempotency	Updated IdempotencyConfig interface to support addition of response hooks.	No
Parameters	The powertools-parameters module was split by provider to improve modularity and reduce the deployment package size.	Yes
Batch Processing	Removed deprecated powertools-sqs module in favor of the more generic Batch Processing utility.	Yes
Batch Processing	Updated Batch Processing BatchMessageHandler interface to add support for parallel processing.	No
Validation	The @Validation utility returns 4xx error codes instead of 5xx error codes when used with API Gateway now.	No
Validation	Validating batch event sources now adds failed events as partial batch failures and does not fail the whole batch anymore.	No
Custom Resources	https://github.com/aws-powertools/powertools-lambda-java/blob/main/docs[https://github.com/aws-powertools/powertools-lambda-java/blob/main/docsRhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsehttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsmhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsohttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsvhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsehttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsdhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docs https://github.com/aws-powertools/powertools-lambda-java/blob/main/docsdhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsehttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsphttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsrhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsehttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docschttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsahttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsthttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsehttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsdhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docs https://github.com/aws-powertools/powertools-lambda-java/blob/main/docs`https://github.com/aws-powertools/powertools-lambda-java/blob/main/docsRhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsehttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsshttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsphttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsohttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsnhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsshttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsehttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docs.https://github.com/aws-powertools/powertools-lambda-java/blob/main/docsfhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsahttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsihttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docslhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsehttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsdhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docs(https://github.com/aws-powertools/powertools-lambda-java/blob/main/docs)https://github.com/aws-powertools/powertools-lambda-java/blob/main/docs`https://github.com/aws-powertools/powertools-lambda-java/blob/main/docs https://github.com/aws-powertools/powertools-lambda-java/blob/main/docsahttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsnhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsdhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docs https://github.com/aws-powertools/powertools-lambda-java/blob/main/docs`https://github.com/aws-powertools/powertools-lambda-java/blob/main/docsRhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsehttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsshttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsphttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsohttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsnhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsshttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsehttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docs.https://github.com/aws-powertools/powertools-lambda-java/blob/main/docsshttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsuhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docschttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docschttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsehttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsshttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsshttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docs(https://github.com/aws-powertools/powertools-lambda-java/blob/main/docs)https://github.com/aws-powertools/powertools-lambda-java/blob/main/docs`https://github.com/aws-powertools/powertools-lambda-java/blob/main/docs https://github.com/aws-powertools/powertools-lambda-java/blob/main/docsmhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsehttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsthttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docshhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsohttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsdhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsshttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docs]https://github.com/aws-powertools/powertools-lambda-java/blob/main/docs(https://github.com/aws-powertools/powertools-lambda-java/blob/main/docs#https://github.com/aws-powertools/powertools-lambda-java/blob/main/docschttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsuhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsshttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsthttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsohttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsmhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docs-https://github.com/aws-powertools/powertools-lambda-java/blob/main/docsrhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsehttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsshttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsohttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsuhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsrhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docschttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsehttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsshttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docs-https://github.com/aws-powertools/powertools-lambda-java/blob/main/docsuhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsphttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsdhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsahttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsthttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsehttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsshttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docs-https://github.com/aws-powertools/powertools-lambda-java/blob/main/docsthttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docshhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsehttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docs-https://github.com/aws-powertools/powertools-lambda-java/blob/main/docsrhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsehttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsshttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsphttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsohttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsnhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsshttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsehttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docs-https://github.com/aws-powertools/powertools-lambda-java/blob/main/docschttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docslhttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsahttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsshttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docsshttps://github.com/aws-powertools/powertools-lambda-java/blob/main/docs)https://github.com/aws-powertools/powertools-lambda-java/blob/main/docs.	Yes
Custom Resources	Changed interface of Response class to add an optional reason field.	No
Dependencies	Renamed powertools-core to powertools-common. This module should not be used as direct dependency and is listed here for completeness.	No
Dependencies	Removed org.aspectj.aspectjrt as project dependency in favor of consumers including the version they prefer.	Yes
Language support	Removed support for Java 8. The minimum required Java version is Java 11.	N/A

First Steps

Before you start, we suggest making a copy of your current working project or create a new branch with git.

1. Upgrade Java to at least version 11. While version 11 is supported, we recommend using the newest available LTS version{target="_blank"} of Java.
2. Review the following section to confirm if you need to make changes to your code.

Redesigned Logging Utility

... (truncated)

• c096d56 chore(ci): bump version to 2.0.0
• b314321 chore(ci): bump version to 2.0.0-RC1 (#1875)
• e3d4c7e Fix remaining maven central properties required. (#1872)
• af31d6f Add Maven Central required info to pom.xml and skip deploying e2e tests and p...
• 92926f3 fix(ci): Checkout repo on doc release (#1869)
• 20a4d94 chore(v2): Remove rule preventing production release of 2.0.0 (#1867)
• fa1c37d docs(metrics): Add upgrade guide for re-designed Metrics utility (#1868)
• 57ae153 feat(metrics): New metrics module implementation with support for Metrics pro...
• 4444b4b chore(ci): Set snapshot repository to "central" server ID
• 54ef1e9 fix(ci): Fix failing E2E tests and temporarily exclude TracingE2E (#1847)
• 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)