Regenerate client from commit 1358b465 of spec repo (#1189)

Co-authored-by: ci.datadog-api-spec <[email protected]>

Author: api-clients-generation-pipeline[bot]

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.4",
-            "regenerated": "2022-09-30 11:29:17.434933",
-            "spec_repo_commit": "e6eb3136"
+            "regenerated": "2022-10-03 13:35:10.526110",
+            "spec_repo_commit": "1358b465"
         },
         "v2": {
             "apigentools_version": "1.6.4",
-            "regenerated": "2022-09-30 11:29:17.447066",
-            "spec_repo_commit": "e6eb3136"
+            "regenerated": "2022-10-03 13:35:10.538496",
+            "spec_repo_commit": "1358b465"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -6278,6 +6278,24 @@ components:
           description: A Boolean indicating whether tagged users is notified on changes
             to this monitor.
           type: boolean
+        notify_by:
+          description: 'Controls what granularity a monitor alerts on. Only available
+            for multi-alerts.
+
+            For instance, a monitor grouped by `cluster`, `namespace`, `pod` can be
+            configured to only notify on each
+
+            new `cluster` violating the alert conditions by setting `notify_by` to
+            `["cluster"]`. Tags mentioned
+
+            in `notify_by` have to be a subset of the grouping tags in the query.
+
+            For example, a query grouped by `cluster`, `namespace` cannot notify on
+            `region`.'
+          items:
+            description: A grouping tag.
+            type: string
+          type: array
         notify_no_data:
           default: false
           description: A Boolean indicating whether this monitor notifies when data

examples/v1/monitors/ValidateMonitor_4247196452.py

@@ -13,7 +13,7 @@
 body = Monitor(
     name="Example-Validate_a_multi_alert_monitor_returns_OK_response",
     type=MonitorType.LOG_ALERT,
-    query='logs("service:foo AND type:error").index("main").rollup("count").by("source").last("5m") > 2',
+    query='logs("service:foo AND type:error").index("main").rollup("count").by("source,status").last("5m") > 2',
     message="some message Notify: @hipchat-channel",
     tags=[
         "test:examplevalidateamultialertmonitorreturnsokresponse",
@@ -31,6 +31,9 @@
         new_host_delay=600,
         no_data_timeframe=None,
         notify_audit=False,
+        notify_by=[
+            "status",
+        ],
         notify_no_data=False,
         on_missing_data=OnMissingDataOption.SHOW_AND_NOTIFY_NO_DATA,
         renotify_interval=60,

src/datadog_api_client/v1/model/monitor_options.py

@@ -46,6 +46,7 @@ def openapi_types(_):
             "new_host_delay": (int, none_type),
             "no_data_timeframe": (int, none_type),
             "notify_audit": (bool,),
+            "notify_by": ([str],),
             "notify_no_data": (bool,),
             "on_missing_data": (OnMissingDataOption,),
             "renotify_interval": (int, none_type),
@@ -83,6 +84,7 @@ def openapi_types(_):
         "new_host_delay": "new_host_delay",
         "no_data_timeframe": "no_data_timeframe",
         "notify_audit": "notify_audit",
+        "notify_by": "notify_by",
         "notify_no_data": "notify_no_data",
         "on_missing_data": "on_missing_data",
         "renotify_interval": "renotify_interval",
@@ -175,6 +177,13 @@ def __init__(self_, *args, **kwargs):
         :param notify_audit: A Boolean indicating whether tagged users is notified on changes to this monitor.
         :type notify_audit: bool, optional
 
+        :param notify_by: Controls what granularity a monitor alerts on. Only available for multi-alerts.
+            For instance, a monitor grouped by ``cluster`` , ``namespace`` , ``pod`` can be configured to only notify on each
+            new ``cluster`` violating the alert conditions by setting ``notify_by`` to ``["cluster"]``. Tags mentioned
+            in ``notify_by`` have to be a subset of the grouping tags in the query.
+            For example, a query grouped by ``cluster`` , ``namespace`` cannot notify on ``region``.
+        :type notify_by: [str], optional
+
         :param notify_no_data: A Boolean indicating whether this monitor notifies when data stops reporting.
         :type notify_no_data: bool, optional
 

tests/v1/cassettes/test_scenarios/test_validate_a_multialert_monitor_returns_ok_response.frozen

@@ -1 +1 @@
-2022-08-15T18:04:46.756Z
+2022-09-30T16:41:33.797Z

tests/v1/cassettes/test_scenarios/test_validate_a_multialert_monitor_returns_ok_response.yaml

@@ -1,9 +1,9 @@
 interactions:
 - request:
-    body: '{"message":"some message Notify: @hipchat-channel","name":"Test-Validate_a_multi_alert_monitor_returns_OK_response-1660586686","options":{"enable_logs_sample":true,"escalation_message":"the
-      situation has escalated","evaluation_delay":700,"group_retention_duration":"2d","groupby_simple_monitor":false,"include_tags":true,"locked":false,"new_host_delay":600,"no_data_timeframe":null,"notify_audit":false,"notify_no_data":false,"on_missing_data":"show_and_notify_no_data","renotify_interval":60,"require_full_window":true,"thresholds":{"critical":2,"warning":1},"timeout_h":24},"priority":3,"query":"logs(\"service:foo
-      AND type:error\").index(\"main\").rollup(\"count\").by(\"source\").last(\"5m\")
-      > 2","tags":["test:testvalidateamultialertmonitorreturnsokresponse1660586686","env:ci"],"type":"log
+    body: '{"message":"some message Notify: @hipchat-channel","name":"Test-Validate_a_multi_alert_monitor_returns_OK_response-1664556093","options":{"enable_logs_sample":true,"escalation_message":"the
+      situation has escalated","evaluation_delay":700,"group_retention_duration":"2d","groupby_simple_monitor":false,"include_tags":true,"locked":false,"new_host_delay":600,"no_data_timeframe":null,"notify_audit":false,"notify_by":["status"],"notify_no_data":false,"on_missing_data":"show_and_notify_no_data","renotify_interval":60,"require_full_window":true,"thresholds":{"critical":2,"warning":1},"timeout_h":24},"priority":3,"query":"logs(\"service:foo
+      AND type:error\").index(\"main\").rollup(\"count\").by(\"source,status\").last(\"5m\")
+      > 2","tags":["test:testvalidateamultialertmonitorreturnsokresponse1664556093","env:ci"],"type":"log
       alert"}'
     headers:
       accept:
@@ -14,7 +14,9 @@ interactions:
     uri: https://api.datadoghq.com/api/v1/monitor/validate
   response:
     body:
-      string: '{}'
+      string: '{}
+
+        '
     headers:
       content-type:
       - application/json

tests/v1/features/monitors.feature

@@ -115,7 +115,7 @@ Feature: Monitors
   Scenario: Edit a monitor returns "Bad Request" response
     Given new "UpdateMonitor" request
     And request contains "monitor_id" parameter from "REPLACE.ME"
-    And body with value {"options": {"escalation_message": "none", "evaluation_delay": null, "include_tags": true, "min_failure_duration": 0, "min_location_failed": 1, "new_group_delay": null, "new_host_delay": 300, "no_data_timeframe": null, "notify_audit": false, "notify_no_data": false, "on_missing_data": "default", "renotify_interval": null, "renotify_occurrences": null, "renotify_statuses": ["alert"], "synthetics_check_id": null, "threshold_windows": {"recovery_window": null, "trigger_window": null}, "thresholds": {"critical_recovery": null, "ok": null, "unknown": null, "warning": null, "warning_recovery": null}, "timeout_h": null, "variables": [{"compute": {"aggregation": "avg", "interval": 60000, "metric": "@duration"}, "data_source": "rum", "group_by": [{"facet": "status", "limit": 10, "sort": {"aggregation": "avg", "order": "desc"}}], "indexes": ["days-3", "days-7"], "name": "query_errors", "search": {"query": "service:query"}}]}, "restricted_roles": [], "tags": [], "type": "query alert"}
+    And body with value {"options": {"escalation_message": "none", "evaluation_delay": null, "include_tags": true, "min_failure_duration": 0, "min_location_failed": 1, "new_group_delay": null, "new_host_delay": 300, "no_data_timeframe": null, "notify_audit": false, "notify_by": [], "notify_no_data": false, "on_missing_data": "default", "renotify_interval": null, "renotify_occurrences": null, "renotify_statuses": ["alert"], "synthetics_check_id": null, "threshold_windows": {"recovery_window": null, "trigger_window": null}, "thresholds": {"critical_recovery": null, "ok": null, "unknown": null, "warning": null, "warning_recovery": null}, "timeout_h": null, "variables": [{"compute": {"aggregation": "avg", "interval": 60000, "metric": "@duration"}, "data_source": "rum", "group_by": [{"facet": "status", "limit": 10, "sort": {"aggregation": "avg", "order": "desc"}}], "indexes": ["days-3", "days-7"], "name": "query_errors", "search": {"query": "service:query"}}]}, "restricted_roles": [], "tags": [], "type": "query alert"}
     When the request is sent
     Then the response status is 400 Bad Request
 

tests/v1/features/multi_alert_monitor_payload.json

@@ -1,7 +1,7 @@
 {
   "name": "{{ unique }}",
   "type": "log alert",
-  "query": "logs(\"service:foo AND type:error\").index(\"main\").rollup(\"count\").by(\"source\").last(\"5m\") > 2",
+  "query": "logs(\"service:foo AND type:error\").index(\"main\").rollup(\"count\").by(\"source,status\").last(\"5m\") > 2",
   "message": "some message Notify: @hipchat-channel",
   "tags": ["test:{{ unique_lower_alnum }}", "env:ci"],
   "priority": 3,
@@ -16,6 +16,7 @@
     "new_host_delay": 600,
     "no_data_timeframe": null,
     "notify_audit": false,
+    "notify_by": ["status"],
     "notify_no_data": false,
     "on_missing_data": "show_and_notify_no_data",
     "renotify_interval": 60,