Log View

The Crafting system collects and manages logs from the following sources:

• Scripts involved in workspace setup and automation (setup scripts, checkout hooks, build hooks)
• Daemons and jobs running in the workspace
• The main process of dependency services
• The init process of container workloads

Logs are persisted locally with the workload and are discarded when the workload is removed.

Accessing Logs

Web UI

The Crafting Web UI provides an aggregated log viewer that shows logs from multiple workloads in a single, unified view. Logs can be viewed and streamed in real time.

CLI

Use the cs logs command to stream logs from a specific process in a workload:

cs logs

Filesystem

Log files are stored directly on the workspace filesystem under /var/log/sandbox and are automatically rotated. They can be read with standard tools like cat, tail -f, or any log viewer.

See Also

• Workspace Automation — daemons, jobs, and the processes that generate logs
• Sandbox — workload types whose logs are collected