Deprecate the Log Analytics callback plugin (#11505)

* Deprecate the Log Analytics callback plugin

The Azure Monitor "HTTP Data Collector API" has been deprecated by
Microsoft.  The old API has been replaced by the new "Logs Ingestion
API", which will require a new callback plugin due to major differences
between the APIs.

* Apply suggestions from code review

Co-authored-by: Felix Fontein <felix@fontein.de>

* Apply suggestions from code review

Co-authored-by: Felix Fontein <felix@fontein.de>

---------

Co-authored-by: Felix Fontein <felix@fontein.de>

changelogs/fragments/11505-loganalytics-deprecation.yml

@@ -0,0 +1,2 @@
+deprecated_features:
+  - loganalytics callback plugin - is deprecated in favor of ``community.general.loganalytics_ingestion`` due to upcoming API changes in Azure Monitor (https://github.com/ansible-collections/community.general/pull/11505).

meta/runtime.yml

@@ -94,6 +94,10 @@ plugin_routing:
       tombstone:
         removal_version: 10.0.0
         warning_text: The hipchat service has been discontinued and the self-hosted variant has been End of Life since 2020.
+    loganalytics:
+      deprecation:
+        removal_version: 14.0.0
+        warning_text: The "HTTP Data Collector API" used by the plugin has been deprecated in Azure and replaced with the "Logs Ingestion API".  Please migrate to the 'community.general.loganalytics_ingestion' plugin.
     osx_say:
       redirect: community.general.say
     stderr:

plugins/callback/loganalytics.py

@@ -35,6 +35,10 @@ options:
     ini:
       - section: callback_loganalytics
         key: shared_key
+deprecated:
+  removed_in: 14.0.0
+  why: The "HTTP Data Collector API" used by the plugin has been deprecated in Azure Monitor and replaced with the "Logs Ingestion API".
+  alternative: Please migrate to the P(community.general.loganalytics_ingestion#callback) plugin.
 """
 
 EXAMPLES = r"""