kata-pov-observability-instrument

What problem does it solve?

It prevents blind operation of an agent “PoV” by requiring standardized telemetry so you can measure quality, debug failures, and satisfy observability contracts without storing sensitive content.

Core Features & Use Cases

• Define trace spans (OpenTelemetry-compatible) for agent turns and optional tool calls, including outcomes and timing.
• Specify redacted prompts and tool-call logs using hashes and token/size counts to avoid raw text or parameters.
• Track leading value metrics such as reconciliation rate and refusal/latency alarms with clear discontinuation thresholds.
• Persist a dedicated observability folder that cross-links to required conformance checklists.

Quick Start

Have your PoV author create the four observability files under docs/{context}/agents-pov/{agent}/observability/ and ensure they never store raw prompt text or raw tool parameters, only hashes and aggregate metadata.