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
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

service

package module

Go to main page

Versions in this module

v0

v0.3.1

Jul 17, 2025

v0.3.0

Jul 17, 2025

Changes in this version

type Service

+ func (s *Service) TestServer() *httptest.Server

v0.2.0

Jul 12, 2025

Changes in this version

+ func AddCounter(r *http.Request, name string, value float64, labels ...string) error

+ func AddGauge(r *http.Request, name string, value float64, labels ...string) error

+ func DecGauge(r *http.Request, name string, labels ...string) error

+ func IncGauge(r *http.Request, name string, labels ...string) error

+ func ObserveSummary(r *http.Request, name string, value float64, labels ...string) error

+ func SetGauge(r *http.Request, name string, value float64, labels ...string) error

type Config

+ HealthPath string

+ LivenessPath string

+ ReadinessPath string

+ Version string

type ContextKey

+ const HealthCheckerKey

+ type HealthChecker struct

+ func GetHealthChecker(r *http.Request) *HealthChecker

+ func NewHealthChecker(serviceName, version string) (*HealthChecker, error)

+ func (hc *HealthChecker) Handler() http.Handler

+ func (hc *HealthChecker) HandlerFunc(w http.ResponseWriter, r *http.Request)

+ func (hc *HealthChecker) IsAlive(ctx context.Context) bool

+ func (hc *HealthChecker) IsHealthy(ctx context.Context) bool

+ func (hc *HealthChecker) IsReady(ctx context.Context) bool

+ func (hc *HealthChecker) LivenessHandler() http.HandlerFunc

+ func (hc *HealthChecker) Measure(ctx context.Context) health.Check

+ func (hc *HealthChecker) ReadinessHandler() http.HandlerFunc

+ func (hc *HealthChecker) Register(config health.Config) error

+ type MetricConfig struct

+ Buckets []float64

+ Help string

+ Labels []string

+ Name string

+ Objectives map[float64]float64

type MetricsCollector

+ func (mc *MetricsCollector) AddCounter(name string, value float64, labels ...string) error

+ func (mc *MetricsCollector) AddGauge(name string, value float64, labels ...string) error

+ func (mc *MetricsCollector) DecGauge(name string, labels ...string) error

+ func (mc *MetricsCollector) GetRegistry() *prometheus.Registry

+ func (mc *MetricsCollector) IncCounter(name string, labels ...string) error

+ func (mc *MetricsCollector) IncGauge(name string, labels ...string) error

+ func (mc *MetricsCollector) ObserveHistogram(name string, value float64, labels ...string) error

+ func (mc *MetricsCollector) ObserveSummary(name string, value float64, labels ...string) error

+ func (mc *MetricsCollector) RegisterCounter(config MetricConfig) error

+ func (mc *MetricsCollector) RegisterGauge(config MetricConfig) error

+ func (mc *MetricsCollector) RegisterHistogram(config MetricConfig) error

+ func (mc *MetricsCollector) RegisterSummary(config MetricConfig) error

+ func (mc *MetricsCollector) SetGauge(name string, value float64, labels ...string) error

type Middleware

+ func HealthCheckerMiddleware(healthChecker *HealthChecker) Middleware

type Service

+ HealthChecker *HealthChecker

+ func (s *Service) GetHealthChecker() *HealthChecker

+ func (s *Service) RegisterCounter(config MetricConfig) error

+ func (s *Service) RegisterGauge(config MetricConfig) error

+ func (s *Service) RegisterHealthCheck(config health.Config) error

+ func (s *Service) RegisterHistogram(config MetricConfig) error

+ func (s *Service) RegisterSummary(config MetricConfig) error

v0.1.0

Jul 11, 2025

Changes in this version

+ func GetLogger(r *http.Request) *slog.Logger

+ func IncCounter(r *http.Request, name string, labels ...string)

+ func ObserveHistogram(r *http.Request, name string, value float64, labels ...string)

+ type Config struct

+ Addr string

+ IdleTimeout time.Duration

+ Logger *slog.Logger

+ MetricsAddr string

+ MetricsPath string

+ ReadTimeout time.Duration

+ ShutdownHooks []func() error

+ ShutdownTimeout time.Duration

+ WriteTimeout time.Duration

+ func DefaultConfig() *Config

+ func LoadFromEnv() (*Config, error)

+ func (c *Config) AddShutdownHook(hook func() error)

+ type ContextKey string

+ const LoggerKey

+ const MetricsKey

+ type MetricsCollector struct

+