peer_server.go 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844
  1. package server
  2. import (
  3. "encoding/json"
  4. "fmt"
  5. "math/rand"
  6. "net/http"
  7. "net/url"
  8. "sort"
  9. "strings"
  10. "sync"
  11. "time"
  12. "github.com/coreos/etcd/third_party/github.com/goraft/raft"
  13. "github.com/coreos/etcd/third_party/github.com/gorilla/mux"
  14. "github.com/coreos/etcd/discovery"
  15. etcdErr "github.com/coreos/etcd/error"
  16. "github.com/coreos/etcd/log"
  17. "github.com/coreos/etcd/metrics"
  18. "github.com/coreos/etcd/pkg/btrfs"
  19. "github.com/coreos/etcd/store"
  20. )
  21. const (
  22. // ThresholdMonitorTimeout is the time between log notifications that the
  23. // Raft heartbeat is too close to the election timeout.
  24. ThresholdMonitorTimeout = 5 * time.Second
  25. // ActiveMonitorTimeout is the time between checks on the active size of
  26. // the cluster. If the active size is bigger than the actual size then
  27. // etcd attempts to demote to bring it to the correct number.
  28. ActiveMonitorTimeout = 1 * time.Second
  29. // PeerActivityMonitorTimeout is the time between checks for dead nodes in
  30. // the cluster.
  31. PeerActivityMonitorTimeout = 1 * time.Second
  32. // The location of cluster config in key space.
  33. ClusterConfigKey = "/_etcd/config"
  34. )
  35. type PeerServerConfig struct {
  36. Name string
  37. Scheme string
  38. URL string
  39. SnapshotCount int
  40. RetryTimes int
  41. RetryInterval float64
  42. }
  43. type PeerServer struct {
  44. Config PeerServerConfig
  45. client *Client
  46. raftServer raft.Server
  47. server *Server
  48. followersStats *raftFollowersStats
  49. serverStats *raftServerStats
  50. registry *Registry
  51. store store.Store
  52. snapConf *snapshotConf
  53. joinIndex uint64
  54. isNewCluster bool
  55. removedInLog bool
  56. removeNotify chan bool
  57. started bool
  58. closeChan chan bool
  59. routineGroup sync.WaitGroup
  60. timeoutThresholdChan chan interface{}
  61. metrics *metrics.Bucket
  62. sync.Mutex
  63. }
  64. // TODO: find a good policy to do snapshot
  65. type snapshotConf struct {
  66. // Etcd will check if snapshot is need every checkingInterval
  67. checkingInterval time.Duration
  68. // The index when the last snapshot happened
  69. lastIndex uint64
  70. // If the incremental number of index since the last snapshot
  71. // exceeds the snapshot Threshold, etcd will do a snapshot
  72. snapshotThr uint64
  73. }
  74. func NewPeerServer(psConfig PeerServerConfig, client *Client, registry *Registry, store store.Store, mb *metrics.Bucket, followersStats *raftFollowersStats, serverStats *raftServerStats) *PeerServer {
  75. s := &PeerServer{
  76. Config: psConfig,
  77. client: client,
  78. registry: registry,
  79. store: store,
  80. followersStats: followersStats,
  81. serverStats: serverStats,
  82. timeoutThresholdChan: make(chan interface{}, 1),
  83. metrics: mb,
  84. }
  85. return s
  86. }
  87. func (s *PeerServer) SetRaftServer(raftServer raft.Server, snapshot bool) {
  88. s.snapConf = &snapshotConf{
  89. checkingInterval: time.Second * 3,
  90. // this is not accurate, we will update raft to provide an api
  91. lastIndex: raftServer.CommitIndex(),
  92. snapshotThr: uint64(s.Config.SnapshotCount),
  93. }
  94. raftServer.AddEventListener(raft.StateChangeEventType, s.raftEventLogger)
  95. raftServer.AddEventListener(raft.LeaderChangeEventType, s.raftEventLogger)
  96. raftServer.AddEventListener(raft.TermChangeEventType, s.raftEventLogger)
  97. raftServer.AddEventListener(raft.AddPeerEventType, s.raftEventLogger)
  98. raftServer.AddEventListener(raft.RemovePeerEventType, s.raftEventLogger)
  99. raftServer.AddEventListener(raft.HeartbeatIntervalEventType, s.raftEventLogger)
  100. raftServer.AddEventListener(raft.ElectionTimeoutThresholdEventType, s.raftEventLogger)
  101. raftServer.AddEventListener(raft.HeartbeatEventType, s.recordMetricEvent)
  102. raftServer.AddEventListener(raft.RemovedEventType, s.removedEvent)
  103. s.raftServer = raftServer
  104. s.removedInLog = false
  105. // LoadSnapshot
  106. if snapshot {
  107. err := s.raftServer.LoadSnapshot()
  108. if err == nil {
  109. log.Debugf("%s finished load snapshot", s.Config.Name)
  110. } else {
  111. log.Debug(err)
  112. }
  113. }
  114. s.raftServer.Init()
  115. // Set NOCOW for data directory in btrfs
  116. if btrfs.IsBtrfs(s.raftServer.LogPath()) {
  117. if err := btrfs.SetNOCOWFile(s.raftServer.LogPath()); err != nil {
  118. log.Warnf("Failed setting NOCOW: %v", err)
  119. }
  120. }
  121. }
  122. // Try all possible ways to find clusters to join
  123. // Include log data in -data-dir, -discovery and -peers
  124. //
  125. // Peer discovery follows this order:
  126. // 1. previous peers in -data-dir
  127. // 2. -discovery
  128. // 3. -peers
  129. func (s *PeerServer) FindCluster(discoverURL string, peers []string) (toStart bool, possiblePeers []string, err error) {
  130. name := s.Config.Name
  131. isNewNode := s.raftServer.IsLogEmpty()
  132. // Try its best to find possible peers, and connect with them.
  133. if !isNewNode {
  134. // It is not allowed to join the cluster with existing peer address
  135. // This prevents old node joining with different name by mistake.
  136. if !s.checkPeerAddressNonconflict() {
  137. err = fmt.Errorf("%v is not allowed to join the cluster with existing URL %v", s.Config.Name, s.Config.URL)
  138. return
  139. }
  140. // Take old nodes into account.
  141. possiblePeers = s.getKnownPeers()
  142. // Discover registered peers.
  143. // TODO(yichengq): It may mess up discoverURL if this is
  144. // set wrong by mistake. This may need to refactor discovery
  145. // module. Fix it later.
  146. if discoverURL != "" {
  147. discoverPeers, _ := s.handleDiscovery(discoverURL)
  148. possiblePeers = append(possiblePeers, discoverPeers...)
  149. }
  150. possiblePeers = append(possiblePeers, peers...)
  151. possiblePeers = s.removeSelfFromList(possiblePeers)
  152. if s.removedInLog {
  153. return
  154. }
  155. // If there is possible peer list, use it to find cluster.
  156. if len(possiblePeers) > 0 {
  157. // TODO(yichengq): joinCluster may fail if there's no leader for
  158. // current cluster. It should wait if the cluster is under
  159. // leader election, or the node with changed IP cannot join
  160. // the cluster then.
  161. if rejected, ierr := s.startAsFollower(possiblePeers, 1); rejected {
  162. log.Debugf("%s should work as standby for the cluster %v: %v", name, possiblePeers, ierr)
  163. return
  164. } else if ierr != nil {
  165. log.Warnf("%s cannot connect to previous cluster %v: %v", name, possiblePeers, ierr)
  166. } else {
  167. log.Debugf("%s joins to the previous cluster %v", name, possiblePeers)
  168. toStart = true
  169. return
  170. }
  171. }
  172. // TODO(yichengq): Think about the action that should be done
  173. // if it cannot connect any of the previous known node.
  174. log.Debugf("%s is restarting the cluster %v", name, possiblePeers)
  175. toStart = true
  176. return
  177. }
  178. // Attempt cluster discovery
  179. if discoverURL != "" {
  180. discoverPeers, discoverErr := s.handleDiscovery(discoverURL)
  181. // It is not registered in discover url
  182. if discoverErr != nil {
  183. log.Warnf("%s failed to connect discovery service[%v]: %v", name, discoverURL, discoverErr)
  184. if len(peers) == 0 {
  185. err = fmt.Errorf("%s, the new instance, must register itself to discovery service as required", name)
  186. return
  187. }
  188. log.Debugf("%s is joining peers %v from -peers flag", name, peers)
  189. } else {
  190. log.Debugf("%s is joining a cluster %v via discover service", name, discoverPeers)
  191. peers = discoverPeers
  192. }
  193. }
  194. possiblePeers = peers
  195. if len(possiblePeers) > 0 {
  196. if rejected, ierr := s.startAsFollower(possiblePeers, s.Config.RetryTimes); rejected {
  197. log.Debugf("%s should work as standby for the cluster %v: %v", name, possiblePeers, ierr)
  198. } else if ierr != nil {
  199. log.Warnf("%s cannot connect to existing peers %v: %v", name, possiblePeers, ierr)
  200. err = ierr
  201. } else {
  202. toStart = true
  203. }
  204. return
  205. }
  206. // start as a leader in a new cluster
  207. s.isNewCluster = true
  208. log.Infof("%s is starting a new cluster", s.Config.Name)
  209. toStart = true
  210. return
  211. }
  212. // Start starts the raft server.
  213. // The function assumes that join has been accepted successfully.
  214. func (s *PeerServer) Start(snapshot bool, clusterConfig *ClusterConfig) error {
  215. s.Lock()
  216. defer s.Unlock()
  217. if s.started {
  218. return nil
  219. }
  220. s.started = true
  221. s.removeNotify = make(chan bool)
  222. s.closeChan = make(chan bool)
  223. s.raftServer.Start()
  224. if s.isNewCluster {
  225. s.InitNewCluster(clusterConfig)
  226. s.isNewCluster = false
  227. }
  228. s.startRoutine(s.monitorSync)
  229. s.startRoutine(s.monitorTimeoutThreshold)
  230. s.startRoutine(s.monitorActiveSize)
  231. s.startRoutine(s.monitorPeerActivity)
  232. // open the snapshot
  233. if snapshot {
  234. s.startRoutine(s.monitorSnapshot)
  235. }
  236. return nil
  237. }
  238. // Stop stops the server gracefully.
  239. func (s *PeerServer) Stop() {
  240. s.Lock()
  241. defer s.Unlock()
  242. if !s.started {
  243. return
  244. }
  245. s.started = false
  246. close(s.closeChan)
  247. // TODO(yichengq): it should also call async stop for raft server,
  248. // but this functionality has not been implemented.
  249. s.raftServer.Stop()
  250. s.routineGroup.Wait()
  251. }
  252. // asyncRemove stops the server in peer mode.
  253. // It is called to stop the server internally when it has been removed
  254. // from the cluster.
  255. // The function triggers the stop action first to notice server that it
  256. // should not continue, and wait for its stop in separate goroutine because
  257. // the caller should also exit.
  258. func (s *PeerServer) asyncRemove() {
  259. s.Lock()
  260. if !s.started {
  261. s.Unlock()
  262. return
  263. }
  264. s.started = false
  265. close(s.closeChan)
  266. // TODO(yichengq): it should also call async stop for raft server,
  267. // but this functionality has not been implemented.
  268. go func() {
  269. s.raftServer.Stop()
  270. s.routineGroup.Wait()
  271. close(s.removeNotify)
  272. s.Unlock()
  273. }()
  274. }
  275. // RemoveNotify notifies the server is removed from peer mode due to
  276. // removal from the cluster.
  277. func (s *PeerServer) RemoveNotify() <-chan bool {
  278. return s.removeNotify
  279. }
  280. func (s *PeerServer) HTTPHandler() http.Handler {
  281. router := mux.NewRouter()
  282. // internal commands
  283. router.HandleFunc("/name", s.NameHttpHandler)
  284. router.HandleFunc("/version", s.VersionHttpHandler)
  285. router.HandleFunc("/version/{version:[0-9]+}/check", s.VersionCheckHttpHandler)
  286. router.HandleFunc("/upgrade", s.UpgradeHttpHandler)
  287. router.HandleFunc("/join", s.JoinHttpHandler)
  288. router.HandleFunc("/remove/{name:.+}", s.RemoveHttpHandler)
  289. router.HandleFunc("/vote", s.VoteHttpHandler)
  290. router.HandleFunc("/log", s.GetLogHttpHandler)
  291. router.HandleFunc("/log/append", s.AppendEntriesHttpHandler)
  292. router.HandleFunc("/snapshot", s.SnapshotHttpHandler)
  293. router.HandleFunc("/snapshotRecovery", s.SnapshotRecoveryHttpHandler)
  294. router.HandleFunc("/etcdURL", s.EtcdURLHttpHandler)
  295. router.HandleFunc("/v2/admin/config", s.getClusterConfigHttpHandler).Methods("GET")
  296. router.HandleFunc("/v2/admin/config", s.setClusterConfigHttpHandler).Methods("PUT")
  297. router.HandleFunc("/v2/admin/machines", s.getMachinesHttpHandler).Methods("GET")
  298. router.HandleFunc("/v2/admin/machines/{name}", s.getMachineHttpHandler).Methods("GET")
  299. return router
  300. }
  301. func (s *PeerServer) SetJoinIndex(joinIndex uint64) {
  302. s.joinIndex = joinIndex
  303. }
  304. // ClusterConfig retrieves the current cluster configuration.
  305. func (s *PeerServer) ClusterConfig() *ClusterConfig {
  306. e, err := s.store.Get(ClusterConfigKey, false, false)
  307. // This is useful for backward compatibility because it doesn't
  308. // set cluster config in older version.
  309. if err != nil {
  310. log.Debugf("failed getting cluster config key: %v", err)
  311. return NewClusterConfig()
  312. }
  313. var c ClusterConfig
  314. if err = json.Unmarshal([]byte(*e.Node.Value), &c); err != nil {
  315. log.Debugf("failed unmarshaling cluster config: %v", err)
  316. return NewClusterConfig()
  317. }
  318. return &c
  319. }
  320. // SetClusterConfig updates the current cluster configuration.
  321. // Adjusting the active size will cause cluster to add or remove machines
  322. // to match the new size.
  323. func (s *PeerServer) SetClusterConfig(c *ClusterConfig) {
  324. // Set minimums.
  325. if c.ActiveSize < MinActiveSize {
  326. c.ActiveSize = MinActiveSize
  327. }
  328. if c.RemoveDelay < MinRemoveDelay {
  329. c.RemoveDelay = MinRemoveDelay
  330. }
  331. if c.SyncInterval < MinSyncInterval {
  332. c.SyncInterval = MinSyncInterval
  333. }
  334. log.Debugf("set cluster config as %v", c)
  335. b, _ := json.Marshal(c)
  336. s.store.Set(ClusterConfigKey, false, string(b), store.Permanent)
  337. }
  338. // Retrieves the underlying Raft server.
  339. func (s *PeerServer) RaftServer() raft.Server {
  340. return s.raftServer
  341. }
  342. // Associates the client server with the peer server.
  343. func (s *PeerServer) SetServer(server *Server) {
  344. s.server = server
  345. }
  346. func (s *PeerServer) InitNewCluster(clusterConfig *ClusterConfig) {
  347. // leader need to join self as a peer
  348. s.doCommand(&JoinCommand{
  349. MinVersion: store.MinVersion(),
  350. MaxVersion: store.MaxVersion(),
  351. Name: s.raftServer.Name(),
  352. RaftURL: s.Config.URL,
  353. EtcdURL: s.server.URL(),
  354. })
  355. log.Debugf("%s start as a leader", s.Config.Name)
  356. s.joinIndex = 1
  357. s.doCommand(&SetClusterConfigCommand{Config: clusterConfig})
  358. log.Debugf("%s sets cluster config as %v", s.Config.Name, clusterConfig)
  359. }
  360. func (s *PeerServer) doCommand(cmd raft.Command) {
  361. for {
  362. if _, err := s.raftServer.Do(cmd); err == nil {
  363. break
  364. }
  365. }
  366. log.Debugf("%s start as a leader", s.Config.Name)
  367. }
  368. func (s *PeerServer) startAsFollower(cluster []string, retryTimes int) (bool, error) {
  369. // start as a follower in a existing cluster
  370. for i := 0; ; i++ {
  371. if rejected, err := s.joinCluster(cluster); rejected {
  372. return true, err
  373. } else if err == nil {
  374. return false, nil
  375. }
  376. if i == retryTimes-1 {
  377. break
  378. }
  379. log.Infof("%v is unable to join the cluster using any of the peers %v at %dth time. Retrying in %.1f seconds", s.Config.Name, cluster, i, s.Config.RetryInterval)
  380. time.Sleep(time.Second * time.Duration(s.Config.RetryInterval))
  381. continue
  382. }
  383. return false, fmt.Errorf("fail joining the cluster via given peers after %x retries", retryTimes)
  384. }
  385. // Upgradable checks whether all peers in a cluster support an upgrade to the next store version.
  386. func (s *PeerServer) Upgradable() error {
  387. nextVersion := s.store.Version() + 1
  388. for _, peerURL := range s.registry.PeerURLs(s.raftServer.Leader(), s.Config.Name) {
  389. u, err := url.Parse(peerURL)
  390. if err != nil {
  391. return fmt.Errorf("PeerServer: Cannot parse URL: '%s' (%s)", peerURL, err)
  392. }
  393. url := (&url.URL{Host: u.Host, Scheme: s.Config.Scheme}).String()
  394. ok, err := s.client.CheckVersion(url, nextVersion)
  395. if err != nil {
  396. return err
  397. }
  398. if !ok {
  399. return fmt.Errorf("PeerServer: Version %d is not compatible with peer: %s", nextVersion, u.Host)
  400. }
  401. }
  402. return nil
  403. }
  404. // checkPeerAddressNonconflict checks whether the peer address has existed with different name.
  405. func (s *PeerServer) checkPeerAddressNonconflict() bool {
  406. // there exists the (name, peer address) pair
  407. if peerURL, ok := s.registry.PeerURL(s.Config.Name); ok {
  408. if peerURL == s.Config.URL {
  409. return true
  410. }
  411. }
  412. // check all existing peer addresses
  413. peerURLs := s.registry.PeerURLs(s.raftServer.Leader(), s.Config.Name)
  414. for _, peerURL := range peerURLs {
  415. if peerURL == s.Config.URL {
  416. return false
  417. }
  418. }
  419. return true
  420. }
  421. // Helper function to do discovery and return results in expected format
  422. func (s *PeerServer) handleDiscovery(discoverURL string) (peers []string, err error) {
  423. peers, err = discovery.Do(discoverURL, s.Config.Name, s.Config.URL, s.closeChan, s.startRoutine)
  424. // Warn about errors coming from discovery, this isn't fatal
  425. // since the user might have provided a peer list elsewhere,
  426. // or there is some log in data dir.
  427. if err != nil {
  428. log.Warnf("Discovery encountered an error: %v", err)
  429. return
  430. }
  431. for i := range peers {
  432. // Strip the scheme off of the peer if it has one
  433. // TODO(bp): clean this up!
  434. purl, err := url.Parse(peers[i])
  435. if err == nil {
  436. peers[i] = purl.Host
  437. }
  438. }
  439. log.Infof("Discovery fetched back peer list: %v", peers)
  440. return
  441. }
  442. // getKnownPeers gets the previous peers from log
  443. func (s *PeerServer) getKnownPeers() []string {
  444. peers := s.registry.PeerURLs(s.raftServer.Leader(), s.Config.Name)
  445. log.Infof("Peer URLs in log: %s / %s (%s)", s.raftServer.Leader(), s.Config.Name, strings.Join(peers, ","))
  446. for i := range peers {
  447. u, err := url.Parse(peers[i])
  448. if err != nil {
  449. log.Debugf("getKnownPeers cannot parse url %v", peers[i])
  450. }
  451. peers[i] = u.Host
  452. }
  453. return peers
  454. }
  455. // removeSelfFromList removes url of the peerServer from the peer list
  456. func (s *PeerServer) removeSelfFromList(peers []string) []string {
  457. // Remove its own peer address from the peer list to join
  458. u, err := url.Parse(s.Config.URL)
  459. if err != nil {
  460. log.Warnf("failed parsing self peer address %v", s.Config.URL)
  461. u = nil
  462. }
  463. newPeers := make([]string, 0)
  464. for _, v := range peers {
  465. if u == nil || v != u.Host {
  466. newPeers = append(newPeers, v)
  467. }
  468. }
  469. return newPeers
  470. }
  471. func (s *PeerServer) joinCluster(cluster []string) (bool, error) {
  472. for _, peer := range cluster {
  473. if len(peer) == 0 {
  474. continue
  475. }
  476. if rejected, err := s.joinByPeer(s.raftServer, peer, s.Config.Scheme); rejected {
  477. return true, fmt.Errorf("rejected by peer %s: %v", peer, err)
  478. } else if err == nil {
  479. log.Infof("%s joined the cluster via peer %s", s.Config.Name, peer)
  480. return false, nil
  481. } else {
  482. log.Infof("%s attempted to join via %s failed: %v", s.Config.Name, peer, err)
  483. }
  484. }
  485. return false, fmt.Errorf("unreachable cluster")
  486. }
  487. // Send join requests to peer.
  488. // The first return tells whether it is rejected by the cluster directly.
  489. func (s *PeerServer) joinByPeer(server raft.Server, peer string, scheme string) (bool, error) {
  490. u := (&url.URL{Host: peer, Scheme: scheme}).String()
  491. // Our version must match the leaders version
  492. version, err := s.client.GetVersion(u)
  493. if err != nil {
  494. return false, fmt.Errorf("fail checking join version: %v", err)
  495. }
  496. if version < store.MinVersion() || version > store.MaxVersion() {
  497. return true, fmt.Errorf("fail passing version compatibility(%d-%d) using %d", store.MinVersion(), store.MaxVersion(), version)
  498. }
  499. // Fetch current peer list
  500. machines, err := s.client.GetMachines(u)
  501. if err != nil {
  502. return false, fmt.Errorf("fail getting machine messages: %v", err)
  503. }
  504. exist := false
  505. for _, machine := range machines {
  506. if machine.Name == server.Name() {
  507. exist = true
  508. break
  509. }
  510. }
  511. // Fetch cluster config to see whether exists some place.
  512. clusterConfig, err := s.client.GetClusterConfig(u)
  513. if err != nil {
  514. return false, fmt.Errorf("fail getting cluster config: %v", err)
  515. }
  516. if !exist && clusterConfig.ActiveSize <= len(machines) {
  517. return true, fmt.Errorf("stop joining because the cluster is full with %d nodes", len(machines))
  518. }
  519. joinIndex, err := s.client.AddMachine(u,
  520. &JoinCommand{
  521. MinVersion: store.MinVersion(),
  522. MaxVersion: store.MaxVersion(),
  523. Name: server.Name(),
  524. RaftURL: s.Config.URL,
  525. EtcdURL: s.server.URL(),
  526. })
  527. if err != nil {
  528. return err.ErrorCode == etcdErr.EcodeNoMorePeer, fmt.Errorf("fail on join request: %v", err)
  529. }
  530. s.joinIndex = joinIndex
  531. return false, nil
  532. }
  533. func (s *PeerServer) Stats() []byte {
  534. s.serverStats.LeaderInfo.Uptime = time.Now().Sub(s.serverStats.LeaderInfo.startTime).String()
  535. // TODO: register state listener to raft to change this field
  536. // rather than compare the state each time Stats() is called.
  537. if s.RaftServer().State() == raft.Leader {
  538. s.serverStats.LeaderInfo.Name = s.RaftServer().Name()
  539. }
  540. queue := s.serverStats.sendRateQueue
  541. s.serverStats.SendingPkgRate, s.serverStats.SendingBandwidthRate = queue.Rate()
  542. queue = s.serverStats.recvRateQueue
  543. s.serverStats.RecvingPkgRate, s.serverStats.RecvingBandwidthRate = queue.Rate()
  544. b, _ := json.Marshal(s.serverStats)
  545. return b
  546. }
  547. func (s *PeerServer) PeerStats() []byte {
  548. if s.raftServer.State() == raft.Leader {
  549. b, _ := json.Marshal(s.followersStats)
  550. return b
  551. }
  552. return nil
  553. }
  554. // removedEvent handles the case where a machine has been removed from the
  555. // cluster and is notified when it tries to become a candidate.
  556. func (s *PeerServer) removedEvent(event raft.Event) {
  557. // HACK(philips): we need to find a better notification for this.
  558. log.Infof("removed during cluster re-configuration")
  559. s.asyncRemove()
  560. }
  561. // raftEventLogger converts events from the Raft server into log messages.
  562. func (s *PeerServer) raftEventLogger(event raft.Event) {
  563. value := event.Value()
  564. prevValue := event.PrevValue()
  565. if value == nil {
  566. value = "<nil>"
  567. }
  568. if prevValue == nil {
  569. prevValue = "<nil>"
  570. }
  571. switch event.Type() {
  572. case raft.StateChangeEventType:
  573. log.Infof("%s: state changed from '%v' to '%v'.", s.Config.Name, prevValue, value)
  574. case raft.TermChangeEventType:
  575. log.Infof("%s: term #%v started.", s.Config.Name, value)
  576. case raft.LeaderChangeEventType:
  577. log.Infof("%s: leader changed from '%v' to '%v'.", s.Config.Name, prevValue, value)
  578. case raft.AddPeerEventType:
  579. log.Infof("%s: peer added: '%v'", s.Config.Name, value)
  580. case raft.RemovePeerEventType:
  581. log.Infof("%s: peer removed: '%v'", s.Config.Name, value)
  582. case raft.HeartbeatIntervalEventType:
  583. var name = "<unknown>"
  584. if peer, ok := value.(*raft.Peer); ok {
  585. name = peer.Name
  586. }
  587. log.Infof("%s: warning: heartbeat timed out: '%v'", s.Config.Name, name)
  588. case raft.ElectionTimeoutThresholdEventType:
  589. select {
  590. case s.timeoutThresholdChan <- value:
  591. default:
  592. }
  593. }
  594. }
  595. func (s *PeerServer) recordMetricEvent(event raft.Event) {
  596. name := fmt.Sprintf("raft.event.%s", event.Type())
  597. value := event.Value().(time.Duration)
  598. (*s.metrics).Timer(name).Update(value)
  599. }
  600. // logSnapshot logs about the snapshot that was taken.
  601. func (s *PeerServer) logSnapshot(err error, currentIndex, count uint64) {
  602. info := fmt.Sprintf("%s: snapshot of %d events at index %d", s.Config.Name, count, currentIndex)
  603. if err != nil {
  604. log.Infof("%s attempted and failed: %v", info, err)
  605. } else {
  606. log.Infof("%s completed", info)
  607. }
  608. }
  609. func (s *PeerServer) startRoutine(f func()) {
  610. s.routineGroup.Add(1)
  611. go func() {
  612. defer s.routineGroup.Done()
  613. f()
  614. }()
  615. }
  616. func (s *PeerServer) monitorSnapshot() {
  617. for {
  618. timer := time.NewTimer(s.snapConf.checkingInterval)
  619. defer timer.Stop()
  620. select {
  621. case <-s.closeChan:
  622. return
  623. case <-timer.C:
  624. }
  625. currentIndex := s.RaftServer().CommitIndex()
  626. count := currentIndex - s.snapConf.lastIndex
  627. if uint64(count) > s.snapConf.snapshotThr {
  628. err := s.raftServer.TakeSnapshot()
  629. s.logSnapshot(err, currentIndex, count)
  630. s.snapConf.lastIndex = currentIndex
  631. }
  632. }
  633. }
  634. func (s *PeerServer) monitorSync() {
  635. ticker := time.NewTicker(time.Millisecond * 500)
  636. defer ticker.Stop()
  637. for {
  638. select {
  639. case <-s.closeChan:
  640. return
  641. case now := <-ticker.C:
  642. if s.raftServer.State() == raft.Leader {
  643. s.raftServer.Do(s.store.CommandFactory().CreateSyncCommand(now))
  644. }
  645. }
  646. }
  647. }
  648. // monitorTimeoutThreshold groups timeout threshold events together and prints
  649. // them as a single log line.
  650. func (s *PeerServer) monitorTimeoutThreshold() {
  651. for {
  652. select {
  653. case <-s.closeChan:
  654. return
  655. case value := <-s.timeoutThresholdChan:
  656. log.Infof("%s: warning: heartbeat near election timeout: %v", s.Config.Name, value)
  657. }
  658. timer := time.NewTimer(ThresholdMonitorTimeout)
  659. defer timer.Stop()
  660. select {
  661. case <-s.closeChan:
  662. return
  663. case <-timer.C:
  664. }
  665. }
  666. }
  667. // monitorActiveSize has the leader periodically check the status of cluster
  668. // nodes and swaps them out for standbys as needed.
  669. func (s *PeerServer) monitorActiveSize() {
  670. for {
  671. timer := time.NewTimer(ActiveMonitorTimeout)
  672. defer timer.Stop()
  673. select {
  674. case <-s.closeChan:
  675. return
  676. case <-timer.C:
  677. }
  678. // Ignore while this peer is not a leader.
  679. if s.raftServer.State() != raft.Leader {
  680. continue
  681. }
  682. // Retrieve target active size and actual active size.
  683. activeSize := s.ClusterConfig().ActiveSize
  684. peers := s.registry.Names()
  685. peerCount := len(peers)
  686. if index := sort.SearchStrings(peers, s.Config.Name); index < len(peers) && peers[index] == s.Config.Name {
  687. peers = append(peers[:index], peers[index+1:]...)
  688. }
  689. // If we have more active nodes than we should then remove.
  690. if peerCount > activeSize {
  691. peer := peers[rand.Intn(len(peers))]
  692. log.Infof("%s: removing: %v", s.Config.Name, peer)
  693. if _, err := s.raftServer.Do(&RemoveCommand{Name: peer}); err != nil {
  694. log.Infof("%s: warning: remove error: %v", s.Config.Name, err)
  695. }
  696. continue
  697. }
  698. }
  699. }
  700. // monitorPeerActivity has the leader periodically for dead nodes and demotes them.
  701. func (s *PeerServer) monitorPeerActivity() {
  702. for {
  703. timer := time.NewTimer(PeerActivityMonitorTimeout)
  704. defer timer.Stop()
  705. select {
  706. case <-s.closeChan:
  707. return
  708. case <-timer.C:
  709. }
  710. // Ignore while this peer is not a leader.
  711. if s.raftServer.State() != raft.Leader {
  712. continue
  713. }
  714. // Check last activity for all peers.
  715. now := time.Now()
  716. removeDelay := time.Duration(int64(s.ClusterConfig().RemoveDelay * float64(time.Second)))
  717. peers := s.raftServer.Peers()
  718. for _, peer := range peers {
  719. // If the last response from the peer is longer than the remove delay
  720. // then automatically demote the peer.
  721. if !peer.LastActivity().IsZero() && now.Sub(peer.LastActivity()) > removeDelay {
  722. log.Infof("%s: removing node: %v; last activity %v ago", s.Config.Name, peer.Name, now.Sub(peer.LastActivity()))
  723. if _, err := s.raftServer.Do(&RemoveCommand{Name: peer.Name}); err != nil {
  724. log.Infof("%s: warning: autodemotion error: %v", s.Config.Name, err)
  725. }
  726. continue
  727. }
  728. }
  729. }
  730. }