Skip to content

Commit 2c7b1a0

Browse files
api-clients-generation-pipeline[bot]ci.datadog-api-spec
api-clients-generation-pipeline[bot]
and
ci.datadog-api-spec
authored
Document LLM Observability span search and data deletion endpoints (#3865)
Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>
1 parent 4a8efe3 commit 2c7b1a0

36 files changed

Lines changed: 7461 additions & 3 deletions

‎.generator/schemas/v2/openapi.yaml‎

Lines changed: 844 additions & 1 deletion
Large diffs are not rendered by default.

‎examples/v2/llm-observability/DeleteLLMObsData.java‎

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
// Delete LLM Observability data returns "Accepted" response
2+
3+
import com.datadog.api.client.ApiClient;
4+
import com.datadog.api.client.ApiException;
5+
import com.datadog.api.client.v2.api.LlmObservabilityApi;
6+
import com.datadog.api.client.v2.model.LLMObsDataDeletionRequest;
7+
import com.datadog.api.client.v2.model.LLMObsDataDeletionRequestAttributes;
8+
import com.datadog.api.client.v2.model.LLMObsDataDeletionRequestData;
9+
import com.datadog.api.client.v2.model.LLMObsDataDeletionRequestType;
10+
import com.datadog.api.client.v2.model.LLMObsDataDeletionResponse;
11+
import java.util.Map;
12+
13+
public class Example {
14+
public static void main(String[] args) {
15+
ApiClient defaultClient = ApiClient.getDefaultApiClient();
16+
defaultClient.setUnstableOperationEnabled("v2.deleteLLMObsData", true);
17+
LlmObservabilityApi apiInstance = new LlmObservabilityApi(defaultClient);
18+
19+
LLMObsDataDeletionRequest body =
20+
new LLMObsDataDeletionRequest()
21+
.data(
22+
new LLMObsDataDeletionRequestData()
23+
.attributes(
24+
new LLMObsDataDeletionRequestAttributes()
25+
.delay(0L)
26+
.from(1705314600000L)
27+
.query(Map.ofEntries(Map.entry("query", "@trace_id:abc123def456")))
28+
.to(1705315200000L))
29+
.type(LLMObsDataDeletionRequestType.CREATE_DELETION_REQ));
30+
31+
try {
32+
LLMObsDataDeletionResponse result = apiInstance.deleteLLMObsData(body);
33+
System.out.println(result);
34+
} catch (ApiException e) {
35+
System.err.println("Exception when calling LlmObservabilityApi#deleteLLMObsData");
36+
System.err.println("Status code: " + e.getCode());
37+
System.err.println("Reason: " + e.getResponseBody());
38+
System.err.println("Response headers: " + e.getResponseHeaders());
39+
e.printStackTrace();
40+
}
41+
}
42+
}

‎examples/v2/llm-observability/ListLLMObsSpans.java‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
// List LLM Observability spans returns "OK" response
2+
3+
import com.datadog.api.client.ApiClient;
4+
import com.datadog.api.client.ApiException;
5+
import com.datadog.api.client.v2.api.LlmObservabilityApi;
6+
import com.datadog.api.client.v2.model.LLMObsSpansResponse;
7+
8+
public class Example {
9+
public static void main(String[] args) {
10+
ApiClient defaultClient = ApiClient.getDefaultApiClient();
11+
defaultClient.setUnstableOperationEnabled("v2.listLLMObsSpans", true);
12+
LlmObservabilityApi apiInstance = new LlmObservabilityApi(defaultClient);
13+
14+
try {
15+
LLMObsSpansResponse result = apiInstance.listLLMObsSpans();
16+
System.out.println(result);
17+
} catch (ApiException e) {
18+
System.err.println("Exception when calling LlmObservabilityApi#listLLMObsSpans");
19+
System.err.println("Status code: " + e.getCode());
20+
System.err.println("Reason: " + e.getResponseBody());
21+
System.err.println("Response headers: " + e.getResponseHeaders());
22+
e.printStackTrace();
23+
}
24+
}
25+
}

‎examples/v2/llm-observability/SearchLLMObsSpans.java‎

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
// Search LLM Observability spans returns "OK" response
2+
3+
import com.datadog.api.client.ApiClient;
4+
import com.datadog.api.client.ApiException;
5+
import com.datadog.api.client.v2.api.LlmObservabilityApi;
6+
import com.datadog.api.client.v2.model.LLMObsSearchSpansRequest;
7+
import com.datadog.api.client.v2.model.LLMObsSearchSpansRequestAttributes;
8+
import com.datadog.api.client.v2.model.LLMObsSearchSpansRequestData;
9+
import com.datadog.api.client.v2.model.LLMObsSearchSpansRequestType;
10+
import com.datadog.api.client.v2.model.LLMObsSpanFilter;
11+
import com.datadog.api.client.v2.model.LLMObsSpanPageQuery;
12+
import com.datadog.api.client.v2.model.LLMObsSpanSearchOptions;
13+
import com.datadog.api.client.v2.model.LLMObsSpansResponse;
14+
15+
public class Example {
16+
public static void main(String[] args) {
17+
ApiClient defaultClient = ApiClient.getDefaultApiClient();
18+
defaultClient.setUnstableOperationEnabled("v2.searchLLMObsSpans", true);
19+
LlmObservabilityApi apiInstance = new LlmObservabilityApi(defaultClient);
20+
21+
LLMObsSearchSpansRequest body =
22+
new LLMObsSearchSpansRequest()
23+
.data(
24+
new LLMObsSearchSpansRequestData()
25+
.attributes(
26+
new LLMObsSearchSpansRequestAttributes()
27+
.filter(
28+
new LLMObsSpanFilter()
29+
.from("now-900s")
30+
.mlApp("my-llm-app")
31+
.query("@session_id:abc123def456")
32+
.spanId("abc123def456")
33+
.spanKind("llm")
34+
.spanName("llm_call")
35+
.to("now")
36+
.traceId("trace-9a8b7c6d5e4f"))
37+
.options(
38+
new LLMObsSpanSearchOptions()
39+
.includeAttachments(true)
40+
.timeOffset(0L))
41+
.page(
42+
new LLMObsSpanPageQuery().cursor("eyJzdGFydCI6MTAwfQ==").limit(10L))
43+
.sort("-start_ns"))
44+
.type(LLMObsSearchSpansRequestType.SPANS));
45+
46+
try {
47+
LLMObsSpansResponse result = apiInstance.searchLLMObsSpans(body);
48+
System.out.println(result);
49+
} catch (ApiException e) {
50+
System.err.println("Exception when calling LlmObservabilityApi#searchLLMObsSpans");
51+
System.err.println("Status code: " + e.getCode());
52+
System.err.println("Reason: " + e.getResponseBody());
53+
System.err.println("Response headers: " + e.getResponseHeaders());
54+
e.printStackTrace();
55+
}
56+
}
57+
}

‎src/main/java/com/datadog/api/client/ApiClient.java‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -784,6 +784,7 @@ public class ApiClient {
784784
put("v2.deleteLLMObsAnnotationQueue", false);
785785
put("v2.deleteLLMObsAnnotationQueueInteractions", false);
786786
put("v2.deleteLLMObsCustomEvalConfig", false);
787+
put("v2.deleteLLMObsData", false);
787788
put("v2.deleteLLMObsDatasetRecords", false);
788789
put("v2.deleteLLMObsDatasets", false);
789790
put("v2.deleteLLMObsExperiments", false);
@@ -797,7 +798,9 @@ public class ApiClient {
797798
put("v2.listLLMObsExperimentEvents", false);
798799
put("v2.listLLMObsExperiments", false);
799800
put("v2.listLLMObsProjects", false);
801+
put("v2.listLLMObsSpans", false);
800802
put("v2.searchLLMObsExperimentation", false);
803+
put("v2.searchLLMObsSpans", false);
801804
put("v2.simpleSearchLLMObsExperimentation", false);
802805
put("v2.updateLLMObsAnnotationQueue", false);
803806
put("v2.updateLLMObsAnnotationQueueLabelSchema", false);

0 commit comments

Comments
 (0)