From 2440e2ecf3a54dae894ae46e6d56b645d7f1ea69 Mon Sep 17 00:00:00 2001 From: "ci.datadog-api-spec" Date: Fri, 11 Sep 2026 19:37:37 +0000 Subject: [PATCH] Regenerate client from commit b34c6c8 of spec repo --- .generator/schemas/v2/openapi.yaml | 30 +++++++++++-------- .../CreateTimeseriesAnomalyInvestigation.py | 2 +- .../timeseries_anomaly_investigations_api.py | 5 ++-- ...imeseries_anomaly_investigation_anomaly.py | 2 +- ...imeseries_anomaly_investigation_formula.py | 2 ++ ...timeseries_anomaly_investigation_result.py | 5 ++-- .../timeseries_anomaly_investigations.feature | 2 +- 7 files changed, 29 insertions(+), 19 deletions(-) diff --git a/.generator/schemas/v2/openapi.yaml b/.generator/schemas/v2/openapi.yaml index c2a236c053..a681b29aea 100644 --- a/.generator/schemas/v2/openapi.yaml +++ b/.generator/schemas/v2/openapi.yaml @@ -121598,7 +121598,7 @@ components: type: array type: object TimeseriesAnomalyInvestigationAnomaly: - description: Most significant anomaly detected in the request. + description: One of the most significant anomalies detected in the request. properties: anomaly_detection: $ref: "#/components/schemas/TimeseriesAnomalyInvestigationDetection" @@ -121774,8 +121774,11 @@ components: description: Formula evaluated by the timeseries request. properties: formula: - description: Formula expression referencing one or more named queries. - example: "anomalies(query1, 'agile', 3)" + description: |- + Formula expression referencing one or more named queries. + When the expression does not contain an explicit `anomalies()` call, + the endpoint applies the default Watchdog Explains anomaly detection configuration. + example: query1 minLength: 1 type: string limit: @@ -121966,7 +121969,7 @@ components: description: Timeseries requests to investigate. This API version accepts exactly one request. example: - formulas: - - formula: "anomalies(query1, 'agile', 3)" + - formula: query1 from: 1754406000000 queries: - data_source: metrics @@ -122088,11 +122091,13 @@ components: description: Completed result for one timeseries request. The anomalies array is empty when no qualifying anomaly is found. properties: anomalies: - description: Detected anomalies. This API version returns at most one anomaly. + description: |- + Detected anomalies, ordered by significance. This API version returns at most + three anomalies across the submitted request. example: [] items: $ref: "#/components/schemas/TimeseriesAnomalyInvestigationAnomaly" - maxItems: 1 + maxItems: 3 type: array status: $ref: "#/components/schemas/TimeseriesAnomalyInvestigationCompleteStatus" @@ -122190,7 +122195,7 @@ components: formulas: description: Formulas to evaluate. Each formula may contain an explicit `anomalies()` call or a supported metrics expression. example: - - formula: "anomalies(query1, 'agile', 3)" + - formula: query1 items: $ref: "#/components/schemas/TimeseriesAnomalyInvestigationFormula" minItems: 1 @@ -224627,8 +224632,9 @@ paths: /api/v2/timeseries-anomaly-investigations: post: description: |- - Investigates a metrics timeseries request for its most significant anomaly and returns deterministic findings. - Metrics queries with or without grouping are supported. This API version accepts exactly one request and returns at most one anomaly. + Investigates a metrics timeseries request for its most significant anomalies and returns + deterministic findings. Metrics queries with or without grouping are supported. This + API version accepts exactly one request and returns at most three anomalies. operationId: CreateTimeseriesAnomalyInvestigation requestBody: content: @@ -224640,7 +224646,7 @@ paths: attributes: requests: - formulas: - - formula: "anomalies(query1, 'agile', 3)" + - formula: query1 from: 1754406000000 queries: - data_source: metrics @@ -224664,8 +224670,8 @@ paths: results: - anomalies: - anomaly_detection: - configuration_source: request_formula - profile: + configuration_source: watchdog_explains_default + profile: watchdog_explains_v1 detected_interval: end: 1754406120000 start: 1754406060000 diff --git a/examples/v2/timeseries-anomaly-investigations/CreateTimeseriesAnomalyInvestigation.py b/examples/v2/timeseries-anomaly-investigations/CreateTimeseriesAnomalyInvestigation.py index 1b997a8a7f..37f220bfd4 100644 --- a/examples/v2/timeseries-anomaly-investigations/CreateTimeseriesAnomalyInvestigation.py +++ b/examples/v2/timeseries-anomaly-investigations/CreateTimeseriesAnomalyInvestigation.py @@ -30,7 +30,7 @@ TimeseriesAnomalyInvestigationTimeseriesRequest( formulas=[ TimeseriesAnomalyInvestigationFormula( - formula="anomalies(query1, 'agile', 3)", + formula="query1", ), ], _from=1754406000000, diff --git a/src/datadog_api_client/v2/api/timeseries_anomaly_investigations_api.py b/src/datadog_api_client/v2/api/timeseries_anomaly_investigations_api.py index 02de068e57..efd95d0ad0 100644 --- a/src/datadog_api_client/v2/api/timeseries_anomaly_investigations_api.py +++ b/src/datadog_api_client/v2/api/timeseries_anomaly_investigations_api.py @@ -47,8 +47,9 @@ def create_timeseries_anomaly_investigation( ) -> TimeseriesAnomalyInvestigationResponse: """Investigate a timeseries anomaly. - Investigates a metrics timeseries request for its most significant anomaly and returns deterministic findings. - Metrics queries with or without grouping are supported. This API version accepts exactly one request and returns at most one anomaly. + Investigates a metrics timeseries request for its most significant anomalies and returns + deterministic findings. Metrics queries with or without grouping are supported. This + API version accepts exactly one request and returns at most three anomalies. :param body: Metrics timeseries request to investigate. The request body must not exceed 2 MiB. :type body: TimeseriesAnomalyInvestigationRequest diff --git a/src/datadog_api_client/v2/model/timeseries_anomaly_investigation_anomaly.py b/src/datadog_api_client/v2/model/timeseries_anomaly_investigation_anomaly.py index e1f55f06ad..2ffaa4a0ea 100644 --- a/src/datadog_api_client/v2/model/timeseries_anomaly_investigation_anomaly.py +++ b/src/datadog_api_client/v2/model/timeseries_anomaly_investigation_anomaly.py @@ -111,7 +111,7 @@ def __init__( **kwargs, ): """ - Most significant anomaly detected in the request. + One of the most significant anomalies detected in the request. :param anomaly_detection: Anomaly detection configuration used for the result. :type anomaly_detection: TimeseriesAnomalyInvestigationDetection diff --git a/src/datadog_api_client/v2/model/timeseries_anomaly_investigation_formula.py b/src/datadog_api_client/v2/model/timeseries_anomaly_investigation_formula.py index d577a35312..640ddb1d7c 100644 --- a/src/datadog_api_client/v2/model/timeseries_anomaly_investigation_formula.py +++ b/src/datadog_api_client/v2/model/timeseries_anomaly_investigation_formula.py @@ -49,6 +49,8 @@ def __init__( Formula evaluated by the timeseries request. :param formula: Formula expression referencing one or more named queries. + When the expression does not contain an explicit ``anomalies()`` call, + the endpoint applies the default Watchdog Explains anomaly detection configuration. :type formula: str :param limit: Optional formula limit accepted for compatibility with Timeseries API requests. Formula limits have no effect on timeseries queries. diff --git a/src/datadog_api_client/v2/model/timeseries_anomaly_investigation_result.py b/src/datadog_api_client/v2/model/timeseries_anomaly_investigation_result.py index 33fbd3eaf2..a945347176 100644 --- a/src/datadog_api_client/v2/model/timeseries_anomaly_investigation_result.py +++ b/src/datadog_api_client/v2/model/timeseries_anomaly_investigation_result.py @@ -23,7 +23,7 @@ class TimeseriesAnomalyInvestigationResult(ModelNormal): validations = { "anomalies": { - "max_items": 1, + "max_items": 3, }, } @@ -55,7 +55,8 @@ def __init__( """ Completed result for one timeseries request. The anomalies array is empty when no qualifying anomaly is found. - :param anomalies: Detected anomalies. This API version returns at most one anomaly. + :param anomalies: Detected anomalies, ordered by significance. This API version returns at most + three anomalies across the submitted request. :type anomalies: [TimeseriesAnomalyInvestigationAnomaly] :param status: Status value indicating successful completion. diff --git a/tests/v2/features/timeseries_anomaly_investigations.feature b/tests/v2/features/timeseries_anomaly_investigations.feature index 6803ddc447..1c7b759600 100644 --- a/tests/v2/features/timeseries_anomaly_investigations.feature +++ b/tests/v2/features/timeseries_anomaly_investigations.feature @@ -9,7 +9,7 @@ Feature: Timeseries Anomaly Investigations And an instance of "TimeseriesAnomalyInvestigations" API And operation "CreateTimeseriesAnomalyInvestigation" enabled And new "CreateTimeseriesAnomalyInvestigation" request - And body with value {"data": {"attributes": {"requests": [{"formulas": [{"formula": "anomalies(query1, 'agile', 3)"}], "from": 1754406000000, "queries": [{"data_source": "metrics", "name": "query1", "query": "avg:system.cpu.user{env:prod} by {service}"}], "to": 1754423940000}]}, "type": "timeseries_anomaly_investigation"}} + And body with value {"data": {"attributes": {"requests": [{"formulas": [{"formula": "query1"}], "from": 1754406000000, "queries": [{"data_source": "metrics", "name": "query1", "query": "avg:system.cpu.user{env:prod} by {service}"}], "to": 1754423940000}]}, "type": "timeseries_anomaly_investigation"}} @generated @skip @team:DataDog/dataviz-backend-maintainers Scenario: Investigate a timeseries anomaly returns "Bad Request" response