show logs

Request logs from a specific instance. The logs will be uploaded to S3 and can be retrieved from a generated URL. Supports both container logs and daemon system logs.

CLI Usage: vastai show logs <instance_id> [--tail <lines>] [--filter <grep>] [--daemon-logs]

PUT /api/v0/instances/request_logs/{id}

show logs

cURL

curl --request PUT \
  --url https://console.vast.ai/api/v0/instances/request_logs/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tail": "1000",
  "filter": "<string>"
}
'

200

{
  "success": true,
  "result_url": "https://s3.amazonaws.com/vast.ai/instance_logs/{hash}.log",
  "msg": "<string>"
}

Authorizations

Authorization · string · header · required

API key must be provided in the Authorization header

Path Parameters

id · integer · required

ID of the instance to get logs from

Body

application/json

tail · string

Number of lines to show from end of logs

Example:

"1000"

filter · string

Grep filter to apply to log entries

daemon_logs · enum<string>

If "true", fetch daemon system logs instead of container logs

Available options: true

Response

200

application/json

Success response with S3 URL for log retrieval

success · boolean

Example:

true

result_url · string

S3 URL where logs can be downloaded

Example:

"https://s3.amazonaws.com/vast.ai/instance_logs/{hash}.log"

msg · string

Status message