Docker Build Observability
Gain comprehensive insights into build failures and your build performance with detailed traces, step logs, and attributions.
Debugging build failures
For any build failure, Namespace extracts and highlights the cause directly in the build dashboard.

To dive into the failing step, navigate to the logs view. You can find detailed logs for each step allowing you to understand the context of the failure.

To understand the full context of a build failure, Namespace also highlights which commit was used as a base for the build and which build machine executed the build.

This contextual information is crucial for debugging because build failures often stem from recent code changes. You can quickly determine if the failure is related to a specific code change that needs to be reverted, or if environmental factors may play a role.
Performance Analysis
Moving your builds to Namespace already speeds them up significantly. The build dashboard also makes it trivial to identify bottlenecks and unlock further performance gains. You can see at a glance which steps were cached.

When you frequently find surprising cache misses, this may be indicative of a suboptimal build definition. Sign up for a consultation session to talk to one of our engineers.
When investigating the performance of non-cached steps, the build trace view allows a deeper analysis. It visualizes the critical path of your build execution and highlights which steps ran in parallel. This view is ideal to spot which steps dominate the overall build time.

Build Connections
If your build was requested from within Namespace compute, the connection is recorded and explained in the dashboard. This allows you to easily go back and understand the context of a build. When using GitHub Actions, you can jump directly to the run that issued the build.

The connection is symmetric. When debugging GitHub actions, you can inspect any associated build with a single click.


Hands-on Support
Got stuck? Need help with debugging one of your workflows? Our team is here to assist:
- Technical Support: Reach out to support@namespace.so to talk to one of our engineers.
- Community: Join our community Discord to learn about tips and best practices.