server.go 9.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336
  1. package server
  2. import (
  3. "encoding/json"
  4. "fmt"
  5. "net/http"
  6. "net/http/pprof"
  7. "strings"
  8. "time"
  9. "github.com/coreos/etcd/third_party/github.com/coreos/raft"
  10. "github.com/coreos/etcd/third_party/github.com/gorilla/mux"
  11. etcdErr "github.com/coreos/etcd/error"
  12. "github.com/coreos/etcd/log"
  13. "github.com/coreos/etcd/metrics"
  14. "github.com/coreos/etcd/mod"
  15. uhttp "github.com/coreos/etcd/pkg/http"
  16. "github.com/coreos/etcd/server/v1"
  17. "github.com/coreos/etcd/server/v2"
  18. "github.com/coreos/etcd/store"
  19. _ "github.com/coreos/etcd/store/v2"
  20. )
  21. // This is the default implementation of the Server interface.
  22. type Server struct {
  23. Name string
  24. url string
  25. handler http.Handler
  26. peerServer *PeerServer
  27. registry *Registry
  28. store store.Store
  29. metrics *metrics.Bucket
  30. trace bool
  31. }
  32. // Creates a new Server.
  33. func New(name, url string, peerServer *PeerServer, registry *Registry, store store.Store, mb *metrics.Bucket) *Server {
  34. s := &Server{
  35. Name: name,
  36. url: url,
  37. store: store,
  38. registry: registry,
  39. peerServer: peerServer,
  40. metrics: mb,
  41. }
  42. return s
  43. }
  44. func (s *Server) EnableTracing() {
  45. s.trace = true
  46. }
  47. // The current state of the server in the cluster.
  48. func (s *Server) State() string {
  49. return s.peerServer.RaftServer().State()
  50. }
  51. // The node name of the leader in the cluster.
  52. func (s *Server) Leader() string {
  53. return s.peerServer.RaftServer().Leader()
  54. }
  55. // The current Raft committed index.
  56. func (s *Server) CommitIndex() uint64 {
  57. return s.peerServer.RaftServer().CommitIndex()
  58. }
  59. // The current Raft term.
  60. func (s *Server) Term() uint64 {
  61. return s.peerServer.RaftServer().Term()
  62. }
  63. // The server URL.
  64. func (s *Server) URL() string {
  65. return s.url
  66. }
  67. // Retrives the Peer URL for a given node name.
  68. func (s *Server) PeerURL(name string) (string, bool) {
  69. return s.registry.PeerURL(name)
  70. }
  71. // ClientURL retrieves the Client URL for a given node name.
  72. func (s *Server) ClientURL(name string) (string, bool) {
  73. return s.registry.ClientURL(name)
  74. }
  75. // Returns a reference to the Store.
  76. func (s *Server) Store() store.Store {
  77. return s.store
  78. }
  79. func (s *Server) installV1(r *mux.Router) {
  80. s.handleFuncV1(r, "/v1/keys/{key:.*}", v1.GetKeyHandler).Methods("GET")
  81. s.handleFuncV1(r, "/v1/keys/{key:.*}", v1.SetKeyHandler).Methods("POST", "PUT")
  82. s.handleFuncV1(r, "/v1/keys/{key:.*}", v1.DeleteKeyHandler).Methods("DELETE")
  83. s.handleFuncV1(r, "/v1/watch/{key:.*}", v1.WatchKeyHandler).Methods("GET", "POST")
  84. s.handleFunc(r, "/v1/leader", s.GetLeaderHandler).Methods("GET")
  85. s.handleFunc(r, "/v1/machines", s.GetPeersHandler).Methods("GET")
  86. s.handleFunc(r, "/v1/peers", s.GetPeersHandler).Methods("GET")
  87. s.handleFunc(r, "/v1/stats/self", s.GetStatsHandler).Methods("GET")
  88. s.handleFunc(r, "/v1/stats/leader", s.GetLeaderStatsHandler).Methods("GET")
  89. s.handleFunc(r, "/v1/stats/store", s.GetStoreStatsHandler).Methods("GET")
  90. }
  91. func (s *Server) installV2(r *mux.Router) {
  92. s.handleFuncV2(r, "/v2/keys/{key:.*}", v2.GetHandler).Methods("GET")
  93. s.handleFuncV2(r, "/v2/keys/{key:.*}", v2.PostHandler).Methods("POST")
  94. s.handleFuncV2(r, "/v2/keys/{key:.*}", v2.PutHandler).Methods("PUT")
  95. s.handleFuncV2(r, "/v2/keys/{key:.*}", v2.DeleteHandler).Methods("DELETE")
  96. s.handleFunc(r, "/v2/leader", s.GetLeaderHandler).Methods("GET")
  97. s.handleFunc(r, "/v2/machines", s.GetPeersHandler).Methods("GET")
  98. s.handleFunc(r, "/v2/peers", s.GetPeersHandler).Methods("GET")
  99. s.handleFunc(r, "/v2/stats/self", s.GetStatsHandler).Methods("GET")
  100. s.handleFunc(r, "/v2/stats/leader", s.GetLeaderStatsHandler).Methods("GET")
  101. s.handleFunc(r, "/v2/stats/store", s.GetStoreStatsHandler).Methods("GET")
  102. s.handleFunc(r, "/v2/speedTest", s.SpeedTestHandler).Methods("GET")
  103. }
  104. func (s *Server) installMod(r *mux.Router) {
  105. r.PathPrefix("/mod").Handler(http.StripPrefix("/mod", mod.HttpHandler(s.URL())))
  106. }
  107. func (s *Server) installDebug(r *mux.Router) {
  108. s.handleFunc(r, "/debug/metrics", s.GetMetricsHandler).Methods("GET")
  109. r.HandleFunc("/debug/pprof", pprof.Index)
  110. r.HandleFunc("/debug/pprof/cmdline", pprof.Cmdline)
  111. r.HandleFunc("/debug/pprof/profile", pprof.Profile)
  112. r.HandleFunc("/debug/pprof/symbol", pprof.Symbol)
  113. r.HandleFunc("/debug/pprof/{name}", pprof.Index)
  114. }
  115. // Adds a v1 server handler to the router.
  116. func (s *Server) handleFuncV1(r *mux.Router, path string, f func(http.ResponseWriter, *http.Request, v1.Server) error) *mux.Route {
  117. return s.handleFunc(r, path, func(w http.ResponseWriter, req *http.Request) error {
  118. return f(w, req, s)
  119. })
  120. }
  121. // Adds a v2 server handler to the router.
  122. func (s *Server) handleFuncV2(r *mux.Router, path string, f func(http.ResponseWriter, *http.Request, v2.Server) error) *mux.Route {
  123. return s.handleFunc(r, path, func(w http.ResponseWriter, req *http.Request) error {
  124. return f(w, req, s)
  125. })
  126. }
  127. // Adds a server handler to the router.
  128. func (s *Server) handleFunc(r *mux.Router, path string, f func(http.ResponseWriter, *http.Request) error) *mux.Route {
  129. // Wrap the standard HandleFunc interface to pass in the server reference.
  130. return r.HandleFunc(path, func(w http.ResponseWriter, req *http.Request) {
  131. // Log request.
  132. log.Debugf("[recv] %s %s %s [%s]", req.Method, s.URL(), req.URL.Path, req.RemoteAddr)
  133. // Execute handler function and return error if necessary.
  134. if err := f(w, req); err != nil {
  135. if etcdErr, ok := err.(*etcdErr.Error); ok {
  136. log.Debug("Return error: ", (*etcdErr).Error())
  137. w.Header().Set("Content-Type", "application/json")
  138. etcdErr.Write(w)
  139. } else {
  140. http.Error(w, err.Error(), http.StatusInternalServerError)
  141. }
  142. }
  143. })
  144. }
  145. func (s *Server) HTTPHandler() http.Handler {
  146. router := mux.NewRouter()
  147. // Install the routes.
  148. s.handleFunc(router, "/version", s.GetVersionHandler).Methods("GET")
  149. s.installV1(router)
  150. s.installV2(router)
  151. s.installMod(router)
  152. if s.trace {
  153. s.installDebug(router)
  154. }
  155. return router
  156. }
  157. // Dispatch command to the current leader
  158. func (s *Server) Dispatch(c raft.Command, w http.ResponseWriter, req *http.Request) error {
  159. ps := s.peerServer
  160. if ps.raftServer.State() == raft.Leader {
  161. result, err := ps.raftServer.Do(c)
  162. if err != nil {
  163. return err
  164. }
  165. if result == nil {
  166. return etcdErr.NewError(300, "Empty result from raft", s.Store().Index())
  167. }
  168. // response for raft related commands[join/remove]
  169. if b, ok := result.([]byte); ok {
  170. w.WriteHeader(http.StatusOK)
  171. w.Write(b)
  172. return nil
  173. }
  174. var b []byte
  175. if strings.HasPrefix(req.URL.Path, "/v1") {
  176. b, _ = json.Marshal(result.(*store.Event).Response(0))
  177. w.WriteHeader(http.StatusOK)
  178. } else {
  179. e, _ := result.(*store.Event)
  180. b, _ = json.Marshal(e)
  181. w.Header().Set("Content-Type", "application/json")
  182. // etcd index should be the same as the event index
  183. // which is also the last modified index of the node
  184. w.Header().Add("X-Etcd-Index", fmt.Sprint(e.Index()))
  185. w.Header().Add("X-Raft-Index", fmt.Sprint(s.CommitIndex()))
  186. w.Header().Add("X-Raft-Term", fmt.Sprint(s.Term()))
  187. if e.IsCreated() {
  188. w.WriteHeader(http.StatusCreated)
  189. } else {
  190. w.WriteHeader(http.StatusOK)
  191. }
  192. }
  193. w.Write(b)
  194. return nil
  195. } else {
  196. leader := ps.raftServer.Leader()
  197. // No leader available.
  198. if leader == "" {
  199. return etcdErr.NewError(300, "", s.Store().Index())
  200. }
  201. var url string
  202. switch c.(type) {
  203. case *JoinCommand, *RemoveCommand:
  204. url, _ = ps.registry.PeerURL(leader)
  205. default:
  206. url, _ = ps.registry.ClientURL(leader)
  207. }
  208. uhttp.Redirect(url, w, req)
  209. return nil
  210. }
  211. }
  212. // Handler to return the current version of etcd.
  213. func (s *Server) GetVersionHandler(w http.ResponseWriter, req *http.Request) error {
  214. w.WriteHeader(http.StatusOK)
  215. fmt.Fprintf(w, "etcd %s", ReleaseVersion)
  216. return nil
  217. }
  218. // Handler to return the current leader's raft address
  219. func (s *Server) GetLeaderHandler(w http.ResponseWriter, req *http.Request) error {
  220. leader := s.peerServer.RaftServer().Leader()
  221. if leader == "" {
  222. return etcdErr.NewError(etcdErr.EcodeLeaderElect, "", s.Store().Index())
  223. }
  224. w.WriteHeader(http.StatusOK)
  225. url, _ := s.registry.PeerURL(leader)
  226. w.Write([]byte(url))
  227. return nil
  228. }
  229. // Handler to return all the known peers in the current cluster.
  230. func (s *Server) GetPeersHandler(w http.ResponseWriter, req *http.Request) error {
  231. peers := s.registry.ClientURLs(s.peerServer.RaftServer().Leader(), s.Name)
  232. w.WriteHeader(http.StatusOK)
  233. w.Write([]byte(strings.Join(peers, ", ")))
  234. return nil
  235. }
  236. // Retrieves stats on the Raft server.
  237. func (s *Server) GetStatsHandler(w http.ResponseWriter, req *http.Request) error {
  238. w.Write(s.peerServer.Stats())
  239. return nil
  240. }
  241. // Retrieves stats on the leader.
  242. func (s *Server) GetLeaderStatsHandler(w http.ResponseWriter, req *http.Request) error {
  243. if s.peerServer.RaftServer().State() == raft.Leader {
  244. w.Write(s.peerServer.PeerStats())
  245. return nil
  246. }
  247. leader := s.peerServer.RaftServer().Leader()
  248. if leader == "" {
  249. return etcdErr.NewError(300, "", s.Store().Index())
  250. }
  251. hostname, _ := s.registry.ClientURL(leader)
  252. uhttp.Redirect(hostname, w, req)
  253. return nil
  254. }
  255. // Retrieves stats on the leader.
  256. func (s *Server) GetStoreStatsHandler(w http.ResponseWriter, req *http.Request) error {
  257. w.Write(s.store.JsonStats())
  258. return nil
  259. }
  260. // Executes a speed test to evaluate the performance of update replication.
  261. func (s *Server) SpeedTestHandler(w http.ResponseWriter, req *http.Request) error {
  262. count := 1000
  263. c := make(chan bool, count)
  264. for i := 0; i < count; i++ {
  265. go func() {
  266. for j := 0; j < 10; j++ {
  267. c := s.Store().CommandFactory().CreateSetCommand("foo", false, "bar", time.Unix(0, 0))
  268. s.peerServer.RaftServer().Do(c)
  269. }
  270. c <- true
  271. }()
  272. }
  273. for i := 0; i < count; i++ {
  274. <-c
  275. }
  276. w.WriteHeader(http.StatusOK)
  277. w.Write([]byte("speed test success"))
  278. return nil
  279. }
  280. // Retrieves metrics from bucket
  281. func (s *Server) GetMetricsHandler(w http.ResponseWriter, req *http.Request) error {
  282. (*s.metrics).Dump(w)
  283. return nil
  284. }