telemetry

type Metrics struct {
	AlertsReceived             metric.Int64Counter
	AlertsCoalesced            metric.Int64Counter
	AlertsSuppressed           metric.Int64Counter
	InvestigationsStarted      metric.Int64Counter
	InvestigationsThrottled    metric.Int64Counter
	InvestigationsDropped      metric.Int64Counter
	InvestigationsCancelled    metric.Int64Counter // queued (not yet started) investigations cancelled because the incident resolved first (cancel_queued_on_resolve)
	GitOpsFailuresDebounced    metric.Int64Counter // GitOps failures dropped as transient (cleared within the debounce window)
	IncidentsDebounced         metric.Int64Counter // firing alerts dropped as self-resolving (resolved within the incident debounce window)
	IncidentsDroppedOnShutdown metric.Int64Counter // firing alerts LOST: still held in the debounce window when the process shut down (accepted, never investigated)
	ToolOutputTruncatedBytes   metric.Int64Counter
	HistoryCompactions         metric.Int64Counter // mid-loop history compaction events
	HistoryElidedBytes         metric.Int64Counter // tool-output bytes elided by compaction
	HistorySummarizations      metric.Int64Counter // compaction events whose elided batch was replaced by a model digest
	HistorySummarizeFallbacks  metric.Int64Counter // summarize-mode compactions that fell back to plain elision (summarizer error/refusal/truncation)
	RecallHits                 metric.Int64Counter // KB cache hits, labelled by verify result
	RecallTokensSaved          metric.Int64Counter // estimated tokens saved by a recall short-circuit
	RecallRejections           metric.Int64Counter // recalls rejected before short-circuit (label: reason)
	CoalesceBatchSize          metric.Int64Histogram
	InvestigationTokens        metric.Int64Histogram
	// Per-investigation model usage totals (loop + verify), recorded once at
	// delivery — the actual provider-reported spend, distinct from the pre-request
	// InvestigationTokens estimate.
	InvestigationModelCalls        metric.Int64Histogram
	InvestigationInputTokens       metric.Int64Histogram
	InvestigationOutputTokens      metric.Int64Histogram
	InvestigationCachedInputTokens metric.Int64Histogram
	InvestigationCostUSD           metric.Float64Histogram // estimated per-investigation cost, USD (only when model.pricing is configured)
	RecallScore                    metric.Float64Histogram // BM25 score at the recall decision (tunes min_score)
	CurationDedupScore             metric.Float64Histogram // catalog top-hit BM25 score at the curation dedup decision
	OutcomesOpened                 metric.Int64Counter     // investigations recorded as open (label: kind)
	IncidentsResolved              metric.Int64Counter     // resolve events that matched an open investigation
	RecallOutcome                  metric.Int64Counter     // resolved incidents whose open was a recall (label: result)
	IncidentResolutionSeconds      metric.Float64Histogram // open→resolve duration, seconds

	InvestigationDuration   metric.Float64Histogram // wall-clock per investigation (label: result)
	InvestigationsCompleted metric.Int64Counter     // investigations finished (label: result)
	ToolCalls               metric.Int64Counter     // investigation tool calls (label: tool, result)
	ToolCallDuration        metric.Float64Histogram // tool call latency, seconds (label: tool)
	ModelRequests           metric.Int64Counter     // LLM completion requests (label: provider, result)
	ModelRequestDuration    metric.Float64Histogram // LLM completion latency, seconds (label: provider)
	ModelResponsesTruncated metric.Int64Counter     // LLM completions cut off at the output-token ceiling (label: provider)
	ModelInputTokens        metric.Int64Counter     // total input tokens across LLM requests (label: provider)
	ModelCachedInputTokens  metric.Int64Counter     // input tokens served from cache (label: provider)
	Curations               metric.Int64Counter     // curation outcomes (label: kind, result)
	CatalogInvalidEntries   metric.Int64Counter     // structurally-invalid entries found at catalog load
}