peer_server.go 24 KB

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