에이전트 런타임 로그 가져오기

얻다 /api/v1/projects/{id}/agent-logs

베어러 인증

에이전트 런타임에서 작업 공간을 위해 S3에 기록된 gzip으로 압축된 JSONL 로그 배치를 조회합니다. 프로젝트 범위는 경로 ID 경로 매개 변수에 의해 전달되며 조직은 해당 프로젝트 에서 파생됩니다.

경로 매개변수

id 문자열 필수 사항

프로젝트 ID

쿼리 매개변수

Workspace_id 문자열 필수 사항

작업 공간 식별자
start_time 문자열

RFC3339 시작 시간(기본값: 1시간 전, 범위 6시간을 초과할 수 없음)
end_time 문자열

RFC3339 종료 시간(기본값: 지금, 범위 6시간을 초과할 수 없음)
limit integer

최대 항목(기본값 500, 최대 5000)
cursor 문자열

이전 응답의 불투명한 페이지 커서
레벨 문자열

수준을 쉼표 또는 공백으로 구분하여 정확히 일치하도록 로그 수준을 기록합니다(DEBUG, INFO, WARNING, ERROR. 경고/오류 별칭도 허용). 이전 최소 심각도 필터하다 의 단절적 변경: 이제 level=INFO는 INFO+WARNING+ERROR가 아닌 INFO만 반환합니다.
execution_id 문자열

실행 ID 로 필터링(정확히 일치)
session_id 문자열

세션 ID 로 필터링(정확히 일치)
source 문자열

정확히 일치하는 소스(쉼표 또는 공백으로 구분)(stdout, stderr, python-logging, node-logging)
서비스 문자열

쉼표 또는 공백으로 구분하여 정확히 일치하는 서비스(에이전트-실행-런타임, 도구-실행기, 에이전트/tool 별칭도 허용됨)
검색 문자열

메시지 또는 부팅 ID 에서 대소문자를 구분하지 않는 하위 문자열 일치
주문 문자열

정렬 순서: asc (기본값, 오래된 것 먼저) 또는 desc (최신 것 먼저)
tail 부울

최신 항목만 단일 페이지로 반환( 커서 와 상호 배타적)

응답

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

확인
응답 속성 숨기기 응답 속성 표시 객체
- hasMore 부울
- 로그 배열[객체]
  
  로그 속성 숨기기 로그 속성 표시 객체
  
  BootId 문자열
  
  executionId 문자열
  
  필드 객체
  
  추가 속성이 허용됩니다.
  
  레벨 문자열
  
  로거 문자열
  
  메시지 문자열
  
  podName 문자열
  
  서비스 문자열
  
  sessionId 문자열
  
  source 문자열
  
  테넌트 ID 문자열
  
  timestamp 문자열
  
  traceId 문자열
  
  WorkspaceId 문자열
- NextCursor 문자열
응답 속성 숨기기 응답 속성 표시 객체
- hasMore 부울
- 로그 배열[객체]
  
  로그 속성 숨기기 로그 속성 표시 객체
  
  BootId 문자열
  
  executionId 문자열
  
  필드 객체
  
  추가 속성이 허용됩니다.
  
  레벨 문자열
  
  로거 문자열
  
  메시지 문자열
  
  podName 문자열
  
  서비스 문자열
  
  sessionId 문자열
  
  source 문자열
  
  테넌트 ID 문자열
  
  timestamp 문자열
  
  traceId 문자열
  
  WorkspaceId 문자열
- NextCursor 문자열
400

application/json

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

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

application/json

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

Forbidden
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
404

application/json

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

찾을 수 없습니다.
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
429

애플리케이션/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 부울
503

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

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

서비스를 사용할 수 없음
헤더 속성 숨기기 헤더 속성 표시
- 재시도 후 문자열
  
  재시도 전 시간(초)
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울

GET /api/v1/projects/{id}/agent-logs

curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/agent-logs?workspace_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)

{
  "hasMore": true,
  "logs": [
    {
      "bootId": "string",
      "executionId": "string",
      "fields": {},
      "level": "string",
      "logger": "string",
      "message": "string",
      "podName": "string",
      "service": "string",
      "sessionId": "string",
      "source": "string",
      "tenantId": "string",
      "timestamp": "string",
      "traceId": "string",
      "workspaceId": "string"
    }
  ],
  "nextCursor": "string"
}

응답 예시(200)

{
  "hasMore": true,
  "logs": [
    {
      "bootId": "string",
      "executionId": "string",
      "fields": {},
      "level": "string",
      "logger": "string",
      "message": "string",
      "podName": "string",
      "service": "string",
      "sessionId": "string",
      "source": "string",
      "tenantId": "string",
      "timestamp": "string",
      "traceId": "string",
      "workspaceId": "string"
    }
  ],
  "nextCursor": "string"
}

응답 예시(400)

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

응답 예시(400)

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

응답 예시(403)

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

응답 예시(403)

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

응답 예시(404)

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

응답 예시(404)

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

응답 예시(429)

# Headers
Retry-After: string

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

응답 예시(429)

# Headers
Retry-After: string

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

응답 예시(500)

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

응답 예시(500)

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

응답 예시(503)

# Headers
Retry-After: string

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

응답 예시(503)

# Headers
Retry-After: string

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