Algis DumbrisandClaude Opus 4.6
be098081b4
Add comprehensive trace logging and observability features: - Enhanced trace store with owner-scoped queries, filtering (agent, action, time range), pagination, streaming export, and retention cleanup - REST API endpoints: GET /api/traces (list with filters), GET /api/traces/export (streaming JSON/CSV), GET /api/traces/stats (action counts) - Owner isolation enforced at every layer (store, API, tests) - Hand-rolled Prometheus metrics (pure Go, zero CGO): traces_total, traces_by_action, errors_total, active_agents at GET /metrics - Configurable slog JSON handler with --log-level flag - Request ID middleware for cross-referencing logs and traces - Batch trace writing (64 entries or 100ms flush interval) - Background retention cleanup via --trace-retention flag - SQL migration 002 adds owner_id column and composite indexes Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
55 lines
1.4 KiB
Go
55 lines
1.4 KiB
Go
package trace
|
|
|
|
import (
|
|
"encoding/json"
|
|
"time"
|
|
)
|
|
|
|
// Trace represents a single recorded agent action.
|
|
type Trace struct {
|
|
ID int64 `json:"id"`
|
|
OwnerID string `json:"owner_id"`
|
|
AgentName string `json:"agent_name"`
|
|
Action string `json:"action"`
|
|
Details json.RawMessage `json:"details"`
|
|
Error string `json:"error,omitempty"`
|
|
Timestamp time.Time `json:"timestamp"`
|
|
}
|
|
|
|
// TraceFilter defines query parameters for filtering traces.
|
|
type TraceFilter struct {
|
|
OwnerID string `json:"owner_id"`
|
|
AgentName string `json:"agent_name,omitempty"`
|
|
Action string `json:"action,omitempty"`
|
|
Since *time.Time `json:"since,omitempty"`
|
|
Until *time.Time `json:"until,omitempty"`
|
|
Page int `json:"page"`
|
|
PageSize int `json:"page_size"`
|
|
}
|
|
|
|
// Normalize sets defaults for missing filter values.
|
|
func (f *TraceFilter) Normalize() {
|
|
if f.Page < 1 {
|
|
f.Page = 1
|
|
}
|
|
if f.PageSize <= 0 {
|
|
f.PageSize = 50
|
|
}
|
|
if f.PageSize > 200 {
|
|
f.PageSize = 200
|
|
}
|
|
}
|
|
|
|
// Offset returns the SQL offset for the current page.
|
|
func (f *TraceFilter) Offset() int {
|
|
return (f.Page - 1) * f.PageSize
|
|
}
|
|
|
|
// TraceExportFormat defines the output format for trace exports.
|
|
type TraceExportFormat string
|
|
|
|
const (
|
|
ExportFormatJSON TraceExportFormat = "json"
|
|
ExportFormatCSV TraceExportFormat = "csv"
|
|
)
|