telemetry

Documentation

Index

• type Event
• type EventType
• type Logger
  • func NewLogger() (*Logger, error)
  • func (l *Logger) Close() error
  • func (l *Logger) Log(event Event)

Types

type Event

type Event struct {
	Timestamp    string    `json:"timestamp"`
	ProviderID   string    `json:"provider_id,omitempty"`
	EventType    EventType `json:"event_type"`
	LatencyMS    int64     `json:"latency_ms,omitempty"`
	InputTokens  int       `json:"input_tokens,omitempty"`
	OutputTokens int       `json:"output_tokens,omitempty"`
	ToolName     string    `json:"tool_name,omitempty"`
	Success      *bool     `json:"success,omitempty"`
	Error        string    `json:"error,omitempty"`
	Accepted     *bool     `json:"accepted,omitempty"` // user feedback: tool accepted/rejected
}

Event is a single telemetry record written as one JSON line.

type EventType

type EventType string

EventType identifies the kind of telemetry event.

const (
	EventProviderResponse  EventType = "provider_response"
	EventConsensusComplete EventType = "consensus_complete"
	EventToolExecuted      EventType = "tool_executed"
	EventPipelineError     EventType = "pipeline_error"
	EventQueryStart        EventType = "query_start"
	EventUserFeedback      EventType = "user_feedback"
)

type Logger

type Logger struct {
	// contains filtered or unexported fields
}

Logger appends telemetry events to a JSONL file.

func NewLogger

func NewLogger() (*Logger, error)

NewLogger opens (or creates) the telemetry log file at <ConfigDir>/telemetry.jsonl. If the file exceeds 10 MB it is truncated to the last 5 MB before the logger begins appending.

func (*Logger) Close

func (l *Logger) Close() error

Close flushes and closes the underlying file.

func (*Logger) Log

func (l *Logger) Log(event Event)

Log records a single event. It sets the timestamp automatically and is safe for concurrent use.