command: docker buildx history logs
short: Print the logs of a build record
long: |-
    Print the logs for a completed build. The output appears in the same format as
    `--progress=plain`, showing the full logs for each step.

    By default, this shows logs for the most recent build on the current builder.

    You can also specify an earlier build using an offset. For example:

    - `^1` shows logs for the build before the most recent
    - `^2` shows logs for the build two steps back
usage: docker buildx history logs [OPTIONS] [REF]
pname: docker buildx history
plink: docker_buildx_history.yaml
options:
    - option: progress
      value_type: string
      default_value: plain
      description: Set type of progress output (plain, rawjson, tty)
      details_url: '#progress'
      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: |-
    ### Print logs for the most recent build

    ```console
    $ docker buildx history logs
    #1 [internal] load build definition from Dockerfile
    #1 transferring dockerfile: 31B done
    #1 DONE 0.0s
    #2 [internal] load .dockerignore
    #2 transferring context: 2B done
    #2 DONE 0.0s
    ...
    ```

    By default, this shows logs for the most recent build on the current builder.

    ### Print logs for a specific build

    To print logs for a specific build, use a build ID or offset:

    ```console
    # Using a build ID
    docker buildx history logs qu2gsuo8ejqrwdfii23xkkckt

    # Or using a relative offset
    docker buildx history logs ^1
    ```

    ### Set type of progress output (--progress) {#progress}

    ```console
    $ docker buildx history logs ^1 --progress rawjson
    {"id":"buildx_step_1","status":"START","timestamp":"2024-05-01T12:34:56.789Z","detail":"[internal] load build definition from Dockerfile"}
    {"id":"buildx_step_1","status":"COMPLETE","timestamp":"2024-05-01T12:34:57.001Z","duration":212000000}
    ...
    ```
deprecated: false
hidden: false
experimental: false
experimentalcli: false
kubernetes: false
swarm: false

