Add descriptions and examples for buildx history commands

Signed-off-by: sarahsanders-docker <sarah.sanders@docker.com>
This commit is contained in:
sarahsanders-docker
2025-04-17 14:50:58 -04:00
committed by Tonis Tiigi
parent 9a48aca461
commit 4dac5295a1
9 changed files with 237 additions and 0 deletions

View File

@@ -15,3 +15,36 @@ Show the OpenTelemetry trace of a build record
<!---MARKER_GEN_END-->
## 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
```console
docker buildx history trace
```
### Open the trace for a specific build
```console
docker buildx history trace mybuild
```
### Run the Jaeger UI on a specific port
```console
docker buildx history trace mybuild --addr 127.0.0.1:16686
```
### Compare two build traces
```console
docker buildx history trace --compare mybuild:main mybuild:feature
```