httpserver

Documentation

Overview

Package httpserver contains helpers for creating zero-downtime REST APIs.

There are tools for: - observability (both for requests and connection info) - health checks

Index

• type HTTPServer
  • func Load(ctx context.Context, name, addr string, handler http.Handler, ...) (*HTTPServer, error)
  • func New(ctx context.Context, name, addr string, handler http.Handler) (s *HTTPServer, err error)
  • func (s HTTPServer) Addr() string
  • func (s *HTTPServer) MetricsProducer() MetricProducer
  • func (s *HTTPServer) Serve(ctx context.Context) error
• type MetricProducer

Types

type HTTPServer

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

func Load

func Load(ctx context.Context, name, addr string, handler http.Handler, sys *system.System) (*HTTPServer, error)

func New

func New(ctx context.Context, name, addr string, handler http.Handler) (s *HTTPServer, err error)

func (HTTPServer) Addr

func (s HTTPServer) Addr() string

func (*HTTPServer) MetricsProducer

func (s *HTTPServer) MetricsProducer() MetricProducer

func (*HTTPServer) Serve

func (s *HTTPServer) Serve(ctx context.Context) error

Serve the http server. On context cancellation the server is shutdown giving some time for the in flight requests to be handled.

type MetricProducer

type MetricProducer interface {
	// MetricName The name for this group of metrics
	//(Name might be cleaner, but is much more likely to conflict in implementations)
	MetricName() string
	// Gauges are instantaneous name value pairs
	Gauges(context.Context) map[string]float64
}