Document LLM Observability span search and data deletion endpoints

docs/datadog_api_client.v2.model.rst

@@ -18561,6 +18561,62 @@ datadog\_api\_client.v2.model.llm\_obs\_custom\_eval\_config\_vertex\_ai\_option
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.llm\_obs\_data\_deletion\_request module
+----------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_data_deletion_request
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_data\_deletion\_request\_attributes module
+----------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_data_deletion_request_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_data\_deletion\_request\_data module
+----------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_data_deletion_request_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_data\_deletion\_request\_type module
+----------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_data_deletion_request_type
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_data\_deletion\_response module
+-----------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_data_deletion_response
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_data\_deletion\_response\_attributes module
+-----------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_data_deletion_response_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_data\_deletion\_response\_data module
+-----------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_data_deletion_response_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_data\_deletion\_response\_type module
+-----------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_data_deletion_response_type
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.llm\_obs\_dataset\_data\_attributes\_request module
 ---------------------------------------------------------------------------------
 
@@ -19401,6 +19457,146 @@ datadog\_api\_client.v2.model.llm\_obs\_record\_type module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.llm\_obs\_search\_spans\_request module
+---------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_search_spans_request
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_search\_spans\_request\_attributes module
+---------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_search_spans_request_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_search\_spans\_request\_data module
+---------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_search_spans_request_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_search\_spans\_request\_type module
+---------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_search_spans_request_type
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_span\_attributes module
+---------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_span_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_span\_data module
+---------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_span_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_span\_evaluation\_metric module
+-----------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_span_evaluation_metric
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_span\_filter module
+-----------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_span_filter
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_span\_io module
+-------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_span_io
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_span\_message module
+------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_span_message
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_span\_page\_query module
+----------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_span_page_query
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_span\_search\_options module
+--------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_span_search_options
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_span\_tool\_call module
+---------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_span_tool_call
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_span\_tool\_definition module
+---------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_span_tool_definition
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_span\_tool\_result module
+-----------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_span_tool_result
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_span\_type module
+---------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_span_type
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_spans\_response module
+--------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_spans_response
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_spans\_response\_links module
+---------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_spans_response_links
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_spans\_response\_meta module
+--------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_spans_response_meta
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.llm\_obs\_spans\_response\_page module
+--------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.llm_obs_spans_response_page
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.llm\_obs\_trace\_annotated\_interaction\_item module
 ----------------------------------------------------------------------------------
 

examples/v2/llm-observability/DeleteLLMObsData.py

@@ -0,0 +1,32 @@
+"""
+Delete LLM Observability data returns "Accepted" response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.llm_observability_api import LLMObservabilityApi
+from datadog_api_client.v2.model.llm_obs_data_deletion_request import LLMObsDataDeletionRequest
+from datadog_api_client.v2.model.llm_obs_data_deletion_request_attributes import LLMObsDataDeletionRequestAttributes
+from datadog_api_client.v2.model.llm_obs_data_deletion_request_data import LLMObsDataDeletionRequestData
+from datadog_api_client.v2.model.llm_obs_data_deletion_request_type import LLMObsDataDeletionRequestType
+
+body = LLMObsDataDeletionRequest(
+    data=LLMObsDataDeletionRequestData(
+        attributes=LLMObsDataDeletionRequestAttributes(
+            delay=0,
+            _from=1705314600000,
+            query=dict(
+                query="@trace_id:abc123def456",
+            ),
+            to=1705315200000,
+        ),
+        type=LLMObsDataDeletionRequestType.CREATE_DELETION_REQ,
+    ),
+)
+
+configuration = Configuration()
+configuration.unstable_operations["delete_llm_obs_data"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = LLMObservabilityApi(api_client)
+    response = api_instance.delete_llm_obs_data(body=body)
+
+    print(response)

examples/v2/llm-observability/ListLLMObsSpans.py

@@ -0,0 +1,14 @@
+"""
+List LLM Observability spans returns "OK" response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.llm_observability_api import LLMObservabilityApi
+
+configuration = Configuration()
+configuration.unstable_operations["list_llm_obs_spans"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = LLMObservabilityApi(api_client)
+    response = api_instance.list_llm_obs_spans()
+
+    print(response)

examples/v2/llm-observability/SearchLLMObsSpans.py

@@ -0,0 +1,48 @@
+"""
+Search LLM Observability spans returns "OK" response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.llm_observability_api import LLMObservabilityApi
+from datadog_api_client.v2.model.llm_obs_search_spans_request import LLMObsSearchSpansRequest
+from datadog_api_client.v2.model.llm_obs_search_spans_request_attributes import LLMObsSearchSpansRequestAttributes
+from datadog_api_client.v2.model.llm_obs_search_spans_request_data import LLMObsSearchSpansRequestData
+from datadog_api_client.v2.model.llm_obs_search_spans_request_type import LLMObsSearchSpansRequestType
+from datadog_api_client.v2.model.llm_obs_span_filter import LLMObsSpanFilter
+from datadog_api_client.v2.model.llm_obs_span_page_query import LLMObsSpanPageQuery
+from datadog_api_client.v2.model.llm_obs_span_search_options import LLMObsSpanSearchOptions
+
+body = LLMObsSearchSpansRequest(
+    data=LLMObsSearchSpansRequestData(
+        attributes=LLMObsSearchSpansRequestAttributes(
+            filter=LLMObsSpanFilter(
+                _from="now-900s",
+                ml_app="my-llm-app",
+                query="@session_id:abc123def456",
+                span_id="abc123def456",
+                span_kind="llm",
+                span_name="llm_call",
+                to="now",
+                trace_id="trace-9a8b7c6d5e4f",
+            ),
+            options=LLMObsSpanSearchOptions(
+                include_attachments=True,
+                time_offset=0,
+            ),
+            page=LLMObsSpanPageQuery(
+                cursor="eyJzdGFydCI6MTAwfQ==",
+                limit=10,
+            ),
+            sort="-start_ns",
+        ),
+        type=LLMObsSearchSpansRequestType.SPANS,
+    ),
+)
+
+configuration = Configuration()
+configuration.unstable_operations["search_llm_obs_spans"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = LLMObservabilityApi(api_client)
+    response = api_instance.search_llm_obs_spans(body=body)
+
+    print(response)

src/datadog_api_client/configuration.py

@@ -276,6 +276,7 @@ def __init__(
                 "v2.delete_llm_obs_annotation_queue": False,
                 "v2.delete_llm_obs_annotation_queue_interactions": False,
                 "v2.delete_llm_obs_custom_eval_config": False,
+                "v2.delete_llm_obs_data": False,
                 "v2.delete_llm_obs_dataset_records": False,
                 "v2.delete_llm_obs_datasets": False,
                 "v2.delete_llm_obs_experiments": False,
@@ -289,7 +290,9 @@ def __init__(
                 "v2.list_llm_obs_experiment_events": False,
                 "v2.list_llm_obs_experiments": False,
                 "v2.list_llm_obs_projects": False,
+                "v2.list_llm_obs_spans": False,
                 "v2.search_llm_obs_experimentation": False,
+                "v2.search_llm_obs_spans": False,
                 "v2.simple_search_llm_obs_experimentation": False,
                 "v2.update_llm_obs_annotation_queue": False,
                 "v2.update_llm_obs_annotation_queue_label_schema": False,