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

