Obtener registros de ejecución del agente

OBTENER /api/v1/projects/{id}/agent-logs
Autorización del portador

Recupera los lotes de registros JSONL comprimidos con gzip que el entorno de ejecución del agente escribió en S3 para un espacio de trabajo. El ámbito del proyecto viene dado por el parámetro de ruta del ID de ruta y la organización se deriva de ese proyecto.

Parámetros de path

  • ID string Requerido

    ID del proyecto

Parámetros de query

  • ID del espacio de trabajo string Requerido

    Identificador del espacio de trabajo

  • start_time string

    Hora de inicio de RFC3339 (predeterminado: 1 horas atrás; el rango no debe exceder las 6 horas)

  • hora_final string

    Hora de finalización de RFC3339 (predeterminado: ahora; el rango no debe exceder las 6 horas)

  • limit entero

    Número máximo de entradas (predeterminado 500, máximo 5000)

  • cursor string

    Cursor de paginación opaco de una respuesta anterior

  • Nivel string

    Los niveles de registro deben coincidir exactamente, separados por comas o espacios (DEBUG, INFO, WARNING, ERROR; también se aceptan alias warn/err). Cambio importante respecto al filtro de gravedad mínima anterior: level=INFO ahora devuelve solo INFO, no INFO+WARNING+ERROR.

  • id_de_ejecución string

    Filtrar por ID de ejecución (coincidencia exacta)

  • session_id string

    Filtrar por ID de sesión (coincidencia exacta)

  • Origen string

    Fuente(s) que deben coincidir exactamente, separadas por comas o espacios (stdout, stderr, python-logging, node-logging)

  • service string

    Servicio(s) que deben coincidir exactamente, separados por comas o espacios (agente-ejecución-tiempo de ejecución, herramienta-ejecutor; también se aceptan alias de agente/herramienta).

  • orden string

    Orden de clasificación: asc (predeterminado, del más antiguo al más reciente) o desc (del más reciente al más reciente)

  • cola booleano

    Devuelve solo las entradas más recientes en una sola página (mutuamente excluyentes con el cursor).

Respuestas

  • 406

    Versión de API no compatible o con formato incorrecto, operación no disponible en el contrato publicado seleccionado o representación inaceptable (incluidos parámetros de tipo de medio no compatibles o SSE excluidos). Los fallos de autenticación, autorización y límite de velocidad existentes tienen prioridad.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalles de validación opcionales definidos por el esquema de error estándar; los errores de negociación de la API no emiten este campo.

      Ocultad el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • Campos arreglo[objeto]

        Campos con errores de validación.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto

        Un campo y su fallo de validación.

        • Descripción string Requerido

          Fallo en la validación legible para humanos.

        • Campo string Requerido

          Nombre o ruta del campo de solicitud no válido.

    • detalle string Requerido

      Detalles de errores legibles para humanos.

    • Error entero Requerido

      HTTP status code.

    • errorCode string Requerido

      Código de error legible por máquina.

    • Parámetros array[string]

      Nombres de los parámetros de la solicitud asociados con el error; se omiten cuando no corresponde ninguno.

    • motivo string Requerido

      Frase que indica el motivo del estado HTTP.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalles de validación opcionales definidos por el esquema de error estándar; los errores de negociación de la API no emiten este campo.

      Ocultad el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • Campos arreglo[objeto]

        Campos con errores de validación.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto

        Un campo y su fallo de validación.

        • Descripción string Requerido

          Fallo en la validación legible para humanos.

        • Campo string Requerido

          Nombre o ruta del campo de solicitud no válido.

    • detalle string Requerido

      Detalles de errores legibles para humanos.

    • Error entero Requerido

      HTTP status code.

    • errorCode string Requerido

      Código de error legible por máquina.

    • Parámetros array[string]

      Nombres de los parámetros de la solicitud asociados con el error; se omiten cuando no corresponde ninguno.

    • motivo string Requerido

      Frase que indica el motivo del estado HTTP.
  • 200

    OK

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • hasMore booleano
    • Registros arreglo[objeto]
      Ocultar atributos de registro Mostrar atributos de registro Objeto
      • ID de arranque string
      • ID de ejecución string
      • Campos Objeto

        Se permiten propiedades adicionales.

      • Nivel string
      • logger string
      • mensaje string
      • podName string
      • service string
      • sessionId string
      • Origen string
      • tenantId string
      • Marca de tiempo string
      • ID de rastreo string
      • ID del espacio de trabajo string
    • siguiente cursor string
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • hasMore booleano
    • Registros arreglo[objeto]
      Ocultar atributos de registro Mostrar atributos de registro Objeto
      • ID de arranque string
      • ID de ejecución string
      • Campos Objeto

        Se permiten propiedades adicionales.

      • Nivel string
      • logger string
      • mensaje string
      • podName string
      • service string
      • sessionId string
      • Origen string
      • tenantId string
      • Marca de tiempo string
      • ID de rastreo string
      • ID del espacio de trabajo string
    • siguiente cursor string
  • 400

    Solicitud incorrecta

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 403

    Forbidden

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 404

    No encontrado

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 429

    Demasiadas peticiones

    Atributo de ocultar encabezados Mostrar atributo de encabezados
    • Después de reintento string

      Segundos antes de volver a intentarlo

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 500

    Error interno del servidor

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 503

    Servicio no disponible

    Atributo de ocultar encabezados Mostrar atributo de encabezados
    • Después de reintento string

      Segundos antes de volver a intentarlo

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
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"
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (404) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (404) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (429) 
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (429) 
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (503) 
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (503) 
# Headers
Retry-After: string

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