Steve HutchinsonBig Pines

OpenTelemetry

The observability framework used to instrument cognition as distributed traces, metrics, and logs. Project-specific semantic conventions live under the cog.* namespace.

OpenTelemetry (OTEL) is the vendor-neutral instrumentation standard that the Cognitive Substrate uses for cognitive observability. Rather than building a proprietary metrics and tracing system, the project extends OTEL's existing semantic conventions with cog.*-namespaced attributes that describe cognitive-specific events: cog.retrieval.latency for memory gateway response time, cog.arbitration.margin for the score gap between winning and second-place proposals, cog.policy.drift_magnitude for the current session's cumulative policy change, cog.calibration.error for the mean confidence-accuracy deviation across operation types. These attributes flow through standard OTEL pipelines - exporters, collectors, sampling configurations - and into standard observability backends. The distributed trace model is particularly valuable: a single cognitive loop iteration generates a trace with spans for each step (perceive, retrieve, reason, act, evaluate, consolidate), and each agent's deliberation produces a child span within the reason step. This lets operators trace exactly which retrieval call was slow, which agent produced the lowest-confidence proposal, and where in the loop the latency budget was consumed.

This site collects anonymous usage data to understand how people read and navigate the blog. Accepting enables persistent reader preferences across visits.