> ## Documentation Index
> Fetch the complete documentation index at: https://namespace.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Builds UI

export const CenteredImage = ({src, alt, width, caption, className}) => {
  const [basePath, setBasePath] = useState("");
  useEffect(() => {
    const path = window.location.pathname;
    setBasePath(path === "/docs" || path.startsWith("/docs/") ? "/docs" : "");
  }, []);
  return <Frame caption={caption} className={className} style={{
    maxWidth: width,
    marginInline: "auto"
  }}>
			<OptimizedImage src={`${basePath}${src}`} alt={alt} />
		</Frame>;
};

## Overview

The Build Dashboard provides comprehensive insights into your build performance and failures through detailed traces, step logs, and contextual information.
This centralized view helps you quickly identify, debug, and optimize your Docker builds.

## Build Failure Analysis

**Failure Detection & Highlighting**
The dashboard automatically extracts and highlights build failure causes directly in the main view. Failed builds are prominently displayed with clear error indicators and quick access to detailed diagnostics.

<CenteredImage width={600} alt="build failure extraction" src="/docs/images/docker-builders/failure.png" />

**Step-by-Step Logs**
Navigate to the logs view to examine detailed output for each build step. This granular visibility allows you to understand the exact context and sequence of events leading to failures.

<CenteredImage width={600} alt="build step logs" src="/docs/images/docker-builders/logs.png" />

**Build Attribution**
Each build failure includes contextual information showing the specific commit used as the build base and the build machine that executed the build.
This attribution data is essential for determining whether failures stem from recent code changes or infrastructure issues.

<CenteredImage width={600} alt="build attribution" src="/docs/images/docker-builders/attribution.png" />

## Performance Monitoring

**Cache Utilization Overview**
The dashboard provides at-a-glance visibility into which build steps utilized cache effectively. Cached steps are clearly marked, helping you identify unexpected cache misses that may indicate suboptimal build definitions.

<CenteredImage width={600} alt="cached build steps" src="/docs/images/docker-builders/cached-steps.png" />

**Critical Path Analysis**
The build trace view visualizes your build execution's critical path, highlighting bottlenecks and parallel execution opportunities.

<CenteredImage width={600} alt="build layer performance tracing" src="/docs/images/docker-builders/tracing.png" caption="Critical path analysis for Docker builds" />

## Builds in Context

**Integrated Workflow Attribution**
When builds are initiated from Namespace compute environments, the dashboard records and displays these connections, enabling you to trace builds back to their originating workflows.

<CenteredImage width={600} alt="build attribution" src="/docs/images/docker-builders/attribution.png" />

**Bidirectional Navigation**
The connection tracking works both ways - from the dashboard, you can navigate to associated GitHub Actions runs, and from GitHub Actions debugging views, you can inspect related builds with a single click.

<div className="flex flex-wrap items-center justify-center gap-8 my-8">
  <CenteredImage width={290} alt="Container Builds" src="/docs/images/github-actions/container-builds.png" className="m-0" />

  <CenteredImage width={400} alt="Build Tracing" src="/docs/images/github-actions/buildtrace.png" className="m-0" />
</div>
