Skip to main content
Use logs when an agent’s task fails or produces an unexpected result. Start with the command’s exit status, stdout, and stderr, then find the sandbox’s log entries around the time of the operation. Logs are available until the sandbox is deleted.

​
Inspect sandbox logs

  1. In the Baseten dashboard, choose Sandboxes, then choose the sandbox.
  2. On the sandbox’s detail page, choose Logs.
  3. Select the time range that contains the operation, and use the log-level filters to narrow the entries.

​
Inspect image build logs

For a FAILED result when building or importing an image:
  1. In Sandboxes > Images, choose the image whose build failed.
  2. Choose Logs.
This view shows build output. The sandbox’s Logs tab covers the running sandbox’s execution. To read build logs with the API: Request the image’s logs with a sandbox access token:
The response covers the image’s latest build, newest entry first, from the last 24 hours by default. To page through more entries, add &offset=<N>. To compare errors with request traffic and resource usage, see sandbox metrics.