metrics

package
v0.4.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 17, 2026 License: MIT Imports: 14 Imported by: 0

Documentation

Overview

Package metrics implements the Metrics Service for tracking API usage.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type MetricBucket

type MetricBucket struct {
	Timestamp        time.Time                   `json:"timestamp"`
	TotalRequests    int64                       `json:"total_requests"`
	TotalErrors      int64                       `json:"total_errors"`
	TokensInput      int64                       `json:"tokens_input"`
	TokensOutput     int64                       `json:"tokens_output"`
	PeakRequests     int64                       `json:"peak_requests"`
	PeakInputTokens  int64                       `json:"peak_input_tokens"`
	PeakOutputTokens int64                       `json:"peak_output_tokens"`
	DurationSum      int64                       `json:"duration_sum"`   // microseconds
	DurationCount    int64                       `json:"duration_count"` // number of requests with duration
	ByProviderID     map[string]*ProviderMetrics `json:"by_provider_id"`
	ByProviderType   map[string]*ProviderMetrics `json:"by_provider_type"`
	ByModel          map[string]*ModelMetrics    `json:"by_model"`
	ByTokenID        map[string]*TokenMetrics    `json:"by_token_id"`
	ErrorsByType     map[string]int64            `json:"errors_by_type"`
}

MetricBucket represents aggregated metrics for a time window.

type ModelMetrics

type ModelMetrics struct {
	Requests         int64 `json:"requests"`
	Errors           int64 `json:"errors"`
	TokensInput      int64 `json:"tokens_input"`
	TokensOutput     int64 `json:"tokens_output"`
	PeakRequests     int64 `json:"peak_requests"`
	PeakInputTokens  int64 `json:"peak_input_tokens"`
	PeakOutputTokens int64 `json:"peak_output_tokens"`
}

ModelMetrics tracks metrics for a specific model.

type ProviderMetrics

type ProviderMetrics struct {
	Requests         int64 `json:"requests"`
	Errors           int64 `json:"errors"`
	TokensInput      int64 `json:"tokens_input"`
	TokensOutput     int64 `json:"tokens_output"`
	PeakRequests     int64 `json:"peak_requests"`
	PeakInputTokens  int64 `json:"peak_input_tokens"`
	PeakOutputTokens int64 `json:"peak_output_tokens"`
	DurationSum      int64 `json:"duration_sum"`
	DurationCount    int64 `json:"duration_count"`
}

ProviderMetrics tracks metrics for a specific provider.

type Service

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

Service manages metrics collection, aggregation, and querying on the cache SQLite handle.

func New

func New(sqliteDatabase *db.Database, logger *slog.Logger) *Service

New constructs a new metrics Service on the cache SQLite handle.

func (*Service) GetDistinctModels

func (s *Service) GetDistinctModels() ([]string, error)

GetDistinctModels returns a list of unique models from metrics data: in-memory buckets plus the SQLite model dimension rows.

func (*Service) GetTokenUsage

func (s *Service) GetTokenUsage() (map[string]*TokenUsageInfo, error)

GetTokenUsage returns usage statistics for each token.

func (*Service) QueryOverview

func (s *Service) QueryOverview(filters models.MetricsFilters) (*models.MetricsOverview, error)

QueryOverview returns aggregated metrics for the specified filters.

func (*Service) QueryTimeSeries

func (s *Service) QueryTimeSeries(metric string, filters models.MetricsFilters) ([]models.TimeSeriesPoint, error)

QueryTimeSeries returns time-series data for a specific metric.

func (*Service) RecordRequest

func (s *Service) RecordRequest(event models.MetricEvent)

RecordRequest records a metric event (non-blocking).

func (*Service) Start

func (s *Service) Start()

Start begins background workers for metrics processing.

func (*Service) Stop

func (s *Service) Stop()

Stop gracefully shuts down the metrics service: workers finish, queued events drain into buckets, and all in-memory buckets flush to storage.

type TokenMetrics

type TokenMetrics struct {
	Requests         int64      `json:"requests"`
	Errors           int64      `json:"errors"`
	TokensInput      int64      `json:"tokens_input"`
	TokensOutput     int64      `json:"tokens_output"`
	PeakRequests     int64      `json:"peak_requests"`
	PeakInputTokens  int64      `json:"peak_input_tokens"`
	PeakOutputTokens int64      `json:"peak_output_tokens"`
	LastUsed         *time.Time `json:"last_used,omitempty"`
}

TokenMetrics tracks metrics for a specific token.

type TokenUsageInfo

type TokenUsageInfo struct {
	Requests int64      `json:"requests"`
	LastUsed *time.Time `json:"last_used,omitempty"`
}

TokenUsageInfo contains usage statistics for a token.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL