buildx/docs/reference/buildx_history_trace.md
sarahsanders-docker 4dac5295a1
Add descriptions and examples for buildx history commands
Signed-off-by: sarahsanders-docker <sarah.sanders@docker.com>
2025-05-05 14:32:03 -07:00

1.4 KiB

docker buildx history trace

Show the OpenTelemetry trace of a build record

Options

Name Type Default Description
--addr string 127.0.0.1:0 Address to bind the UI server
--builder string Override the configured builder instance
--compare string Compare with another build reference
-D, --debug bool Enable debug logging

Description

View the OpenTelemetry trace for a completed build. This command loads the trace into a Jaeger UI running in a local container (or a custom instance if configured) and opens it in your browser.

This helps analyze build performance, step timing, and internal execution flows.

Examples

Open the OpenTelemetry trace for the most recent build

docker buildx history trace

Open the trace for a specific build

docker buildx history trace mybuild

Run the Jaeger UI on a specific port

docker buildx history trace mybuild --addr 127.0.0.1:16686

Compare two build traces

docker buildx history trace --compare mybuild:main mybuild:feature