Hermetiq Learn

The operating manual for Bazel and Buildbarn.

Practical paths for diagnosing failures, cache misses, and remote-execution bottlenecks.

Search the technical library

Start with the symptom.

Start here

Choose the problem in front of you.

01

Improve Bazel performance

Establish a baseline, find repeated work, and separate build-graph constraints from infrastructure constraints.

MeasureDiagnoseVerify
Follow this path →02

Debug remote-cache misses

Move from an aggregate hit rate to the key-forming fields that differ between comparable actions.

ReproduceCompareFix
Follow this path →03

Operate Buildbarn and RBE

Understand the scheduler, worker, storage, queue, and transfer layers—and how they affect individual builds.

DeployObserveTune
Follow this path →
Have the exact error?Jump straight to the troubleshooting index.8 guides →
Error reference

Start from the failure you can see.

Each guide separates what the status means from the causes you still need to verify.

01Bazel remote execution DEADLINE_EXCEEDED02Bazel remote cache UNAVAILABLE03Buildbarn action stuck in queue04Buildbarn CAS NOT_FOUND05Bazel “no matching toolchains found”06Bazel cache misses across machines07Buildbarn worker not receiving actions08Bazel action key changed unexpectedly
Primary sources

Go to the specification.

RSS →
BazelBazel remote-caching documentationBuildbarnBuildbarn remote-execution sourceREAPIRemote Execution API specificationBazelBazel Build Event Protocol documentationgRPCgRPC status-code reference
Accuracy standards

Technical content should show its work.

Report an error or request a correction →
01Primary sources first

Guides link to Bazel, Buildbarn, REAPI, or gRPC references.

02Meaning is not cause

Protocol meaning is separated from causes that require verification.

03Version-aware

Behavior can vary by Bazel, Buildbarn, proxy, and deployment version.

Investigate your own builds

Turn build telemetry into answers.

Apply the same evidence-led approach to the builds running in your environment.

Create free account →Book a 20-minute demo →