From 337a4b00cdc6dd633fb43be53e7544fa278c9d24 Mon Sep 17 00:00:00 2001 From: Vincent Boutour Date: Tue, 21 Oct 2025 14:41:24 +0200 Subject: [PATCH 1/2] feat: Add link to the changelog in the read toe reflect the documentation The readme is feeding this page https://docs.datadoghq.com/logs/guide/forwarder/?tab=cloudformation Signed-off-by: Vincent Boutour --- aws/logs_monitoring/README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/aws/logs_monitoring/README.md b/aws/logs_monitoring/README.md index 4dd97323f..5a6a77e8b 100644 --- a/aws/logs_monitoring/README.md +++ b/aws/logs_monitoring/README.md @@ -118,6 +118,24 @@ The environment variables provided on this If you encounter issues upgrading to the latest version, check the Troubleshooting section. +### Upgrade to v5.0.0+ + +**Version 5.0.0 is a major release with breaking changes.** Before upgrading, review the [CHANGELOG.md][25] for detailed information about breaking changes and migration requirements. + +Key breaking changes in v5.0.0: + +- **Log filtering behavior changed**: `IncludeAtMatch` and `ExcludeAtMatch` now match against the log message only, not the entire JSON structure +- **TCP transport removed**: `DD_USE_TCP` parameter removed, all logs must use HTTP/HTTPS +- **PrivateLink variable removed**: `DD_USE_PRIVATE_LINK` removed (PrivateLink is still supported via `DdUseVPC`) +- **New tag enrichment**: Backend-based tag enrichment enabled by default via `DdEnrichS3Tags` and `DdEnrichCloudwatchTags`, reducing forwarder costs + +Before upgrading: + +1. Review and update any log filtering regex patterns +2. Remove any `DD_USE_TCP` or `DD_USE_PRIVATE_LINK` environment variables +3. Ensure [Resource Collection][26] is enabled in your AWS integration for tag enrichment features +4. Review the complete breaking changes in [CHANGELOG.md][25] + ### Upgrade an older version to 4.13.0+ Starting version 4.13.0+ Lambda function has been updated to require **Python 3.13**. If upgrading an older forwarder installation to 4.13.0+, ensure AWS Lambda function is configured to use Python 3.13 @@ -762,3 +780,5 @@ Additional helpful documentation, links, and articles: [22]: https://docs.datadoghq.com/agent/guide/private-link/ [23]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html [24]: https://docs.datadoghq.com/logs/log_configuration/processors/?tab=ui#log-date-remapper +[25]: https://github.com/DataDog/datadog-serverless-functions/blob/master/aws/logs_monitoring/CHANGELOG.md +[26]: https://docs.datadoghq.com/integrations/amazon-web-services/#resource-collection From ef2306d20cfdd0c1ba6ecc5d7701cea5786c958d Mon Sep 17 00:00:00 2001 From: Vincent Boutour Date: Tue, 21 Oct 2025 16:12:54 +0200 Subject: [PATCH 2/2] fixup! feat: Add link to the changelog in the read toe reflect the documentation Signed-off-by: Vincent Boutour --- aws/logs_monitoring/README.md | 8 -------- 1 file changed, 8 deletions(-) diff --git a/aws/logs_monitoring/README.md b/aws/logs_monitoring/README.md index 5a6a77e8b..ac0fd3332 100644 --- a/aws/logs_monitoring/README.md +++ b/aws/logs_monitoring/README.md @@ -129,13 +129,6 @@ Key breaking changes in v5.0.0: - **PrivateLink variable removed**: `DD_USE_PRIVATE_LINK` removed (PrivateLink is still supported via `DdUseVPC`) - **New tag enrichment**: Backend-based tag enrichment enabled by default via `DdEnrichS3Tags` and `DdEnrichCloudwatchTags`, reducing forwarder costs -Before upgrading: - -1. Review and update any log filtering regex patterns -2. Remove any `DD_USE_TCP` or `DD_USE_PRIVATE_LINK` environment variables -3. Ensure [Resource Collection][26] is enabled in your AWS integration for tag enrichment features -4. Review the complete breaking changes in [CHANGELOG.md][25] - ### Upgrade an older version to 4.13.0+ Starting version 4.13.0+ Lambda function has been updated to require **Python 3.13**. If upgrading an older forwarder installation to 4.13.0+, ensure AWS Lambda function is configured to use Python 3.13 @@ -781,4 +774,3 @@ Additional helpful documentation, links, and articles: [23]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html [24]: https://docs.datadoghq.com/logs/log_configuration/processors/?tab=ui#log-date-remapper [25]: https://github.com/DataDog/datadog-serverless-functions/blob/master/aws/logs_monitoring/CHANGELOG.md -[26]: https://docs.datadoghq.com/integrations/amazon-web-services/#resource-collection