NOTES:

• This Go module has been updated to Go 1.24 per the Go support policy. Any consumers building on earlier Go versions may experience errors. (#263)
• tfsdklog.RegisterTestSink is deprecated in favor or tfsdklog.ContextWithTestLogging (#264)

FEATURES:

• Added tfsdklog.ContextWithStandardLogging() for test sweeper logging (#162)

NOTES:

• This Go module has been updated to Go 1.19 per the Go support policy. Any consumers building on earlier Go versions may experience errors. (#137)

ENHANCEMENTS:

• tfsdklog: Improved logging performance 20x when logs would be skipped due to logging level (#149)

NOTES:

• This Go module has been updated to Go 1.18 per the Go support policy. Any consumers building on earlier Go versions may experience errors. (#95)

BUG FIXES:

• tflog+tflogsdk: Prevented data race conditions when using SetField and other option functions (#132)

FEATURES:

• tflog: Added MaskAllFieldValuesRegexes(), MaskAllFieldValuesStrings(), MaskLogRegexes() and MaskLogStrings() functions, which extend further the log masking filtering, for the provider root logger (#87)
• tflog: Added SubsystemMaskAllFieldValuesRegexes(), SubsystemMaskAllFieldValuesStrings(), SubsystemMaskLogRegexes() and SubsystemMaskLogStrings() functions, which extend further the log masking filtering, for provider subsystem loggers (#87)
• tfsdklog: Same functions added to the tflog package (#87)

BREAKING CHANGES:

• tflog: renamed With() and SubsystemWith(), to SetField() and SubsystemSetField() respectively (#78)
• tflog: renamed WithMaskFieldValueWithFieldKeys() and SubsystemWithMaskFieldValueWithFieldKeys(), to MaskFieldValuesWithFieldKeys() and SubsystemMaskFieldValuesWithFieldKeys() respectively (#78)
• tflog: renamed WithMaskLogMatchingString() and SubsystemWithMaskLogMatchingString(), to MaskMessageStrings() and SubsystemMaskMessageStrings() respectively (#78)
• tflog: renamed WithMaskMessageRegex() and SubsystemWithMaskMessageRegex(), to MaskMessageRegexes() and SubsystemMaskMessageRegexes() respectively (#78)
• tflog: renamed WithOmitLogMatchingString() and SubsystemWithOmitLogMatchingString(), to OmitLogWithMessageStrings() and SubsystemOmitLogWithMessageStrings() respectively (#78)
• tflog: renamed WithOmitLogWithFieldKeys() and SubsystemWithOmitLogWithFieldKeys(), to OmitLogWithFieldKeys() and SubsystemOmitLogWithFieldKeys() respectively (#78)
• tflog: renamed WithOmitLogWithMessageRegex() and SubsystemWithOmitLogWithMessageRegex(), to OmitLogWithMessageRegexes() and SubsystemOmitLogWithMessageRegexes() respectively (#78)
• tfsdklog: same renaming as for the tflog package (#78)

FEATURES:

• tflog: Added SubsystemWithOmitLogWithFieldKeys(), SubsystemWithOmitLogWithMessageRegex(), SubsystemWithOmitLogMatchingString(), SubsystemWithMaskFieldValueWithFieldKeys(), SubsystemWithMaskMessageRegex() and SubsystemWithMaskLogMatchingString() functions, which provide log omission and log masking filtering, based on message and argument keys, for provider subsystem loggers (#71)
• tflog: Added WithOmitLogWithFieldKeys(), WithOmitLogWithMessageRegex(), WithOmitLogMatchingString(), WithMaskFieldValueWithFieldKeys(), WithMaskMessageRegex() and WithMaskLogMatchingString() functions, which provide log omission and log masking filtering, based on message and argument keys, for the provider root logger (#71)
• tfsdklog: Added SubsystemWithOmitLogWithFieldKeys(), SubsystemWithOmitLogWithMessageRegex(), SubsystemWithOmitLogMatchingString(), SubsystemWithMaskFieldValueWithFieldKeys(), SubsystemWithMaskMessageRegex()and SubsystemWithMaskLogMatchingString() functions, which provide log omission and log masking filtering, based on message and argument keys, for SDK subsystem loggers (#71)
• tfsdklog: Added WithOmitLogWithFieldKeys(), WithOmitLogWithMessageRegex(), WithOmitLogMatchingString(), WithMaskFieldValueWithFieldKeys(), WithMaskMessageRegex() and WithMaskLogMatchingString() functions, which provide log omission and log masking filtering, based on message and argument keys, for the SDK root logger (#71)

NOTES:

• The gopkg.in/yaml.v3 dependency has been updated to address CVE-2022-28948 (#69)

NOTES:

• This Go module has been updated to Go 1.17 per the Go support policy. Any consumers building on earlier Go versions may experience errors. (#51)

FEATURES:

• Added tflogtest package, which provides functionality for unit testing of provider logging (#62)
• Added tfsdklogtest package, which provides functionality for unit testing of SDK logging (#62)

ENHANCEMENTS:

• tflog: Added WithRootFields() function, which can copy root logger fields to a new subsystem logger during NewSubsystem() (#60)
• tfsdklog: Added WithRootFields() function, which can copy root logger fields to a new subsystem logger during NewSubsystem() (#60)

BUG FIXES:

• tflog+tfsdklog: Prevented Unable to create logging subsystem with AdditionalLocationOffset due to missing root logger options warning logs during acceptance testing (#58)

NOTES:

• The following Go modules, if used, must be also be updated when updating to this terraform-plugin-log version:
  • terraform-plugin-framework: v0.6.0 or higher
  • terraform-plugin-go: v0.8.0 or higher
  • terraform-plugin-mux: v0.6.0 or higher
  • terraform-plugin-sdk: v2.11.0 or higher

BREAKING CHANGES:

• tflog: The Trace(), Debug(), Info(), Warn(), and Error() functions and Subsystem equivalents now use ...map[string]interface{} as the final optional parameter, where the string is the structured logging key, rather than expecting matched key interface{}, value interface{} pairs. If multiple maps contain the same key, the value is shallow merged. (#34)
• tfsdklog: The Trace(), Debug(), Info(), Warn(), and Error() functions and Subsystem equivalents now use ...map[string]interface{} as the final optional parameter, where the string is the structured logging key, rather than expecting matched key interface{}, value interface{} pairs. If multiple maps contain the same key, the value is shallow merged. (#34)

ENHANCEMENTS:

• tflog: Added WithAdditionalLocationOffset function, which allows implementations to adjust the location offset when using helper functions (#36)
• tfsdklog: Added WithAdditionalLocationOffset function, which allows implementations to adjust the location offset when using helper functions (#36)

BUG FIXES:

• tfsdklog: Consolidated multiple invalid log level messages and added missing newline (#35)