[NIFI-10471] Document and Apply Deprecation Logging

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 1.18.0
• Component/s: Core Framework, Extensions
• Assignee: David Handermann
• Reporter: David Handermann
• Created: 09/Sep/22 17:56
• Updated: 14/Sep/22 20:22
• Resolved: 14/Sep/22 20:22

Description

The recent introduction of the DeprecationLogger and nifi-deprecation.log configuration provide the basis for applying deprecation logging to number of components and features.

The User Guide and should be updated with additional details describing how to interpret deprecation logs, how to disable deprecation logging. The Developer Guide should include a new section outlining recommendations on where and how to apply deprecation logging.

Additional targets for deprecation logging include Processors and Controller Services that are already marked as deprecated. Public methods implementing deprecated interfaces should be evaluated for deprecation logging. Not every method marked as deprecated should be logged, as some operations may produce duplicative logs, and other methods should be addressed through code changes instead of logged warnings.

Issue Links

• is related to: NIFI-9374 Implement Standard Logging for Deprecated Features
• links to: GitHub Pull Request #6390