metrics.md

metrics package

Production counters and timings for tokenizer and parser operations.

Import path: github.com/ajitpratap0/GoSQLX/pkg/metrics (pkg.go.dev)

Part of the GoSQLX API reference.

Configuration

Enable()

Enable metrics collection.

metrics.Enable()

Disable()

Disable metrics collection.

IsEnabled() bool

Check if enabled.

Reset()

Reset all metrics.

Recording Functions

RecordTokenization(querySize int, tokenCount int)

Record tokenization metrics.

RecordParsing(success bool, duration time.Duration)

Record parsing metrics.

RecordPoolGet(poolName string)

Record pool get operation.

RecordPoolPut(poolName string)

Record pool put operation.

RecordPoolHit(poolName string)

Record pool cache hit.

RecordPoolMiss(poolName string)

Record pool cache miss.

RecordError(errType string)

Record error occurrence.

Query Functions

GetSnapshot() MetricsSnapshot

Get current metrics snapshot.

snapshot := metrics.GetSnapshot()
fmt.Printf("Total queries: %d\n", snapshot.TotalQueries)
fmt.Printf("Success rate: %.2f%%\n", snapshot.SuccessRate)

MetricsSnapshot

type MetricsSnapshot struct {
    TotalQueries      int64
    SuccessfulQueries int64
    FailedQueries     int64
    SuccessRate       float64
    TotalTokens       int64
    AvgTokensPerQuery float64
    PoolStats         map[string]PoolStats
    ErrorCounts       map[string]int64
}

PoolStats

type PoolStats struct {
    Gets    int64
    Puts    int64
    Hits    int64
    Misses  int64
    HitRate float64
}

Enhancements:

• Parser operation metrics (duration, errors, statement counts)
• AST pool metrics (gets/puts/balance)
• Statement pool metrics
• Expression pool metrics
• Tokenizer pool metrics with hit rate tracking
• Thread-safe atomic counters