feat: Add method to inform of deprecated plugin option values

[Hipska]

Required for all PRs

• Updated associated README.md.
• Wrote appropriate unit tests.
• Pull request title or commits are in conventional commit format

This will make it possible for plugin authors to deprecate option values they do not support/use anymore.

At the same time, the docs for deprecating options is updated a bit to also include sample for unused options.

[srebhan]

Hmmm why do we want another function? You could do this using models.PrintOptionDeprecationNotice() and the corresponding text, e.g.

models.PrintOptionDeprecationNotice(telegraf.Warn, "category.pluginname", "optionname", telegraf.DeprecationInfo{
				Since:     "1.24.3",
				RemovalIn: "2.0.0",
				Notice:    "value 'whatever' deprecated",
			})

[Hipska]

Clearer error message, as your suggestion will say that optionname itself is deprecated..

[Hipska]

What do you think @srebhan?

[srebhan]

Some minor comments @Hipska...

[Hipska]

!retry-checks

[Hipska]

!retry-failed

[powersj]

!retry-failed

[telegraf-tiger]

Download PR build artifacts for linux_amd64.tar.gz, darwin_amd64.tar.gz, and windows_amd64.zip.
Downloads for additional architectures and packages are available below.

🥳 This pull request decreases the Telegraf binary size by -1.42 % for linux amd64 (new size: 154.9 MB, nightly size 157.1 MB)

📦 Click here to get additional PR build artifacts

Artifact URLs

DEB	RPM	TAR GZ	ZIP
amd64.deb	aarch64.rpm	darwin_amd64.tar.gz	windows_amd64.zip
arm64.deb	armel.rpm	darwin_arm64.tar.gz	windows_i386.zip
armel.deb	armv6hl.rpm	freebsd_amd64.tar.gz
armhf.deb	i386.rpm	freebsd_armv7.tar.gz
i386.deb	ppc64le.rpm	freebsd_i386.tar.gz
mips.deb	riscv64.rpm	linux_amd64.tar.gz
mipsel.deb	s390x.rpm	linux_arm64.tar.gz
ppc64el.deb	x86_64.rpm	linux_armel.tar.gz
riscv64.deb		linux_armhf.tar.gz
s390x.deb		linux_i386.tar.gz
		linux_mips.tar.gz
		linux_mipsel.tar.gz
		linux_ppc64le.tar.gz
		linux_riscv64.tar.gz
		linux_s390x.tar.gz
		static_linux_amd64.tar.gz

[srebhan]

Added require.Eventually example.

[srebhan]

Beautiful. Thanks for your effort @Hipska!

May I ask you to please convert the existing tests in that file to the same schema in a separate PR to serve as a good example!? :-)

[Hipska]

Okay, can you create an Issue for that and assign to me?

[Hipska]

This feature would be used first to deprecate the netsnmp translator.