Add timeseries anomaly investigations API

features/v2/timeseries_anomaly_investigations.feature

@@ -0,0 +1,32 @@
+@endpoint(timeseries-anomaly-investigations) @endpoint(timeseries-anomaly-investigations-v2)
+Feature: Timeseries Anomaly Investigations
+  Investigate metrics timeseries anomalies and return deterministic
+  findings.
+
+  Background:
+    Given a valid "apiKeyAuth" key in the system
+    And a valid "appKeyAuth" key in the system
+    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"}}
+
+  @generated @skip @team:DataDog/dataviz-backend-maintainers
+  Scenario: Investigate a timeseries anomaly returns "Bad Request" response
+    When the request is sent
+    Then the response status is 400 Bad Request
+
+  @generated @skip @team:DataDog/dataviz-backend-maintainers
+  Scenario: Investigate a timeseries anomaly returns "OK" response
+    When the request is sent
+    Then the response status is 200 OK
+
+  @generated @skip @team:DataDog/dataviz-backend-maintainers
+  Scenario: Investigate a timeseries anomaly returns "Payload Too Large" response
+    When the request is sent
+    Then the response status is 413 Payload Too Large
+
+  @generated @skip @team:DataDog/dataviz-backend-maintainers
+  Scenario: Investigate a timeseries anomaly returns "Unprocessable Entity" response
+    When the request is sent
+    Then the response status is 422 Unprocessable Entity

features/v2/undo.json

@@ -10259,6 +10259,12 @@
       "type": "safe"
     }
   },
+  "CreateTimeseriesAnomalyInvestigation": {
+    "tag": "Timeseries Anomaly Investigations",
+    "undo": {
+      "type": "safe"
+    }
+  },
   "GetTraceByID": {
     "tag": "APM Trace",
     "undo": {

packages/datadog-api-client/README.md

@@ -498,6 +498,7 @@ apiInstance
 | Teams | @datadog/datadog-api-client-teams | [README.md](../../services/teams/README.md) |
 | Test Optimization | @datadog/datadog-api-client-test-optimization | [README.md](../../services/test-optimization/README.md) |
 | Threat Intelligence | @datadog/datadog-api-client-threat-intelligence | [README.md](../../services/threat-intelligence/README.md) |
+| Timeseries Anomaly Investigations | @datadog/datadog-api-client-timeseries-anomaly-investigations | [README.md](../../services/timeseries-anomaly-investigations/README.md) |
 | Twilio Integration Accounts | @datadog/datadog-api-client-twilio-integration-accounts | [README.md](../../services/twilio-integration-accounts/README.md) |
 | Usage Metering | @datadog/datadog-api-client-usage-metering | [README.md](../../services/usage-metering/README.md) |
 | User Authorized Clients | @datadog/datadog-api-client-user-authorized-clients | [README.md](../../services/user-authorized-clients/README.md) |

private/bdd_runner/src/support/scenarios_model_mapping.ts

@@ -18864,6 +18864,14 @@ export const ScenariosModelMappings: { [key: string]: OperationMapping } = {
     },
     operationResponseType: "UserTeamsResponse",
   },
+  "TimeseriesAnomalyInvestigationsApi.V2.CreateTimeseriesAnomalyInvestigation":
+    {
+      body: {
+        type: "TimeseriesAnomalyInvestigationRequest",
+        format: "",
+      },
+      operationResponseType: "TimeseriesAnomalyInvestigationResponse",
+    },
   "UserAuthorizedClientsApi.V2.ListUserAuthorizedClients": {
     pageSize: {
       type: "number",

services/timeseries_anomaly_investigations/.yarnrc.yml

@@ -0,0 +1 @@
+nodeLinker: node-modules

services/timeseries_anomaly_investigations/README.md

@@ -0,0 +1,44 @@
+# @datadog/datadog-api-client-timeseries-anomaly-investigations
+
+## Description
+
+Investigate metrics timeseries anomalies and return deterministic findings.
+
+## Navigation
+
+- [Installation](#installation)
+- [Getting Started](#getting-started)
+
+## Installation
+
+```sh
+# NPM
+npm install @datadog/datadog-api-client-timeseries-anomaly-investigations
+# Yarn
+yarn add @datadog/datadog-api-client-timeseries-anomaly-investigations
+```
+
+## Getting Started
+```ts
+import { createConfiguration } from "@datadog/datadog-api-client";
+import { TimeseriesAnomalyInvestigationsApiV2 } from "@datadog/datadog-api-client-timeseries-anomaly-investigations";
+import { v2 } from "@datadog/datadog-api-client-timeseries-anomaly-investigations";
+
+const configuration = createConfiguration();
+// Enable unstable operations
+const configurationOpts = {
+    unstableOperations: {
+        "TimeseriesAnomalyInvestigationsApi.v2.createTimeseriesAnomalyInvestigation": true
+    }
+}
+
+const configuration = createConfiguration(configurationOpts);
+const apiInstance = new TimeseriesAnomalyInvestigationsApiV2(configuration);
+const params = {/* parameters */};
+
+apiInstance.createTimeseriesAnomalyInvestigation(params).then((data) => {
+    console.log("API called successfully. Returned data: " + JSON.stringify(data));
+}).catch((error) => {
+    console.error("Error calling API: " + error);
+});
+```

services/timeseries_anomaly_investigations/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@datadog/datadog-api-client-timeseries-anomaly-investigations",
+  "description": "",
+  "author": "",
+  "keywords": [
+    "api",
+    "fetch",
+    "typescript"
+  ],
+  "license": "Apache-2.0",
+  "licenses": [
+    {
+      "type": "Apache-2.0",
+      "url": "http://www.apache.org/licenses/LICENSE-2.0"
+    }
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DataDog/datadog-api-client-typescript.git",
+    "directory": "services/timeseries-anomaly-investigations"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "main": "./dist/index.js",
+  "typings": "./dist/index.d.ts",
+  "scripts": {
+    "prepack": "yarn workspace @datadog/datadog-api-client build && yarn build",
+    "build": "yarn generate-version-files && tsc",
+    "generate-version-files": "node -p \"'export const version = ' + JSON.stringify(require('./package.json').version)\" > src/version.ts"
+  },
+  "dependencies": {
+    "@datadog/datadog-api-client": "^2.0.0-beta.2"
+  },
+  "devDependencies": {
+    "typescript": "5.8.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "version": "0.0.1",
+  "packageManager": "yarn@4.9.1"
+}

services/timeseries_anomaly_investigations/src/index.ts

@@ -0,0 +1,3 @@
+export * as v2 from "./v2";
+
+export { TimeseriesAnomalyInvestigationsApi as TimeseriesAnomalyInvestigationsApiV2 } from "./v2/TimeseriesAnomalyInvestigationsApi";