sdk/go/health/aggregator_test.go

   1 // Copyright (C) The Arvados Authors. All rights reserved.
   2 //
   3 // SPDX-License-Identifier: Apache-2.0
   4
   5 package health
   6
   7 import (
   8         "bytes"
   9         "crypto/sha256"
  10         "encoding/json"
  11         "fmt"
  12         "io/ioutil"
  13         "net/http"
  14         "net/http/httptest"
  15         "regexp"
  16         "strings"
  17         "time"
  18
  19         "git.arvados.org/arvados.git/lib/config"
  20         "git.arvados.org/arvados.git/sdk/go/arvados"
  21         "git.arvados.org/arvados.git/sdk/go/arvadostest"
  22         "git.arvados.org/arvados.git/sdk/go/ctxlog"
  23         "github.com/ghodss/yaml"
  24         "gopkg.in/check.v1"
  25 )
  26
  27 type AggregatorSuite struct {
  28         handler *Aggregator
  29         req     *http.Request
  30         resp    *httptest.ResponseRecorder
  31 }
  32
  33 // Gocheck boilerplate
  34 var _ = check.Suite(&AggregatorSuite{})
  35
  36 func (s *AggregatorSuite) TestInterface(c *check.C) {
  37         var _ http.Handler = &Aggregator{}
  38 }
  39
  40 func (s *AggregatorSuite) SetUpTest(c *check.C) {
  41         ldr := config.NewLoader(bytes.NewBufferString(`Clusters: {zzzzz: {}}`), ctxlog.TestLogger(c))
  42         ldr.Path = "-"
  43         cfg, err := ldr.Load()
  44         c.Assert(err, check.IsNil)
  45         cluster, err := cfg.GetCluster("")
  46         c.Assert(err, check.IsNil)
  47         cluster.ManagementToken = arvadostest.ManagementToken
  48         cluster.SystemRootToken = arvadostest.SystemRootToken
  49         cluster.Collections.BlobSigningKey = arvadostest.BlobSigningKey
  50         cluster.Volumes["z"] = arvados.Volume{StorageClasses: map[string]bool{"default": true}}
  51         s.handler = &Aggregator{Cluster: cluster}
  52         s.req = httptest.NewRequest("GET", "/_health/all", nil)
  53         s.req.Header.Set("Authorization", "Bearer "+arvadostest.ManagementToken)
  54         s.resp = httptest.NewRecorder()
  55 }
  56
  57 func (s *AggregatorSuite) TestNoAuth(c *check.C) {
  58         s.req.Header.Del("Authorization")
  59         s.handler.ServeHTTP(s.resp, s.req)
  60         s.checkError(c)
  61         c.Check(s.resp.Code, check.Equals, http.StatusUnauthorized)
  62 }
  63
  64 func (s *AggregatorSuite) TestBadAuth(c *check.C) {
  65         s.req.Header.Set("Authorization", "xyzzy")
  66         s.handler.ServeHTTP(s.resp, s.req)
  67         s.checkError(c)
  68         c.Check(s.resp.Code, check.Equals, http.StatusUnauthorized)
  69 }
  70
  71 func (s *AggregatorSuite) TestNoServicesConfigured(c *check.C) {
  72         s.handler.ServeHTTP(s.resp, s.req)
  73         s.checkUnhealthy(c)
  74 }
  75
  76 func (s *AggregatorSuite) stubServer(handler http.Handler) (*httptest.Server, string) {
  77         srv := httptest.NewServer(handler)
  78         var port string
  79         if parts := strings.Split(srv.URL, ":"); len(parts) < 3 {
  80                 panic(srv.URL)
  81         } else {
  82                 port = parts[len(parts)-1]
  83         }
  84         return srv, ":" + port
  85 }
  86
  87 func (s *AggregatorSuite) TestUnhealthy(c *check.C) {
  88         srv, listen := s.stubServer(&unhealthyHandler{})
  89         defer srv.Close()
  90         arvadostest.SetServiceURL(&s.handler.Cluster.Services.Keepstore, "http://localhost"+listen+"/")
  91         s.handler.ServeHTTP(s.resp, s.req)
  92         s.checkUnhealthy(c)
  93 }
  94
  95 func (s *AggregatorSuite) TestHealthy(c *check.C) {
  96         srv, listen := s.stubServer(&healthyHandler{})
  97         defer srv.Close()
  98         s.setAllServiceURLs(listen)
  99         s.handler.ServeHTTP(s.resp, s.req)
 100         resp := s.checkOK(c)
 101         svc := "keepstore+http://localhost" + listen + "/_health/ping"
 102         c.Logf("%#v", resp)
 103         ep := resp.Checks[svc]
 104         c.Check(ep.Health, check.Equals, "OK")
 105         c.Check(ep.HTTPStatusCode, check.Equals, 200)
 106 }
 107
 108 func (s *AggregatorSuite) TestHealthyAndUnhealthy(c *check.C) {
 109         srvH, listenH := s.stubServer(&healthyHandler{})
 110         defer srvH.Close()
 111         srvU, listenU := s.stubServer(&unhealthyHandler{})
 112         defer srvU.Close()
 113         s.setAllServiceURLs(listenH)
 114         arvadostest.SetServiceURL(&s.handler.Cluster.Services.Keepstore, "http://localhost"+listenH+"/", "http://127.0.0.1"+listenU+"/")
 115         s.handler.ServeHTTP(s.resp, s.req)
 116         resp := s.checkUnhealthy(c)
 117         ep := resp.Checks["keepstore+http://localhost"+listenH+"/_health/ping"]
 118         c.Check(ep.Health, check.Equals, "OK")
 119         c.Check(ep.HTTPStatusCode, check.Equals, 200)
 120         ep = resp.Checks["keepstore+http://127.0.0.1"+listenU+"/_health/ping"]
 121         c.Check(ep.Health, check.Equals, "ERROR")
 122         c.Check(ep.HTTPStatusCode, check.Equals, 200)
 123         c.Logf("%#v", ep)
 124 }
 125
 126 // If an InternalURL host is 0.0.0.0, localhost, 127/8, or ::1 and
 127 // nothing is listening there, don't fail the health check -- instead,
 128 // assume the relevant component just isn't installed/enabled on this
 129 // node, but does work when contacted through ExternalURL.
 130 func (s *AggregatorSuite) TestUnreachableLoopbackPort(c *check.C) {
 131         srvH, listenH := s.stubServer(&healthyHandler{})
 132         defer srvH.Close()
 133         s.setAllServiceURLs(listenH)
 134         arvadostest.SetServiceURL(&s.handler.Cluster.Services.Keepproxy, "http://localhost:9/")
 135         arvadostest.SetServiceURL(&s.handler.Cluster.Services.Workbench1, "http://0.0.0.0:9/")
 136         arvadostest.SetServiceURL(&s.handler.Cluster.Services.Keepbalance, "http://127.0.0.127:9/")
 137         arvadostest.SetServiceURL(&s.handler.Cluster.Services.WebDAV, "http://[::1]:9/")
 138         s.handler.ServeHTTP(s.resp, s.req)
 139         s.checkOK(c)
 140
 141         // If a non-loopback address is unreachable, that's still a
 142         // fail.
 143         s.resp = httptest.NewRecorder()
 144         arvadostest.SetServiceURL(&s.handler.Cluster.Services.WebDAV, "http://172.31.255.254:9/")
 145         s.handler.ServeHTTP(s.resp, s.req)
 146         s.checkUnhealthy(c)
 147 }
 148
 149 func (s *AggregatorSuite) TestIsLocalHost(c *check.C) {
 150         c.Check(isLocalHost("Localhost"), check.Equals, true)
 151         c.Check(isLocalHost("localhost"), check.Equals, true)
 152         c.Check(isLocalHost("127.0.0.1"), check.Equals, true)
 153         c.Check(isLocalHost("127.0.0.127"), check.Equals, true)
 154         c.Check(isLocalHost("127.1.2.7"), check.Equals, true)
 155         c.Check(isLocalHost("0.0.0.0"), check.Equals, true)
 156         c.Check(isLocalHost("::1"), check.Equals, true)
 157         c.Check(isLocalHost("1.2.3.4"), check.Equals, false)
 158         c.Check(isLocalHost("1::1"), check.Equals, false)
 159         c.Check(isLocalHost("example.com"), check.Equals, false)
 160         c.Check(isLocalHost("127.0.0"), check.Equals, false)
 161         c.Check(isLocalHost(""), check.Equals, false)
 162 }
 163
 164 func (s *AggregatorSuite) TestConfigMismatch(c *check.C) {
 165         // time1/hash1: current config
 166         time1 := time.Now().Add(time.Second - time.Minute - time.Hour)
 167         hash1 := fmt.Sprintf("%x", sha256.Sum256([]byte(`Clusters: {zzzzz: {SystemRootToken: xyzzy}}`)))
 168         // time2/hash2: old config
 169         time2 := time1.Add(-time.Hour)
 170         hash2 := fmt.Sprintf("%x", sha256.Sum256([]byte(`Clusters: {zzzzz: {SystemRootToken: old-token}}`)))
 171
 172         // srv1: current file
 173         handler1 := healthyHandler{configHash: hash1, configTime: time1}
 174         srv1, listen1 := s.stubServer(&handler1)
 175         defer srv1.Close()
 176         // srv2: old file, current content
 177         handler2 := healthyHandler{configHash: hash1, configTime: time2}
 178         srv2, listen2 := s.stubServer(&handler2)
 179         defer srv2.Close()
 180         // srv3: old file, old content
 181         handler3 := healthyHandler{configHash: hash2, configTime: time2}
 182         srv3, listen3 := s.stubServer(&handler3)
 183         defer srv3.Close()
 184         // srv4: no metrics handler
 185         handler4 := healthyHandler{}
 186         srv4, listen4 := s.stubServer(&handler4)
 187         defer srv4.Close()
 188
 189         s.setAllServiceURLs(listen1)
 190
 191         // listen2 => old timestamp, same content => no problem
 192         s.resp = httptest.NewRecorder()
 193         arvadostest.SetServiceURL(&s.handler.Cluster.Services.DispatchCloud,
 194                 "http://localhost"+listen2+"/")
 195         s.handler.ServeHTTP(s.resp, s.req)
 196         resp := s.checkOK(c)
 197
 198         // listen4 => no metrics on some services => no problem
 199         s.resp = httptest.NewRecorder()
 200         arvadostest.SetServiceURL(&s.handler.Cluster.Services.WebDAV,
 201                 "http://localhost"+listen4+"/")
 202         s.handler.ServeHTTP(s.resp, s.req)
 203         resp = s.checkOK(c)
 204
 205         // listen3 => old timestamp, old content => report discrepancy
 206         s.resp = httptest.NewRecorder()
 207         arvadostest.SetServiceURL(&s.handler.Cluster.Services.Keepstore,
 208                 "http://localhost"+listen1+"/",
 209                 "http://localhost"+listen3+"/")
 210         s.handler.ServeHTTP(s.resp, s.req)
 211         resp = s.checkUnhealthy(c)
 212         if c.Check(len(resp.Errors) > 0, check.Equals, true) {
 213                 c.Check(resp.Errors[0], check.Matches, `outdated config: \Qkeepstore+http://localhost`+listen3+`\E: config file \(sha256 .*\) does not match latest version with timestamp .*`)
 214         }
 215
 216         // no services report config time (migrating to current version) => no problem
 217         s.resp = httptest.NewRecorder()
 218         s.setAllServiceURLs(listen4)
 219         s.handler.ServeHTTP(s.resp, s.req)
 220         s.checkOK(c)
 221 }
 222
 223 func (s *AggregatorSuite) TestPingTimeout(c *check.C) {
 224         s.handler.timeout = arvados.Duration(100 * time.Millisecond)
 225         srv, listen := s.stubServer(&slowHandler{})
 226         defer srv.Close()
 227         arvadostest.SetServiceURL(&s.handler.Cluster.Services.Keepstore, "http://localhost"+listen+"/")
 228         s.handler.ServeHTTP(s.resp, s.req)
 229         resp := s.checkUnhealthy(c)
 230         ep := resp.Checks["keepstore+http://localhost"+listen+"/_health/ping"]
 231         c.Check(ep.Health, check.Equals, "ERROR")
 232         c.Check(ep.HTTPStatusCode, check.Equals, 0)
 233         rt, err := ep.ResponseTime.Float64()
 234         c.Check(err, check.IsNil)
 235         c.Check(rt > 0.005, check.Equals, true)
 236 }
 237
 238 func (s *AggregatorSuite) TestCheckCommand(c *check.C) {
 239         srv, listen := s.stubServer(&healthyHandler{})
 240         defer srv.Close()
 241         s.setAllServiceURLs(listen)
 242         tmpdir := c.MkDir()
 243         confdata, err := yaml.Marshal(arvados.Config{Clusters: map[string]arvados.Cluster{s.handler.Cluster.ClusterID: *s.handler.Cluster}})
 244         c.Assert(err, check.IsNil)
 245         confdata = regexp.MustCompile(`Source(Timestamp|SHA256): [^\n]+\n`).ReplaceAll(confdata, []byte{})
 246         err = ioutil.WriteFile(tmpdir+"/config.yml", confdata, 0777)
 247         c.Assert(err, check.IsNil)
 248         var stdout, stderr bytes.Buffer
 249         exitcode := CheckCommand.RunCommand("check", []string{"-config=" + tmpdir + "/config.yml"}, &bytes.Buffer{}, &stdout, &stderr)
 250         c.Check(exitcode, check.Equals, 0)
 251         c.Check(stderr.String(), check.Equals, "")
 252         c.Check(stdout.String(), check.Matches, `(?ms).*(\n|^)health: OK\n.*`)
 253 }
 254
 255 func (s *AggregatorSuite) checkError(c *check.C) {
 256         c.Check(s.resp.Code, check.Not(check.Equals), http.StatusOK)
 257         var resp ClusterHealthResponse
 258         err := json.Unmarshal(s.resp.Body.Bytes(), &resp)
 259         c.Check(err, check.IsNil)
 260         c.Check(resp.Health, check.Not(check.Equals), "OK")
 261 }
 262
 263 func (s *AggregatorSuite) checkUnhealthy(c *check.C) ClusterHealthResponse {
 264         return s.checkResult(c, "ERROR")
 265 }
 266
 267 func (s *AggregatorSuite) checkOK(c *check.C) ClusterHealthResponse {
 268         return s.checkResult(c, "OK")
 269 }
 270
 271 func (s *AggregatorSuite) checkResult(c *check.C, health string) ClusterHealthResponse {
 272         c.Check(s.resp.Code, check.Equals, http.StatusOK)
 273         var resp ClusterHealthResponse
 274         c.Log(s.resp.Body.String())
 275         err := json.Unmarshal(s.resp.Body.Bytes(), &resp)
 276         c.Check(err, check.IsNil)
 277         c.Check(resp.Health, check.Equals, health)
 278         return resp
 279 }
 280
 281 func (s *AggregatorSuite) setAllServiceURLs(listen string) {
 282         svcs := &s.handler.Cluster.Services
 283         for _, svc := range []*arvados.Service{
 284                 &svcs.Controller,
 285                 &svcs.DispatchCloud,
 286                 &svcs.DispatchLSF,
 287                 &svcs.Keepbalance,
 288                 &svcs.Keepproxy,
 289                 &svcs.Keepstore,
 290                 &svcs.Health,
 291                 &svcs.RailsAPI,
 292                 &svcs.WebDAV,
 293                 &svcs.Websocket,
 294                 &svcs.Workbench1,
 295                 &svcs.Workbench2,
 296         } {
 297                 arvadostest.SetServiceURL(svc, "http://localhost"+listen+"/")
 298         }
 299 }
 300
 301 type unhealthyHandler struct{}
 302
 303 func (*unhealthyHandler) ServeHTTP(resp http.ResponseWriter, req *http.Request) {
 304         if req.URL.Path == "/_health/ping" {
 305                 resp.Write([]byte(`{"health":"ERROR","error":"the bends"}`))
 306         } else {
 307                 http.Error(resp, "not found", http.StatusNotFound)
 308         }
 309 }
 310
 311 type healthyHandler struct {
 312         configHash string
 313         configTime time.Time
 314 }
 315
 316 func (h *healthyHandler) ServeHTTP(resp http.ResponseWriter, req *http.Request) {
 317         authOK := req.Header.Get("Authorization") == "Bearer "+arvadostest.ManagementToken
 318         if req.URL.Path == "/_health/ping" {
 319                 if !authOK {
 320                         http.Error(resp, "unauthorized", http.StatusUnauthorized)
 321                         return
 322                 }
 323                 resp.Write([]byte(`{"health":"OK"}`))
 324         } else if req.URL.Path == "/metrics" {
 325                 if !authOK {
 326                         http.Error(resp, "unauthorized", http.StatusUnauthorized)
 327                         return
 328                 }
 329                 t := h.configTime
 330                 if t.IsZero() {
 331                         t = time.Now()
 332                 }
 333                 fmt.Fprintf(resp, `# HELP arvados_config_load_timestamp_seconds Time when config file was loaded.
 334 # TYPE arvados_config_load_timestamp_seconds gauge
 335 arvados_config_load_timestamp_seconds{sha256="%s"} %g
 336 # HELP arvados_config_source_timestamp_seconds Timestamp of config file when it was loaded.
 337 # TYPE arvados_config_source_timestamp_seconds gauge
 338 arvados_config_source_timestamp_seconds{sha256="%s"} %g
 339 `,
 340                         h.configHash, float64(time.Now().UnixNano())/1e9,
 341                         h.configHash, float64(t.UnixNano())/1e9)
 342         } else {
 343                 http.Error(resp, "not found", http.StatusNotFound)
 344         }
 345 }
 346
 347 type slowHandler struct{}
 348
 349 func (*slowHandler) ServeHTTP(resp http.ResponseWriter, req *http.Request) {
 350         if req.URL.Path == "/_health/ping" {
 351                 time.Sleep(3 * time.Second)
 352                 resp.Write([]byte(`{"health":"OK"}`))
 353         } else {
 354                 http.Error(resp, "not found", http.StatusNotFound)
 355         }
 356 }