Skip to main content
Field notes

How a value-route turns observations into evidence

Static traffic counts do not prove a regression is real. A value-route reach number does.

Deploy-linked route evidence, summarized for review.

Most observability products know how to surface a number. Far fewer know how to make that number persuasive.

A traffic count can still feel inert. It can be charted, smoothed, and color-graded while leaving the on-call engineer unsure whether the dip is real, whether it matters, and whether the last deploy is responsible.

What a value-route does

A value-route is a single route in your Next.js app that you mark as the outcome you care about. Checkout success. Signup confirmed. Plan upgraded. The runtime SDK reports reach to that route, broken down by entry point, by session, and by deploy.

That small definition matters because reach to a value-route is what turns a route regression into evidence:

  • how many sessions reached the value-route this hour
  • how many reached it from each entry point
  • how that number moved across the last deploy
  • whether the change crossed the CUSUM threshold

When the number drops and CUSUM agrees, the system raises an observation. The observation carries the value-route name, the suspected route or edge, and the deploy SHA.

Why traffic counts alone are not enough

Raw traffic counts usually prove activity, not outcome. They show that pages are loading, not that users are succeeding.

A value-route is closer to instrumentation than ornament. It tells the diagram which routes matter for the business and lets the regression detector weigh shifts accordingly. A 12% drop in a marketing route is not the same as a 12% drop in checkout reach, and TrueClara treats them differently.

Why this matters for TrueClara

TrueClara works best when the diagram, the observations feed, and the deploys list all read from the same value-route reach numbers. That is what makes the loop coherent.

When teams can see that a regression cost real reach to a real value-route on a specific deploy, they stop treating observability as a chart and start treating it as an operating layer.

TrueClara Team
Deploy-aware observations

Notes from the TrueClara team on deploy attribution, route-level behavior, and operating evidence.