<a class="badge" href="https://dpeuniversity.gradle.com/app/courses/b5069222-cfd0-4393-b645-7a2c713853d5/" target="_blank">
        <span class="badge-type button--blue">LEARN</span>
        <span class="badge-text">How to Use Build Scans&nbsp;&nbsp;&nbsp;&gt;</span>
    </a>
</div>
++++

A build scan is a *representation of metadata captured* as you run your build.

image::gradle-basic-1.png[]

== Build Scans

teamcity-build-scan-plugin.png...

troubleshooting-dependency-management-build-scan.png...

			// conservative scanning, we have to scan it
			// defensively, too.
			state.putPtr(val, true)
			continue
		}

		// Check if val points to a heap span.
		span := spanOfHeap(val)
		if span == nil {
			continue
		}

		// Check if val points to an allocated object.
		idx := span.objIndex(val)
		if span.isFree(idx) {
			continue
		}

build-scan-trans-dependencies.png...

build-scan-performance-page.png...

gradle-core-test-build-scan-performance.png...

In Gradle 4.3 and above, you can create a build scan using the `--scan` command line option:

[listing.terminal]
----
$ gradle build --scan
----

For older Gradle versions, the
https://docs.gradle.com/build-scan-plugin/#getting_set_up[Build Scan Plugin User Manual]
explains how to enable build scans.

At the end of your build, Gradle displays a URL where you can find your build scan:

----
BUILD SUCCESSFUL in 2s

apiVersion: release-notes/v2
kind: bug-fix
area: security
releaseNotes:
  - |

troubleshooting-task-execution-build-scan.png...