buildx_history_inspect
Inspect a single Docker build record by ref to debug failed or slow builds. Returns duration, materials, attestations, and errors from JSON output.
Instructions
Inspect a single build record by ref, parsed from --format json.
Returns the full record for one build - duration, materials, attestations, error (if any) -
for debugging a failed or slow build found via buildx_history_list. Requires buildx >=
v0.13.
Raises RemoteFailureError if the CLI call fails.
Args:
ref: Build record ref. Pass the ref field from buildx_history_list directly - it reports a qualified
"//", but history inspect only accepts the bare id, so this reduces it to the id and
(unless builder is given) targets the builder named in the ref. Empty/omitted inspects the most recent
build; the ^N syntax (e.g. "^0" = latest) is also valid.
builder: Builder instance the build ran on (defaults to the one in ref, else active)
Returns: dict: The parsed build record (or {"raw": } if the output isn't a JSON object)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | ||
| builder | No |