Help us shape the future of Go! Take the 2026 Go Developer Survey

Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

gnomon

package module

Go to main page

Versions in this module

v0

v0.5.0

Aug 5, 2026

v0.4.0

Jun 21, 2026

Changes in this version

type Chart

+ const Funnel

+ type Measure struct

+ Label string

+ Name string

+ Unit Unit

type Metric

+ Dimension string

+ Measures []Measure

v0.3.0

Jun 19, 2026

v0.2.0

Jun 19, 2026

v0.1.2

Jun 19, 2026

v0.1.1

Jun 19, 2026

Changes in this version

+ var ErrUnknownMetric = errors.New("gnomon: unknown metric")

+ var ErrWrongKind = errors.New("gnomon: wrong metric kind")

v0.1.0

Jun 19, 2026

Changes in this version

+ type Chart int

+ const Bar

+ const Line

+ const Stat

+ type DataSource interface

+ Query func(ctx context.Context, sql string) ([]Row, error)

+ type Gnomon struct

+ func New(data DataSource, store Store) *Gnomon

+ func (g *Gnomon) Capture(ctx context.Context, on time.Time) error

+ func (g *Gnomon) Metrics() []Metric

+ func (g *Gnomon) Query(ctx context.Context, name string) ([]Row, error)

+ func (g *Gnomon) Register(ms ...Metric) error

+ func (g *Gnomon) Series(ctx context.Context, name string, from, to time.Time) ([]Point, error)

+ type Kind int

+ const ReadThrough

+ const Snapshot

+ type Metric struct

+ Chart Chart

+ Kind Kind

+ Name string

+ SQL string

+ Title string

+ Unit Unit

+ type Point struct

+ CapturedOn time.Time

+ Dimension string

+ Value float64

+ type Row map[string]any

+ type Sample struct

+ Dimension string

+ Value float64

+ type Store interface

+ ReadSeries func(ctx context.Context, metric string, from, to time.Time) ([]Point, error)

+ UpsertSnapshots func(ctx context.Context, on time.Time, metric string, samples []Sample) error

+ type Unit int

+ const Cents

+ const Count

+ const Percent