mirror of
https://github.com/docker/docs.git
synced 2026-03-30 07:48:52 +07:00
105 lines
2.8 KiB
YAML
Generated
105 lines
2.8 KiB
YAML
Generated
command: docker buildx history trace
|
|
short: Show the OpenTelemetry trace of a build record
|
|
long: |-
|
|
View the OpenTelemetry trace for a completed build. This command loads the
|
|
trace into a Jaeger UI viewer and opens it in your browser.
|
|
|
|
This helps analyze build performance, step timing, and internal execution flows.
|
|
usage: docker buildx history trace [OPTIONS] [REF]
|
|
pname: docker buildx history
|
|
plink: docker_buildx_history.yaml
|
|
options:
|
|
- option: addr
|
|
value_type: string
|
|
default_value: 127.0.0.1:0
|
|
description: Address to bind the UI server
|
|
details_url: '#addr'
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
- option: compare
|
|
value_type: string
|
|
description: Compare with another build record
|
|
details_url: '#compare'
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
inherited_options:
|
|
- option: builder
|
|
value_type: string
|
|
description: Override the configured builder instance
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
- option: debug
|
|
shorthand: D
|
|
value_type: bool
|
|
default_value: "false"
|
|
description: Enable debug logging
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
examples: |-
|
|
### Open the OpenTelemetry trace for the most recent build
|
|
|
|
This command starts a temporary Jaeger UI server and opens your default browser
|
|
to view the trace.
|
|
|
|
```console
|
|
docker buildx history trace
|
|
```
|
|
|
|
### Open the trace for a specific build
|
|
|
|
```console
|
|
# Using a build ID
|
|
docker buildx history trace qu2gsuo8ejqrwdfii23xkkckt
|
|
|
|
# Or using a relative offset
|
|
docker buildx history trace ^1
|
|
```
|
|
|
|
### Run the Jaeger UI on a specific port (--addr) {#addr}
|
|
|
|
```console
|
|
# Using a build ID
|
|
docker buildx history trace qu2gsuo8ejqrwdfii23xkkckt --addr 127.0.0.1:16686
|
|
|
|
# Or using a relative offset
|
|
docker buildx history trace ^1 --addr 127.0.0.1:16686
|
|
```
|
|
|
|
### Compare two build traces (--compare) {#compare}
|
|
|
|
Compare two specific builds by name:
|
|
|
|
```console
|
|
# Using build IDs
|
|
docker buildx history trace --compare=qu2gsuo8ejqrwdfii23xkkckt qsiifiuf1ad9pa9qvppc0z1l3
|
|
|
|
# Or using a single relative offset
|
|
docker buildx history trace --compare=^1
|
|
```
|
|
|
|
When you use a single reference with `--compare`, it compares that build
|
|
against the most recent one.
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
|