Update API docs for Error Tracking monitors (#2557)

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.6",
-            "regenerated": "2024-11-05 22:28:25.634841",
-            "spec_repo_commit": "2db17c21"
+            "regenerated": "2024-11-06 20:54:41.829245",
+            "spec_repo_commit": "0f558cbc"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-11-05 22:28:25.653962",
-            "spec_repo_commit": "2db17c21"
+            "regenerated": "2024-11-06 20:54:41.847845",
+            "spec_repo_commit": "0f558cbc"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -28985,21 +28985,27 @@ paths:
         ##### Error Tracking Alert Query
 
 
-        Example(RUM): `error-tracking-rum(query).rollup(rollup_method[, measure]).last(time_window)
-        operator #`
+        "New issue" example: `error-tracking(query).source(issue_source).new().rollup(rollup_method[,
+        measure]).by(group_by).last(time_window) operator #`
 
-        Example(APM Traces): `error-tracking-traces(query).rollup(rollup_method[,
-        measure]).last(time_window) operator #`
+        "High impact issue" example: `error-tracking(query).source(issue_source).impact().rollup(rollup_method[,
+        measure]).by(group_by).last(time_window) operator #`
 
 
         - `query` The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
 
+        - `issue_source` The issue source - supports `all`, `browser`, `mobile` and
+        `backend` and defaults to `all` if omitted.
+
         - `rollup_method` The stats roll-up method - supports `count`, `avg`, and
-        `cardinality`.
+        `cardinality` and defaults to `count` if omitted.
 
         - `measure` For `avg` and cardinality `rollup_method` - specify the measure
         or the facet name you want to use.
 
+        - `group by` Comma-separated list of attributes to group by - should contain
+        at least `issue.id`.
+
         - `time_window` #m (between 1 and 2880), #h (between 1 and 48).
 
         - `operator` `<`, `<=`, `>`, `>=`, `==`, or `!=`.

src/main/java/com/datadog/api/client/v1/api/MonitorsApi.java

@@ -464,19 +464,24 @@ public CompletableFuture<Monitor> createMonitorAsync(Monitor body) {
    *
    * <h4>Error Tracking Alert Query</h4>
    *
-   * <p>Example(RUM): <code>
-   * error-tracking-rum(query).rollup(rollup_method[, measure]).last(time_window) operator #</code>
-   * Example(APM Traces): <code>
-   * error-tracking-traces(query).rollup(rollup_method[, measure]).last(time_window) operator #
+   * <p>"New issue" example: <code>
+   * error-tracking(query).source(issue_source).new().rollup(rollup_method[, measure]).by(group_by).last(time_window) operator #
+   * </code> "High impact issue" example: <code>
+   * error-tracking(query).source(issue_source).impact().rollup(rollup_method[, measure]).by(group_by).last(time_window) operator #
    * </code>
    *
    * <ul>
    *   <li><code>query</code> The search query - following the <a
    *       href="https://docs.datadoghq.com/logs/search_syntax/">Log search syntax</a>.
+   *   <li><code>issue_source</code> The issue source - supports <code>all</code>, <code>browser
+   *       </code>, <code>mobile</code> and <code>backend</code> and defaults to <code>all</code> if
+   *       omitted.
    *   <li><code>rollup_method</code> The stats roll-up method - supports <code>count</code>, <code>
-   *       avg</code>, and <code>cardinality</code>.
+   *       avg</code>, and <code>cardinality</code> and defaults to <code>count</code> if omitted.
    *   <li><code>measure</code> For <code>avg</code> and cardinality <code>rollup_method</code> -
    *       specify the measure or the facet name you want to use.
+   *   <li><code>group by</code> Comma-separated list of attributes to group by - should contain at
+   *       least <code>issue.id</code>.
    *   <li><code>time_window</code> #m (between 1 and 2880), #h (between 1 and 48).
    *   <li><code>operator</code> <code>&lt;</code>, <code>&lt;=</code>, <code>&gt;</code>, <code>
    *       &gt;=</code>, <code>==</code>, or <code>!=</code>.