bl logs
View logs for a resource
Synopsis
View logs for Blaxel resources.
The logs command displays logs for agents, jobs, sandboxes, and functions.
You must specify both the resource type and resource name.
Resource Types (with aliases):
- sandboxes (sandbox, sbx)
- jobs (job, j, jb)
- agents (agent, ag)
- functions (function, fn, mcp, mcps)
Sandbox Process Logs:
For sandboxes, you can view logs for a specific process by adding the process name:
bl logs sandbox my-sandbox my-process
Job Execution Logs:
For jobs, you can filter logs by execution ID and task ID:
bl logs job my-job my-execution-id
bl logs job my-job my-execution-id my-task-id
Time Filtering:
By default, logs from the last 1 hour are displayed.
In follow mode (—follow), the last 15 minutes are shown as context, then new logs
are continuously streamed in real-time.
You can customize this by:
- Using duration format (e.g., 3d, 1h, 10m, 24h) with —period flag
- Using explicit start/end times with —start and —end flags
- Maximum time range is 3 days
Duration units:
- d: days
- h: hours
- m: minutes
- s: seconds
Timestamps:
By default, logs are prefixed with their timestamp in local timezone.
Use —no-timestamps to hide them, or —utc to display timestamps in UTC.
Severity Filtering:
By default, all severity levels are shown. Use —severity to filter by specific levels.
Available severities: FATAL, ERROR, WARNING, INFO, DEBUG, TRACE, UNKNOWN
Use comma-separated values: —severity ERROR,FATAL
Search:
Use —search to filter logs by text content. Only logs containing the search term will be displayed.
Examples:
View logs for a specific sandbox (last 1 hour - default)
bl logs sandbox my-sandbox
View logs for a specific process in a sandbox
bl logs sandbox my-sandbox my-process
Stream process logs in real-time
bl logs sandbox my-sandbox my-process —follow
View all logs for a job
bl logs job my-job
View logs for a specific job execution
bl logs job my-job exec-abc123
View logs for a specific task within an execution
bl logs job my-job exec-abc123 task-456
Follow job execution logs in real-time
bl logs job my-job exec-abc123 —follow
Follow logs in real-time (shows last 15 minutes, then streams new logs)
bl logs sandbox my-sandbox —follow
Follow logs with more historical context
bl logs sandbox my-sandbox —follow —period 1h
View logs from last 3 days
bl logs job my-job —period 3d
View logs for a specific time range
bl logs agent my-agent —start 2024-01-01T00:00:00Z —end 2024-01-01T23:59:59Z
Hide timestamps in output
bl logs agent my-agent —no-timestamps
Show timestamps in UTC
bl logs agent my-agent —utc
Filter by severity
bl logs agent my-agent —severity ERROR,FATAL
Search for specific text in logs
bl logs agent my-agent —search “error”
Using aliases
bl logs sbx my-sandbox —follow
bl logs j my-job —period 1h
bl logs fn my-function —follow
bl logs RESOURCE_TYPE RESOURCE_NAME [NESTED_ARGS...] [flags]
Options
--end string End time for logs (RFC3339 format or YYYY-MM-DD)
-f, --follow Follow log output (like tail -f)
-h, --help help for logs
--no-timestamps Hide timestamps in log output
-p, --period string Time period to fetch logs (e.g., 3d, 1h, 10m, 24h)
--search string Search for logs containing specific text
--severity string Filter by severity levels (comma-separated): FATAL,ERROR,WARNING,INFO,DEBUG,TRACE,UNKNOWN
--start string Start time for logs (RFC3339 format or YYYY-MM-DD)
--utc Display timestamps in UTC instead of local timezone
Options inherited from parent commands
-o, --output string Output format. One of: pretty,yaml,json,table
--skip-version-warning Skip version warning
-v, --verbose Enable verbose output
-w, --workspace string Specify the workspace name
SEE ALSO
- bl - Blaxel CLI is a command line tool to interact with Blaxel APIs.
Last modified on April 6, 2026
