추적 가져오기

얻다 /api/v1/projects/{id}/traces

베어러 인증

작업 공간 오케스트레이션 엔진을 통해 세션에 대한 분산된 추적을 가져옵니다. 프로젝트 범위는 경로 ID 경로 매개 변수에 의해 전달되며 조직은 해당 프로젝트 에서 파생됩니다.

경로 매개변수

id 문자열 필수 사항

프로젝트 ID

쿼리 매개변수

session_id 문자열 필수 사항

세션 ID
Workspace_id 문자열

작업 공간 확인을 위한 작업 공간 ID

응답

406

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

지원되지 않거나 잘못된 API 버전, 선택한 게시된 계약에서 사용할 수 없는 작업 또는 허용되지 않는 표현(지원되지 않는 미디어 유형 매개변수 또는 제외된 SSE 포함). 기존 인증, 권한 부여 및 속도 제한 실패가 우선적으로 적용됩니다.
응답 속성 숨기기 응답 속성 표시 객체
- badRequestDetail 객체
  
  표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.
  
  badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
  
  필드 배열[객체]
  
  유효성 검사 에 실패한 필드입니다.
  
  필드 속성 숨기기 필드 속성 표시 객체
  
  필드 및 해당 유효성 검사 실패.
  
  description 문자열 필수 사항
  
  사람이 읽을 수 있는 유효성 검사 실패.
  
  필드 문자열 필수 사항
  
  잘못된 요청 필드 의 이름 또는 경로입니다.
- 세부 정보 문자열 필수 사항
  
  사람이 읽을 수 있는 오류 세부 정보.
- 오류 integer 필수 사항
  
  HTTP status code.
- 오류 코드 문자열 필수 사항
  
  기계가 읽을 수 있는 오류 코드입니다.
- 매개변수 array[string]
  
  오류와 관련된 요청 매개변수 이름입니다. 적용 않는 경우 생략됩니다.
- 이유 문자열 필수 사항
  
  HTTP 상태 이유 구문입니다.
응답 속성 숨기기 응답 속성 표시 객체
- badRequestDetail 객체
  
  표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.
  
  badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
  
  필드 배열[객체]
  
  유효성 검사 에 실패한 필드입니다.
  
  필드 속성 숨기기 필드 속성 표시 객체
  
  필드 및 해당 유효성 검사 실패.
  
  description 문자열 필수 사항
  
  사람이 읽을 수 있는 유효성 검사 실패.
  
  필드 문자열 필수 사항
  
  잘못된 요청 필드 의 이름 또는 경로입니다.
- 세부 정보 문자열 필수 사항
  
  사람이 읽을 수 있는 오류 세부 정보.
- 오류 integer 필수 사항
  
  HTTP status code.
- 오류 코드 문자열 필수 사항
  
  기계가 읽을 수 있는 오류 코드입니다.
- 매개변수 array[string]
  
  오류와 관련된 요청 매개변수 이름입니다. 적용 않는 경우 생략됩니다.
- 이유 문자열 필수 사항
  
  HTTP 상태 이유 구문입니다.
200

애플리케이션/vnd.agent-engine-2026-09-20-preview+json

애플리케이션/vnd.agent-engine-2026-09-20-preview+json application/json

확인
응답 속성 숨기기 응답 속성 표시 객체
- 카운트 integer
- Success 부울
- 흔적 배열[객체]
  
  트레이스 속성 숨기기 트레이스 속성 표시 객체
  
  속성 객체
  
  추가 속성이 허용됩니다.
  
  duration_ns integer
  
  end_time_ns integer
  
  이벤트 배열
  
  kind 문자열
  
  이름 문자열
  
  parent_span_id 문자열
  
  resource 객체
  
  추가 속성이 허용됩니다.
  
  root_execution_id 문자열
  
  root_session_id 문자열
  
  session_id 문자열
  
  span_id 문자열
  
  start_time_ns integer
  
  상태 객체
  
  추가 속성이 허용됩니다.
  
  trace_id 문자열
응답 속성 숨기기 응답 속성 표시 객체
- 카운트 integer
- Success 부울
- 흔적 배열[객체]
  
  트레이스 속성 숨기기 트레이스 속성 표시 객체
  
  속성 객체
  
  추가 속성이 허용됩니다.
  
  duration_ns integer
  
  end_time_ns integer
  
  이벤트 배열
  
  kind 문자열
  
  이름 문자열
  
  parent_span_id 문자열
  
  resource 객체
  
  추가 속성이 허용됩니다.
  
  root_execution_id 문자열
  
  root_session_id 문자열
  
  session_id 문자열
  
  span_id 문자열
  
  start_time_ns integer
  
  상태 객체
  
  추가 속성이 허용됩니다.
  
  trace_id 문자열
400

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

잘못된 요청
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
401

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

승인되지 않음
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
425

애플리케이션/vnd.agent-engine-2026-09-20-preview+json

애플리케이션/vnd.agent-engine-2026-09-20-preview+json application/json

작업 공간 오케스트레이션 엔진 준비되지 않았습니다.
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
500

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

내부 서버 오류
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
502

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

잘못된 게이트웨이
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울

GET /api/v1/projects/{id}/traces

curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/traces?session_id=string' \
 --header "Authorization: $API_KEY"

응답 예시(406)

{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

{
  "detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
  "error": 406,
  "errorCode": "UNACCEPTABLE_MEDIA_TYPE",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

{
  "detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
  "error": 406,
  "errorCode": "UNSUPPORTED_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

응답 예시(406)

{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

응답 예시(200)

{
  "count": 42,
  "success": true,
  "traces": [
    {
      "attributes": {},
      "duration_ns": 42,
      "end_time_ns": 42,
      "events": [],
      "kind": "string",
      "name": "string",
      "parent_span_id": "string",
      "resource": {},
      "root_execution_id": "string",
      "root_session_id": "string",
      "session_id": "string",
      "span_id": "string",
      "start_time_ns": 42,
      "status": {},
      "trace_id": "string"
    }
  ]
}

응답 예시(200)

{
  "count": 42,
  "success": true,
  "traces": [
    {
      "attributes": {},
      "duration_ns": 42,
      "end_time_ns": 42,
      "events": [],
      "kind": "string",
      "name": "string",
      "parent_span_id": "string",
      "resource": {},
      "root_execution_id": "string",
      "root_session_id": "string",
      "session_id": "string",
      "span_id": "string",
      "start_time_ns": 42,
      "status": {},
      "trace_id": "string"
    }
  ]
}

응답 예시(400)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(400)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(401)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(401)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(425)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(425)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(500)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(500)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(502)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(502)

{
  "code": "string",
  "error": "string",
  "success": true
}