plano/docs/source/guides/observability
Syed Hashmi ca4a9e57f2
docs: align signals page with paper taxonomy
Updates docs/source/concepts/signals.rst and the tracing guide's signals
subsection to reflect the three-layer taxonomy shipped in #903:

- Introduces the paper reference (arXiv:2604.00356) and the three layers
  (interaction, execution, environment) with all 20 leaf signal types in
  three reference tables
- Documents the new layered OTel attribute set
  (signals.interaction.*, signals.execution.*, signals.environment.*)
  and marks the legacy aggregate keys (signals.follow_up.repair.*,
  signals.frustration.*, signals.repetition.count,
  signals.escalation.requested, signals.positive_feedback.count) as
  deprecated-but-still-emitted
- Adds a Span Events section describing the per-instance signal.<type>
  events with confidence / snippet / metadata attributes
- Fixes the flag marker reference ([!] in the code vs 🚩 in the old docs)
- Updates all example attributes, dashboard queries, and alert rules to
  use the layered keys
- Updates the tracing guide's behavioral-signals subsection to match
- Notes that the triage sampler is a planned follow-up and today sampling
  is consumer-side via observability-platform filters

Build verified locally: sphinx-build produces no warnings on these files.

Made-with: Cursor
2026-04-23 12:44:27 -07:00
..
access_logging.rst Rename all arch references to plano (#745) 2026-02-13 15:16:56 -08:00
monitoring.rst Add Prometheus metrics endpoint and Grafana dashboard for brightstaff (#904) 2026-04-22 11:19:10 -07:00
observability.rst Doc Update (#129) 2024-10-06 16:54:34 -07:00
tracing.rst docs: align signals page with paper taxonomy 2026-04-23 12:44:27 -07:00