health

Documentation

Index

• func CheckContext(ctx context.Context) context.Context
• func IsCheck(ctx context.Context) bool
• func WaitForTestDial(ctx context.Context, addr net.Addr)
• type Checkable
• type Checker
• type Config
• type Details
• type ServableChecker
  • func NewChecker(config Config, log logrus.FieldLogger) ServableChecker
• type State

Functions

func CheckContext

func CheckContext(ctx context.Context) context.Context

func IsCheck

func IsCheck(ctx context.Context) bool

func WaitForTestDial

func WaitForTestDial(ctx context.Context, addr net.Addr)

WaitForTestDial tries to create a client connection to the given target with a blocking dial and a timeout specified in testDialTimeout. Nothing is done with the connection, which is just closed in case it is created.

Types

type Checkable

type Checkable interface {
	CheckHealth() State
}

Checkable is the interface implemented by subsystems that the checker uses to determine subsystem health.

type Checker

type Checker interface {
	AddCheck(name string, checkable Checkable) error
}

Checker is responsible for running health checks and serving the healthcheck HTTP paths

type Config

type Config struct {
	ListenerEnabled bool `hcl:"listener_enabled"`

	// Address and port to listen on, defaulting to localhost:80
	BindAddress string `hcl:"bind_address"`
	BindPort    string `hcl:"bind_port"`

	// Paths for /ready and /live
	ReadyPath string `hcl:"ready_path"`
	LivePath  string `hcl:"live_path"`

	UnusedKeyPositions map[string][]token.Pos `hcl:",unusedKeyPositions"`
}

type Details

type Details struct {
	Message string `json:"message,omitempty"`
}

Details are additional data to be used when the system is ready

type ServableChecker

type ServableChecker interface {
	Checker
	ListenAndServe(ctx context.Context) error
}

func NewChecker

func NewChecker(config Config, log logrus.FieldLogger) ServableChecker

type State

type State struct {
	// Live is whether the subsystem is live (i.e. in a good state
	// or in a state it can recover from while remaining alive). Global
	// liveness is only reported true if all subsystems report live.
	Live bool

	// Ready is whether the subsystem is ready (i.e. ready to perform
	// its function). Global readiness is only reported true if all subsystems
	// report ready.
	Ready bool

	// Subsystems can return whatever details they want here as long as it is
	// serializable via json.Marshal.
	// LiveDetails are opaque details related to the live check.
	LiveDetails any

	// ReadyDetails are opaque details related to the live check.
	ReadyDetails any
}

State is the health state of a subsystem.