logo

nsc build logs

Print logs for a build.

nsc build logs prints the logs produced by a specific nsc build invocation, identified by its build reference (<build-ref>). It's useful when you want to inspect the output of a build that's still running, or one that already finished, without needing to keep the original terminal session open.

By default, logs are printed in a human-readable plain format. Passing --output json instead streams the raw BuildKit status events as one JSON object per line, which is convenient if you want to feed the build's log output into another tool for processing.

Usage

nsc build logs <build-ref> [-o <plain|json>]

Example

$ nsc build logs <build-ref>

To fetch the raw BuildKit JSON status stream instead:

$ nsc build logs <build-ref> --output json

Options

--output, -o <plain|json>

Specifies the output format. Supported values are plain and json; json prints the raw BuildKit status stream as one JSON object per line. Defaults to plain.

  • nsc build - Build container images using Namespace Remote Builders