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

v2.1.1

Changes

[Human readable summary of changes]

• chore(ci): bump version to 2.1.1 (#1910) by @github-actions[bot]
• chore(ci): bump version to 2.1.0 (#1904) by @github-actions[bot]

This release was made possible by the following contributors:

@​github-actions[bot], @​phipag and github-actions[bot]

v2.1.0

Changes

• chore(ci): bump version to 2.1.0 (#1904) by @github-actions[bot]
• chore(ci): Update workflows to make v2 the default (#1888) by @​sthulb
• chore(ci): bump version to 2.0.0 (#1876) by @github-actions[bot]

📜 Documentation updates

• docs: Announce deprecation of v1 (#1896) by @​phipag
• docs: Version documentation (#1878) by @​phipag

🐛 Bug and hot fixes

• fix(ci): Add project description for new kafka utility (#1903) by @​phipag
• fix(metrics): Do not flush when no metrics were added to avoid printing root-level _aws dict (#1891) by @​phipag

This release was made possible by the following contributors:

@​github-actions[bot], @​phipag, @​sthulb and github-actions[bot]

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.

... (truncated)

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

---

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

End of support v1

!!! warning "End of support notice" On December 12th, 2025, Powertools for AWS Lambda (Java) v1 will reach end of support and will no longer receive updates or releases. If you are still using v1, we strongly recommend you to read our upgrade guide and update to the latest version.

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)

• c1b4187 chore(ci): bump version to 2.1.1
• 4a8511d fix(kafka): Handle message indices in proto data also for Glue Schema Registr...
• 8f70e83 chore(ci): bump version to 2.1.0 (#1904)
• cf01e91 fix(ci): Add maven project description to Kafka utility. (#1903)
• f563d23 fix(kafka): Add support for confluent message indices. (#1902)
• eebc06a feat(kafka): New Kafka utility (#1898)
• 8a040ac fix(metrics): Do not flush when no metrics were added to avoid printing root-...
• cc1b3b1 docs: Announce deprecation of v1
• 0b27594 chore(ci): Update workflows to make v2 the default (#1888)
• 871a844 docs: Version documentation (#1878)
• 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)