# observability Specs

> Canonical path: `specs/observability/README.md`

This README lists canonical specs for the `observability` domain in recommended reading order.

- [Observability](./observability.md) — three-pillar contract, deployment neutrality, cardinality and scan-amplification discipline, ownership, configuration surface, guardrail.
- [统一日志规范](./logging.md) — Server、Gateway、Desktop、Web/Electron、内嵌组件与本地诊断文件的统一字段、domain、输出/rotate 配置、隐私和性能合同。
- [Metrics](./metrics.md) — naming rules, histogram bucket families, forbidden names, and the initial required collector surface.