Skip to content

Commit 337a4b0

Browse files
committed
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 <vincent.boutour@datadoghq.com>
1 parent 8edda81 commit 337a4b0

1 file changed

Lines changed: 20 additions & 0 deletions

File tree

aws/logs_monitoring/README.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -118,6 +118,24 @@ The <a href="#cloudformation-parameters">environment variables provided on this
118118

119119
If you encounter issues upgrading to the latest version, check the Troubleshooting section.
120120

121+
### Upgrade to v5.0.0+
122+
123+
**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.
124+
125+
Key breaking changes in v5.0.0:
126+
127+
- **Log filtering behavior changed**: `IncludeAtMatch` and `ExcludeAtMatch` now match against the log message only, not the entire JSON structure
128+
- **TCP transport removed**: `DD_USE_TCP` parameter removed, all logs must use HTTP/HTTPS
129+
- **PrivateLink variable removed**: `DD_USE_PRIVATE_LINK` removed (PrivateLink is still supported via `DdUseVPC`)
130+
- **New tag enrichment**: Backend-based tag enrichment enabled by default via `DdEnrichS3Tags` and `DdEnrichCloudwatchTags`, reducing forwarder costs
131+
132+
Before upgrading:
133+
134+
1. Review and update any log filtering regex patterns
135+
2. Remove any `DD_USE_TCP` or `DD_USE_PRIVATE_LINK` environment variables
136+
3. Ensure [Resource Collection][26] is enabled in your AWS integration for tag enrichment features
137+
4. Review the complete breaking changes in [CHANGELOG.md][25]
138+
121139
### Upgrade an older version to 4.13.0+
122140

123141
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:
762780
[22]: https://docs.datadoghq.com/agent/guide/private-link/
763781
[23]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-aws-serverless.html
764782
[24]: https://docs.datadoghq.com/logs/log_configuration/processors/?tab=ui#log-date-remapper
783+
[25]: https://github.com/DataDog/datadog-serverless-functions/blob/master/aws/logs_monitoring/CHANGELOG.md
784+
[26]: https://docs.datadoghq.com/integrations/amazon-web-services/#resource-collection

0 commit comments

Comments
 (0)