health

Documentation

Overview

Package health is a registry for other packages to report & check overall health status of the node.

Index

• Constants
• Variables
• func DNSHealth() error
• func GotStreamedMapResponse()
• func NetworkCategoryHealth() error
• func NoteDERPRegionReceivedFrame(region int)
• func NoteMapRequestHeard(mr *tailcfg.MapRequest)
• func RegisterWatcher(cb func(key Subsystem, err error)) (unregister func())
• func RouterHealth() error
• func SetAnyInterfaceUp(up bool)
• func SetDERPRegionConnectedState(region int, connected bool)
• func SetDNSHealth(err error)
• func SetIPNState(state string, wantRunning bool)
• func SetInPollNetMap(v bool)
• func SetMagicSockDERPHome(region int)
• func SetNetworkCategoryHealth(err error)
• func SetRouterHealth(err error)
• func SetUDP4Unbound(unbound bool)
• type ReceiveFuncStats
  • func (s *ReceiveFuncStats) Enter()
  • func (s *ReceiveFuncStats) Exit()
• type Subsystem

Constants

const (
	// SysOverall is the name representing the overall health of
	// the system, rather than one particular subsystem.
	SysOverall = Subsystem("overall")

	// SysRouter is the name of the wgengine/router subsystem.
	SysRouter = Subsystem("router")

	// SysDNS is the name of the net/dns subsystem.
	SysDNS = Subsystem("dns")

	// SysNetworkCategory is the name of the subsystem that sets
	// the Windows network adapter's "category" (public, private, domain).
	// If it's unhealthy, the Windows firewall rules won't match.
	SysNetworkCategory = Subsystem("network-category")
)

Variables

var (
	ReceiveIPv4 = ReceiveFuncStats{/* contains filtered or unexported fields */}
	ReceiveIPv6 = ReceiveFuncStats{/* contains filtered or unexported fields */}
	ReceiveDERP = ReceiveFuncStats{/* contains filtered or unexported fields */}
)

Functions

func DNSHealth

func DNSHealth() error

DNSHealth returns the net/dns.Manager error state.

func GotStreamedMapResponse

func GotStreamedMapResponse()

GotStreamedMapResponse notes that we got a tailcfg.MapResponse message in streaming mode, even if it's just a keep-alive message.

func NetworkCategoryHealth

func NetworkCategoryHealth() error

func NoteDERPRegionReceivedFrame

func NoteDERPRegionReceivedFrame(region int)

func NoteMapRequestHeard

func NoteMapRequestHeard(mr *tailcfg.MapRequest)

NoteMapRequestHeard notes whenever we successfully sent a map request to control for which we received a 200 response.

func RegisterWatcher

func RegisterWatcher(cb func(key Subsystem, err error)) (unregister func())

RegisterWatcher adds a function that will be called if an error changes state either to unhealthy or from unhealthy. It is not called on transition from unknown to healthy. It must be non-nil and is run in its own goroutine. The returned func unregisters it.

func RouterHealth

func RouterHealth() error

RouterHealth returns the wgengine/router.Router error state.

func SetAnyInterfaceUp

func SetAnyInterfaceUp(up bool)

SetAnyInterfaceUp sets whether any network interface is up.

func SetDERPRegionConnectedState

func SetDERPRegionConnectedState(region int, connected bool)

func SetDNSHealth

func SetDNSHealth(err error)

SetDNSHealth sets the state of the net/dns.Manager

func SetIPNState

func SetIPNState(state string, wantRunning bool)

state is an ipn.State.String() value: "Running", "Stopped", "NeedsLogin", etc.

func SetInPollNetMap

func SetInPollNetMap(v bool)

SetInPollNetMap records that we're in

func SetMagicSockDERPHome

func SetMagicSockDERPHome(region int)

SetMagicSockDERPHome notes what magicsock's view of its home DERP is.

func SetNetworkCategoryHealth

func SetNetworkCategoryHealth(err error)

SetNetworkCategoryHealth sets the state of setting the network adaptor's category. This only applies on Windows.

func SetRouterHealth

func SetRouterHealth(err error)

SetRouterHealth sets the state of the wgengine/router.Router.

func SetUDP4Unbound

func SetUDP4Unbound(unbound bool)

SetUDP4Unbound sets whether the udp4 bind failed completely.

Types

type ReceiveFuncStats

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

ReceiveFuncStats tracks the calls made to a wireguard-go receive func.

func (*ReceiveFuncStats) Enter

func (s *ReceiveFuncStats) Enter()

func (*ReceiveFuncStats) Exit

func (s *ReceiveFuncStats) Exit()

type Subsystem

type Subsystem string

Subsystem is the name of a subsystem whose health can be monitored.