The Stonemason's Touchstone: Probing the Edge by Testing the Center
We spend so much time watching our external endpoints, our public APIs, the shiny faces of our services presented to the world. We ping them, we time them, we alert when they stumble. This vigilance is necessary, of course. But it creates a peculiar illusion: that the health of that public interface is the health of the system. It confuses the facade for the foundation. I’d like to propose a small, concrete shift in practice, one borrowed from an older craft: the use of an internal touchstone.
Imagine a stonemason, tasked with judging the quality of a whole quarry’s slate. He doesn’t only examine the showpiece slabs destined for rooftops. He carries a small, unassuming piece of the core stone—a touchstone. By testing this humble fragment, he understands the integrity of the entire vein. Our systems have a core, too. It’s not the load balancer or the ingress controller. It’s the most fundamental, unadorned piece of business logic your service performs. The atomic transaction. The irreducible query. The singular calculation upon which everything else is built.
Here is the technique: instrument a dedicated, silent health check endpoint that does not test the network path or the web server. Instead, it performs this one core operation in isolation. For a database-backed service, this might be a single, simple SELECT on a known-good row from a core table. For a message processor, it might be publishing and immediately consuming a canned test message on a private loopback queue. For a calculation engine, it might be running a known input through its primary algorithm and asserting the output.
This is not a synthetic transaction that mimics a user journey. It is more primitive. It is a probe that bypasses all the layers of abstraction—the caches, the API gateways, the middleware—and touches the actual heart of the machine. You deploy this endpoint internally, not publicly. Its latency and success rate become your touchstone metrics.
The power of this is twofold. First, when your external monitors go red, the touchstone tells you where to look. If the public API is failing but the touchstone is green, your problem is almost certainly in the periphery—the routing, the presentation layer, the external dependencies. If the touchstone itself is failing, you know immediately that the core is compromised; there is no need to troubleshoot the web server config. You’ve just saved an hour of diagnostic drift.
Second, and more subtly, it reveals a different kind of latency. The latency of the core’s degradation. By watching the touchstone’s response time over weeks and months, you see the slow creep of bloat in your database, the gradual saturation of your internal message bus, the accumulating overhead in your core logic. The public endpoint’s latency is a noisy composite signal. The touchstone’s latency is the pure tone of your system’s fundamental health. It is the rhythm of the quarry itself, heard not in the finished roof, but in the raw stone.
So, find your one true operation. Wrap it in a quiet, internal endpoint. Monitor it with the same fervor you apply to your public faces. Let it be the fragment that tells you about the whole vein. In the chaos of a cascade, you’ll be glad to know, with certainty, whether the trouble is in the masonry, or in the foundation.
Notes & further reading
A few pages I came back to while writing this:
- Jackson, MS
- The Dog That Barks at Everything: On the Peril of Perfect Health
- Cary, NC
- The Weaver of Penicuik: On Warp, Weft, and Latency
- Charlotte, NC
- The Bell Ringer of St. Clement's: On the Rhythm of Continuous Presence
- Fayetteville, NC
- Greensboro, NC
- Raleigh, NC
- Lincoln, NE
- Omaha, NE
- Elizabeth, NJ
- Jersey City, NJ