You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: aws/logs_monitoring/README.md
+20Lines changed: 20 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -118,6 +118,24 @@ The <a href="#cloudformation-parameters">environment variables provided on this
118
118
119
119
If you encounter issues upgrading to the latest version, check the Troubleshooting section.
120
120
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
+
121
139
### Upgrade an older version to 4.13.0+
122
140
123
141
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:
0 commit comments