package module
Version: v0.0.0-...-43a291a Latest Latest

This package is not in the latest version of its module.

Go to latest
Published: Jan 16, 2019 License: MIT Imports: 6 Imported by: 69


Getting Started

Install the handler

We first need to serve the probing HTTP handler.

    http.HandleFunc("/health", probing.NewHandler())
    err := http.ListenAndServe(":12345", nil)
	if err != nil {
		log.Fatal("ListenAndServe: ", err)

Start to probe

Now we can start to probe the endpoint.

    id := "example"
    probingInterval = 5 * time.Second
    url := ""
    p.AddHTTP(id, probingInterval, url)

	time.Sleep(13 * time.Second)
	status, err := p.Status(id)
 	fmt.Printf("Total Probing: %d, Total Loss: %d, Estimated RTT: %v, Estimated Clock Difference: %v\n",
		status.Total(), status.Loss(), status.SRTT(), status.ClockDiff())
	// Total Probing: 2, Total Loss: 0, Estimated RTT: 320.771µs, Estimated Clock Difference: -35.869µs


  • TCP probing
  • UDP probing
  • Gossip based probing
  • More accurate RTT estimation
  • More accurate Clock difference estimation
  • Use a clock interface rather than the real clock




This section is empty.


View Source
var (
	ErrNotFound = errors.New("probing: id not found")
	ErrExist    = errors.New("probing: id exists")


func NewHandler

func NewHandler() http.Handler


type Health

type Health struct {
	OK  bool
	Now time.Time

type Prober

type Prober interface {
	AddHTTP(id string, probingInterval time.Duration, endpoints []string) error
	Remove(id string) error
	Reset(id string) error
	Status(id string) (Status, error)

func NewProber

func NewProber(tr http.RoundTripper) Prober

type Status

type Status interface {
	Total() int64
	Loss() int64
	Health() bool
	Err() error
	// Estimated smoothed round trip time
	SRTT() time.Duration
	// Estimated clock difference
	ClockDiff() time.Duration
	StopNotify() <-chan struct{}

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL