traefik/healthcheck/healthcheck.go

213 lines
5.8 KiB
Go
Raw Normal View History

2016-11-26 18:48:49 +00:00
package healthcheck
import (
"context"
"fmt"
"net"
2016-11-26 18:48:49 +00:00
"net/http"
"net/url"
"strconv"
2016-11-26 18:48:49 +00:00
"sync"
"time"
2017-01-31 21:55:02 +00:00
"github.com/containous/traefik/log"
"github.com/containous/traefik/safe"
"github.com/go-kit/kit/metrics"
2017-01-31 21:55:02 +00:00
"github.com/vulcand/oxy/roundrobin"
2016-11-26 18:48:49 +00:00
)
var singleton *HealthCheck
var once sync.Once
2018-06-11 09:36:03 +00:00
// BalancerHandler includes functionality for load-balancing management.
type BalancerHandler interface {
ServeHTTP(w http.ResponseWriter, req *http.Request)
Servers() []*url.URL
RemoveServer(u *url.URL) error
UpsertServer(u *url.URL, options ...roundrobin.ServerOption) error
}
// metricsRegistry is a local interface in the health check package, exposing only the required metrics
// necessary for the health check package. This makes it easier for the tests.
type metricsRegistry interface {
BackendServerUpGauge() metrics.Gauge
2016-11-26 18:48:49 +00:00
}
// Options are the public health check options.
type Options struct {
2018-04-16 09:40:03 +00:00
Headers map[string]string
Hostname string
2018-05-14 10:08:03 +00:00
Scheme string
2017-11-21 10:06:03 +00:00
Path string
Port int
Transport http.RoundTripper
Interval time.Duration
2018-06-11 09:36:03 +00:00
LB BalancerHandler
}
func (opt Options) String() string {
2018-04-16 09:40:03 +00:00
return fmt.Sprintf("[Hostname: %s Headers: %v Path: %s Port: %d Interval: %s]", opt.Hostname, opt.Headers, opt.Path, opt.Port, opt.Interval)
}
2018-06-11 09:36:03 +00:00
// BackendConfig HealthCheck configuration for a backend
type BackendConfig struct {
Options
name string
disabledURLs []*url.URL
requestTimeout time.Duration
2016-11-26 18:48:49 +00:00
}
2018-06-11 09:36:03 +00:00
func (b *BackendConfig) newRequest(serverURL *url.URL) (*http.Request, error) {
u := &url.URL{}
*u = *serverURL
2016-11-26 18:48:49 +00:00
2018-06-11 09:36:03 +00:00
if len(b.Scheme) > 0 {
u.Scheme = b.Scheme
}
2016-11-26 18:48:49 +00:00
2018-06-11 09:36:03 +00:00
if b.Port != 0 {
u.Host = net.JoinHostPort(u.Hostname(), strconv.Itoa(b.Port))
}
2016-11-26 18:48:49 +00:00
2018-06-11 09:36:03 +00:00
u.Path += b.Path
return http.NewRequest(http.MethodGet, u.String(), nil)
}
2018-06-11 09:36:03 +00:00
// this function adds additional http headers and hostname to http.request
func (b *BackendConfig) addHeadersAndHost(req *http.Request) *http.Request {
if b.Options.Hostname != "" {
req.Host = b.Options.Hostname
}
for k, v := range b.Options.Headers {
req.Header.Set(k, v)
}
2018-06-11 09:36:03 +00:00
return req
}
// HealthCheck struct
type HealthCheck struct {
Backends map[string]*BackendConfig
metrics metricsRegistry
cancel context.CancelFunc
2016-11-26 18:48:49 +00:00
}
2018-04-16 09:40:03 +00:00
// SetBackendsConfiguration set backends configuration
2018-06-11 09:36:03 +00:00
func (hc *HealthCheck) SetBackendsConfiguration(parentCtx context.Context, backends map[string]*BackendConfig) {
2016-11-26 18:48:49 +00:00
hc.Backends = backends
if hc.cancel != nil {
hc.cancel()
}
2017-01-31 21:55:02 +00:00
ctx, cancel := context.WithCancel(parentCtx)
hc.cancel = cancel
2016-11-26 18:48:49 +00:00
2018-01-15 16:27:37 +00:00
for _, backend := range backends {
currentBackend := backend
2017-01-31 21:55:02 +00:00
safe.Go(func() {
hc.execute(ctx, currentBackend)
2017-01-31 21:55:02 +00:00
})
}
2016-11-26 18:48:49 +00:00
}
2018-06-11 09:36:03 +00:00
func (hc *HealthCheck) execute(ctx context.Context, backend *BackendConfig) {
log.Debugf("Initial health check for backend: %q", backend.name)
hc.checkBackend(backend)
ticker := time.NewTicker(backend.Interval)
defer ticker.Stop()
for {
select {
case <-ctx.Done():
2018-09-07 07:40:03 +00:00
log.Debugf("Stopping current health check goroutines of backend: %s", backend.name)
return
case <-ticker.C:
log.Debugf("Refreshing health check for backend: %s", backend.name)
hc.checkBackend(backend)
}
}
}
2018-06-11 09:36:03 +00:00
func (hc *HealthCheck) checkBackend(backend *BackendConfig) {
enabledURLs := backend.LB.Servers()
var newDisabledURLs []*url.URL
for _, url := range backend.disabledURLs {
serverUpMetricValue := float64(0)
if err := checkHealth(url, backend); err == nil {
log.Warnf("Health check up: Returning to server list. Backend: %q URL: %q", backend.name, url.String())
backend.LB.UpsertServer(url, roundrobin.Weight(1))
serverUpMetricValue = 1
} else {
log.Warnf("Health check still failing. Backend: %q URL: %q Reason: %s", backend.name, url.String(), err)
newDisabledURLs = append(newDisabledURLs, url)
}
labelValues := []string{"backend", backend.name, "url", url.String()}
hc.metrics.BackendServerUpGauge().With(labelValues...).Set(serverUpMetricValue)
}
backend.disabledURLs = newDisabledURLs
for _, url := range enabledURLs {
serverUpMetricValue := float64(1)
if err := checkHealth(url, backend); err != nil {
log.Warnf("Health check failed: Remove from server list. Backend: %q URL: %q Reason: %s", backend.name, url.String(), err)
backend.LB.RemoveServer(url)
backend.disabledURLs = append(backend.disabledURLs, url)
serverUpMetricValue = 0
}
labelValues := []string{"backend", backend.name, "url", url.String()}
hc.metrics.BackendServerUpGauge().With(labelValues...).Set(serverUpMetricValue)
}
}
2018-06-11 09:36:03 +00:00
// GetHealthCheck returns the health check which is guaranteed to be a singleton.
func GetHealthCheck(metrics metricsRegistry) *HealthCheck {
once.Do(func() {
singleton = newHealthCheck(metrics)
})
return singleton
}
2018-06-11 09:36:03 +00:00
func newHealthCheck(metrics metricsRegistry) *HealthCheck {
return &HealthCheck{
Backends: make(map[string]*BackendConfig),
metrics: metrics,
2018-04-16 09:40:03 +00:00
}
2018-06-11 09:36:03 +00:00
}
2018-06-11 09:36:03 +00:00
// NewBackendConfig Instantiate a new BackendConfig
func NewBackendConfig(options Options, backendName string) *BackendConfig {
return &BackendConfig{
Options: options,
name: backendName,
requestTimeout: 5 * time.Second,
2018-04-16 09:40:03 +00:00
}
}
// checkHealth returns a nil error in case it was successful and otherwise
// a non-nil error with a meaningful description why the health check failed.
2018-06-11 09:36:03 +00:00
func checkHealth(serverURL *url.URL, backend *BackendConfig) error {
req, err := backend.newRequest(serverURL)
if err != nil {
return fmt.Errorf("failed to create HTTP request: %s", err)
}
2018-04-16 09:40:03 +00:00
req = backend.addHeadersAndHost(req)
client := http.Client{
Timeout: backend.requestTimeout,
Transport: backend.Options.Transport,
2016-11-26 18:48:49 +00:00
}
resp, err := client.Do(req)
if err != nil {
return fmt.Errorf("HTTP request failed: %s", err)
}
defer resp.Body.Close()
if resp.StatusCode < http.StatusOK || resp.StatusCode >= http.StatusBadRequest {
return fmt.Errorf("received error status code: %v", resp.StatusCode)
}
return nil
2016-11-26 18:48:49 +00:00
}