Get traces by project_name or project_id

GET

/v1/private/traces

GET

/api/v1/private/traces

$ curl http://localhost:5173/api/v1/private/traces \
>      -H "Content-Type: application/json"

200Retrieved

1 {
2   "page": 1,
3   "size": 1,
4   "total": 1,
5   "content": [
6     {
7       "start_time": "2024-01-15T09:30:00Z",
8       "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
9       "project_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
10       "name": "Model Training Run 2024-01-15",
11       "end_time": "2024-01-15T09:45:00Z",
12       "input": [
13         "input text example",
14         {
15           "param1": "value1"
16         }
17       ],
18       "output": [
19         "output text example",
20         {
21           "result": "success"
22         }
23       ],
24       "metadata": {
25         "framework": "TensorFlow",
26         "version": "2.10"
27       },
28       "tags": [
29         "training",
30         "tensorflow",
31         "experiment-42"
32       ],
33       "error_info": {
34         "exception_type": "ValueError",
35         "traceback": "Traceback (most recent call last):\n  File \"train.py\", line 42, in <module>\n    train_model()\nValueError: Invalid input shape",
36         "message": "Invalid input shape"
37       },
38       "usage": {
39         "cpu_seconds": 3600,
40         "gpu_seconds": 1800,
41         "memory_mb": 2048
42       },
43       "created_at": "2024-01-15T09:30:00Z",
44       "last_updated_at": "2024-01-15T09:50:00Z",
45       "created_by": "alice@example.com",
46       "last_updated_by": "bob@example.com",
47       "feedback_scores": [
48         {
49           "name": "accuracy",
50           "value": 0.92,
51           "source": "ui",
52           "category_name": "performance",
53           "reason": "Validated on test set",
54           "source_queue_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
55           "created_at": "2024-01-15T10:00:00Z",
56           "last_updated_at": "2024-01-15T10:05:00Z",
57           "created_by": "reviewer@example.com",
58           "last_updated_by": "reviewer@example.com",
59           "value_by_author": {
60             "alice@example.com": {
61               "value": 0.91,
62               "reason": "Initial evaluation",
63               "category_name": "performance",
64               "source": "sdk",
65               "last_updated_at": "2024-01-15T09:55:00Z",
66               "span_type": "evaluation",
67               "span_id": "span-1234",
68               "source_queue_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
69               "author": "alice@example.com"
70             }
71           }
72         }
73       ],
74       "span_feedback_scores": [
75         {
76           "name": "latency",
77           "value": 150.5,
78           "source": "sdk",
79           "category_name": "performance",
80           "reason": "Measured during inference",
81           "source_queue_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
82           "created_at": "2024-01-15T10:10:00Z",
83           "last_updated_at": "2024-01-15T10:15:00Z",
84           "created_by": "alice@example.com",
85           "last_updated_by": "alice@example.com",
86           "value_by_author": {}
87         }
88       ],
89       "comments": [
90         {
91           "text": "Model performed well on the validation set.",
92           "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
93           "source_queue_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
94           "created_at": "2024-01-15T10:20:00Z",
95           "last_updated_at": "2024-01-15T10:25:00Z",
96           "created_by": "bob@example.com",
97           "last_updated_by": "bob@example.com"
98         }
99       ],
100       "guardrails_validations": [
101         {
102           "span_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
103           "checks": [
104             {
105               "name": "TOPIC",
106               "result": "passed"
107             },
108             {
109               "name": "PII",
110               "result": "passed"
111             }
112           ]
113         }
114       ],
115       "total_estimated_cost": 12.75,
116       "span_count": 5,
117       "duration": 900000.123,
118       "ttft": 120.5,
119       "thread_id": "thread-7890",
120       "visibility_mode": "default",
121       "llm_span_count": 3,
122       "has_tool_spans": false,
123       "providers": [
124         "OpenAI",
125         "HuggingFace"
126       ],
127       "experiment": {
128         "id": "9b2d6f4e-3c1a-4f2a-8f3b-1a2b3c4d5e6f",
129         "name": "Image Classification Experiment",
130         "dataset_id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
131         "dataset_item_id": "7f8e9d0c-1b2a-3c4d-5e6f-7a8b9c0d1e2f"
132       },
133       "source": "sdk",
134       "environment": "production"
135     }
136   ],
137   "sortableBy": [
138     "start_time",
139     "duration",
140     "total_estimated_cost"
141   ]
142 }

Get traces by project_name or project_id

Query parameters

pageintegerOptional>=1Defaults to 1

sizeintegerOptional>=1Defaults to 10

project_namestringOptional

project_idstringOptionalformat: "uuid"

filtersstringOptional

truncatebooleanOptionalDefaults to false

strip_attachmentsbooleanOptionalDefaults to false

sortingstringOptional

excludestringOptional

searchstringOptional

from_timedatetimeOptional

to_timedatetimeOptional

annotation_queue_idstringOptionalformat: "uuid"

Response

Trace resource

pageintegerOptional

sizeintegerOptional

totallongOptional

contentlist of objectsOptional

sortableBylist of stringsOptional