feat(llm-obs): API docs - Add timestamp to LLM Obs clustered point ref

.generator/schemas/v2/openapi.yaml

@@ -31063,9 +31063,17 @@ components:
           type: string
         values:
           description: |-
-            Column values in row order. The element type matches the column's `type`;
-            for example a `VARCHAR` column carries strings, a `TIMESTAMP` column carries
-            Unix-millisecond integers. `null` is allowed for missing values.
+            Column values in row order, one entry per result row. The element type
+            follows the column's `type`. The following serialization rules should be
+            taken into account:
+
+            - `BIGINT` values are encoded as JSON numbers in the signed 64-bit integer range.
+            - `DECIMAL` values are encoded as JSON numbers with 64-bit double precision.
+            - `TIMESTAMP` and `DATE` values are encoded as Unix-millisecond integers; a
+              `DATE` resolves to midnight UTC.
+            - `JSON` values are returned as a JSON-encoded string.
+
+            `null` is allowed for any column type where a value is missing.
           example:
             - web-store
             - checkout
@@ -55874,6 +55882,12 @@ components:
           description: Status of the source span. Included only when metrics are requested.
           example: ok
           type: string
+        timestamp:
+          description: >-
+            Unix timestamp of the source span in milliseconds. Included only when metrics are requested.
+          example: 1711000123456
+          format: int64
+          type: integer
         total_tokens:
           description: Total number of tokens of the source span. Included only when metrics are requested.
           example: 192
@@ -135602,9 +135616,6 @@ paths:
       summary: Execute a tabular DDSQL query
       tags:
         - DDSQL
-      x-unstable: |-
-        **Note**: This endpoint is in preview and is subject to change.
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
   /api/v2/ddsql/query/tabular/fetch:
     post:
       description: |-
@@ -135713,9 +135724,6 @@ paths:
       summary: Fetch the result of a DDSQL query
       tags:
         - DDSQL
-      x-unstable: |-
-        **Note**: This endpoint is in preview and is subject to change.
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
   /api/v2/deletion/data/{product}:
     post:
       description: Creates a data deletion request by providing a query and a timeframe targeting the proper data.
@@ -155150,6 +155158,7 @@ paths:
                                 output_tokens: 64
                                 span_id: "1234567890123456789"
                                 status: ok
+                                timestamp: 1711000123456
                                 total_tokens: 192
                             created_at: "2024-01-15T10:44:00Z"
                             description: "Questions about invoices, charges, and refunds."

services/ddsql/README.md

@@ -28,14 +28,6 @@ import { DDSQLApiV2 } from "@datadog/datadog-api-client-ddsql";
 import { v2 } from "@datadog/datadog-api-client-ddsql";
 
 const configuration = createConfiguration();
-// Enable unstable operations
-const configurationOpts = {
-    unstableOperations: {
-        "DDSQLApi.v2.executeDdsqlTabularQuery": true
-    }
-}
-
-const configuration = createConfiguration(configurationOpts);
 const apiInstance = new DDSQLApiV2(configuration);
 const params = {/* parameters */};
 

services/ddsql/src/v2/DDSQLApi.ts

@@ -44,12 +44,6 @@ export class DDSQLApiRequestFactory extends BaseAPIRequestFactory {
   ): Promise<RequestContext> {
     const _config = _options || this.configuration;
 
-    if (!_config.unstableOperations["DDSQLApi.v2.executeDdsqlTabularQuery"]) {
-      throw new Error(
-        "Unstable operation 'executeDdsqlTabularQuery' is disabled. Enable it by setting `configuration.unstableOperations['DDSQLApi.v2.executeDdsqlTabularQuery'] = true`",
-      );
-    }
-
     // verify required parameter 'body' is not null or undefined
     if (body === null || body === undefined) {
       throw new RequiredError("body", "executeDdsqlTabularQuery");
@@ -100,12 +94,6 @@ export class DDSQLApiRequestFactory extends BaseAPIRequestFactory {
   ): Promise<RequestContext> {
     const _config = _options || this.configuration;
 
-    if (!_config.unstableOperations["DDSQLApi.v2.fetchDdsqlTabularQuery"]) {
-      throw new Error(
-        "Unstable operation 'fetchDdsqlTabularQuery' is disabled. Enable it by setting `configuration.unstableOperations['DDSQLApi.v2.fetchDdsqlTabularQuery'] = true`",
-      );
-    }
-
     // verify required parameter 'body' is not null or undefined
     if (body === null || body === undefined) {
       throw new RequiredError("body", "fetchDdsqlTabularQuery");

services/ddsql/src/v2/models/DdsqlTabularQueryColumn.ts

@@ -17,9 +17,17 @@ export class DdsqlTabularQueryColumn {
    */
   "type": string;
   /**
-   * Column values in row order. The element type matches the column's `type`;
-   * for example a `VARCHAR` column carries strings, a `TIMESTAMP` column carries
-   * Unix-millisecond integers. `null` is allowed for missing values.
+   * Column values in row order, one entry per result row. The element type
+   * follows the column's `type`. The following serialization rules should be
+   * taken into account:
+   *
+   * - `BIGINT` values are encoded as JSON numbers in the signed 64-bit integer range.
+   * - `DECIMAL` values are encoded as JSON numbers with 64-bit double precision.
+   * - `TIMESTAMP` and `DATE` values are encoded as Unix-millisecond integers; a
+   *   `DATE` resolves to midnight UTC.
+   * - `JSON` values are returned as a JSON-encoded string.
+   *
+   * `null` is allowed for any column type where a value is missing.
    */
   "values": Array<any>;
   /**

services/llm_observability/src/v2/models/LLMObsPatternsClusteredPointRef.ts

@@ -34,6 +34,10 @@ export class LLMObsPatternsClusteredPointRef {
    * Status of the source span. Included only when metrics are requested.
    */
   "status"?: string;
+  /**
+   * Unix timestamp of the source span in milliseconds. Included only when metrics are requested.
+   */
+  "timestamp"?: number;
   /**
    * Total number of tokens of the source span. Included only when metrics are requested.
    */
@@ -86,6 +90,11 @@ export class LLMObsPatternsClusteredPointRef {
       baseName: "status",
       type: "string",
     },
+    timestamp: {
+      baseName: "timestamp",
+      type: "number",
+      format: "int64",
+    },
     totalTokens: {
       baseName: "total_tokens",
       type: "number",