Webinar

“Digging into Gatsby 5’s Slice API” Register now

Build Logs

Gatsby Cloud provides a few helpful views of build logs to understand more about what is happening during the build process.

Viewing build logs

You can view logs by clicking on the “title link” on any Production or Pull Request build card.

Build log title link

For CMS Preview builds, click the “View Details” link on the build card.

CMS Preview build link

Select “Share” at the top of the logs page to copy the page link. This is useful for when you need to contact Customer Support.

Build sharing link

Structured logs

Structured logs provide an immediate, high-level overview of the status of your build. They include information about how long each build step lasted as well as any warnings or errors. They are shown in the “All Logs” tab. Structure logging is only available on Gatsby version 2.16.0 or later.

Gatsby Cloud structured build logs

Error and warning logs

The Error and Warnings tabs filter the structured logging to only show, errors or warnings, respectively.

Gatsby Cloud error and warning logs

Raw logs

Raw logs provide the full, unstructured build process output. They are useful for finding more detail about exactly where things went wrong.

Gatsby Cloud raw build logs

Verbose logs

You can get verbose logging by setting an environment variable: VERBOSE=1

Edit this page on GitHub
© 2022 Gatsby, Inc.