Skip to main content
Version: 0.207

logs

terrabuild logs loads logs for selected targets without running a new build.

USAGE: terrabuild logs [--help] [--workspace <path>] [--configuration <name>]
                       [--environment <name>] [--variable <variable>=<value>]
                       [--label [<labels>...]] [--type [<types>...]]
                       [--project [<projects>...]] [--local-only] <target>...

Examples​

terrabuild logs build
terrabuild logs build --project api
terrabuild logs build --environment dev --local-only

Use this command when you want to inspect the cached result for a target instead of executing terrabuild run.

Use shared selection options to match the configuration, environment, variables, and projects of the build whose logs you need. --local-only requests local cache only.

Cached operation logs are downloaded on demand when rendering reports, including after a metadata-only cache hit. This does not restore target outputs or rerun commands. With --local-only, missing local logs remain unavailable instead of triggering a remote download. The same behavior applies when terrabuild run --log prints cached results.