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.