health

Documentation

Index

• type APIHealthArgs
• type APIHealthClientReply
• type APIHealthServerReply
• type Client
  • func NewClient(uri string, requestTimeout time.Duration) Client
• type ErrorMsg
• type Result
• type Service
  • func NewNoOpService() Service
  • func NewService(checkFreq time.Duration, log logging.Logger, namespace string, ...) (Service, error)

Types

type APIHealthArgs

type APIHealthArgs struct{}

APIHealthArgs are the arguments for Health

type APIHealthClientReply

type APIHealthClientReply struct {
	Checks  map[string]Result `json:"checks"`
	Healthy bool              `json:"healthy"`
}

type APIHealthServerReply

type APIHealthServerReply struct {
	Checks  map[string]health.Result `json:"checks"`
	Healthy bool                     `json:"healthy"`
}

APIHealthReply is the response for Health

type Client

type Client interface {
	// Health returns a health check on the Avalanche node
	Health() (*APIHealthClientReply, error)
	// AwaitHealthy queries the Health endpoint [checks] times, with a pause of
	// [interval] in between checks and returns early if Health returns healthy
	AwaitHealthy(numChecks int, freq time.Duration) (bool, error)
}

Client interface for Avalanche Health API Endpoint

func NewClient

func NewClient(uri string, requestTimeout time.Duration) Client

NewClient returns a client to interact with Health API endpoint

type ErrorMsg

type ErrorMsg struct {
	Message string `json:"message"`
}

type Result

type Result struct {
	// the details of task Result - may be nil
	Details interface{} `json:"message,omitempty"`
	// the error returned from a failed health check - an empty string when successful
	Error ErrorMsg `json:"error,omitempty"`
	// the time of the last health check
	Timestamp time.Time `json:"timestamp"`
	// the execution duration of the last check
	Duration time.Duration `json:"duration,omitempty"`
	// the number of failures that occurred in a row
	ContiguousFailures int64 `json:"contiguousFailures"`
	// the time of the initial transitional failure
	TimeOfFirstFailure *time.Time `json:"timeOfFirstFailure"`
}

Result represents the output of a health check execution.

type Service

type Service interface {
	healthlib.Service
	Handler() (*common.HTTPHandler, error)
}

Service wraps a healthlib.Service. Handler() returns a handler that handles incoming HTTP API requests. We have this in a separate package from healthlib to avoid a circular import where this service imports snow/engine/common but that package imports healthlib.Checkable

func NewNoOpService

func NewNoOpService() Service

NewNoOpService returns a NoOp version of health check for when the Health API is disabled

func NewService

func NewService(checkFreq time.Duration, log logging.Logger, namespace string, registry prometheus.Registerer) (Service, error)