Merge pull request #55499 from bburt-rh/RHDEVDOCS-4892-add-deprecated-alertmanager-keywords

RHDEVDOCS-4892-add-deprecated-alertmanager-key-names

Author: bburt-rh

modules/monitoring-applying-custom-alertmanager-configuration.adoc

@@ -35,15 +35,15 @@ route:
   repeat_interval: 12h
   receiver: default
   routes:
-  - match:
-      alertname: Watchdog
+  - matchers:
+    - "alertname=Watchdog"
     repeat_interval: 5m
     receiver: watchdog
-  - match:
-      service: <your_service> <1>
+  - matchers:
+    - "service=<your_service>" <1>
     routes:
-    - match:
-        <your_matching_rules> <2>
+    - matchers:
+      - <your_matching_rules> <2>
       receiver: <receiver> <3>
 receivers:
 - name: default
@@ -55,6 +55,15 @@ receivers:
 <2> `<your_matching_rules>` specifies the target alerts.
 <3> `receiver` specifies the receiver to use for the alert.
 +
+[NOTE]
+====
+Use the `matchers` key name to indicate the matchers that an alert has to fulfill to match the node.
+Do not use the `match` or `match_re` key names, which are both deprecated and planned for removal in a future release.
+
+In addition, if you define inhibition rules, use the `target_matchers` key name to indicate the target matchers and the `source_matchers` key name to indicate the source matchers.
+Do not use the `target_match`, `target_match_re`, `source_match`, or `source_match_re` key names, which are deprecated and planned for removal in a future release.
+====
++
 The following Alertmanager configuration example configures PagerDuty as an alert receiver:
 +
 [source,yaml,subs=quotes]
@@ -67,15 +76,15 @@ route:
   repeat_interval: 12h
   receiver: default
   routes:
-  - match:
-      alertname: Watchdog
+  - matchers:
+    - "alertname=Watchdog"
     repeat_interval: 5m
     receiver: watchdog
-  *- match:
-      service: example-app
+  *- matchers:
+    - "service=example-app"
     routes:
-    - match:
-        severity: critical
+    - matchers:
+      - "severity=critical"
       receiver: team-frontend-page*
 receivers:
 - name: default