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."

src/datadog_api_client/configuration.py

@@ -490,8 +490,6 @@ def __init__(
                 "v2.get_all_datasets": False,
                 "v2.get_dataset": False,
                 "v2.update_dataset": False,
-                "v2.execute_ddsql_tabular_query": False,
-                "v2.fetch_ddsql_tabular_query": False,
                 "v2.cancel_data_deletion_request": False,
                 "v2.create_data_deletion_request": False,
                 "v2.get_data_deletion_requests": False,

src/datadog_api_client/v2/model/ddsql_tabular_query_column.py

@@ -44,9 +44,17 @@ def __init__(self_, name: str, type: str, values: List[Any], **kwargs):
             for the full, up-to-date list.
         :type type: str
 
-        :param values: 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.
+        :param 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.
         :type values: [bool, date, datetime, dict, float, int, list, str, UUID, none_type]
         """
         super().__init__(kwargs)

src/datadog_api_client/v2/model/llm_obs_patterns_clustered_point_ref.py

@@ -43,6 +43,7 @@ def openapi_types(_):
             "output_tokens": (float,),
             "span_id": (str,),
             "status": (str,),
+            "timestamp": (int,),
             "total_tokens": (float,),
         }
 
@@ -54,6 +55,7 @@ def openapi_types(_):
         "output_tokens": "output_tokens",
         "span_id": "span_id",
         "status": "status",
+        "timestamp": "timestamp",
         "total_tokens": "total_tokens",
     }
 
@@ -66,6 +68,7 @@ def __init__(
         input_tokens: Union[float, UnsetType] = unset,
         output_tokens: Union[float, UnsetType] = unset,
         status: Union[str, UnsetType] = unset,
+        timestamp: Union[int, UnsetType] = unset,
         total_tokens: Union[float, UnsetType] = unset,
         **kwargs,
     ):
@@ -95,6 +98,9 @@ def __init__(
         :param status: Status of the source span. Included only when metrics are requested.
         :type status: str, optional
 
+        :param timestamp: Unix timestamp of the source span in milliseconds. Included only when metrics are requested.
+        :type timestamp: int, optional
+
         :param total_tokens: Total number of tokens of the source span. Included only when metrics are requested.
         :type total_tokens: float, optional
         """
@@ -110,6 +116,8 @@ def __init__(
             kwargs["output_tokens"] = output_tokens
         if status is not unset:
             kwargs["status"] = status
+        if timestamp is not unset:
+            kwargs["timestamp"] = timestamp
         if total_tokens is not unset:
             kwargs["total_tokens"] = total_tokens
         super().__init__(kwargs)