节点资源

  • GET /v1/node

返回openLooKeng服务器已知的节点列表。此调用不需要标头的查询参数，它只返回一个数组，数组中包含openLooKeng安装中的每个已知节点。

响应消息中，recentRequests、recentFailures和recentSuccesses的取值是随时间指数衰减的计数器，衰减参数为1分钟。这个衰减率意味着，如果一个openLooKeng节点在几秒内有1000次成功，那么这个统计值在一分钟内就会下降到367次。

age显示一个节点的运行时长，uri指向该节点的HTTP服务器。最后一次请求和响应时间显示了一个节点的最近使用情况。

下面的响应示例显示一个未经历了任何故障条件的节点。各节点同时上报流量正常、故障等统计数据。

响应样例：

  1. HTTP/1.1 200 OK
  2. Vary: Accept
  3. Content-Type: text/javascript
  5. [
  6. {
  7.     "uri":"http://192.168.1.1:8080",
  8. "recentRequests":25.181940555111073,
  9. "recentFailures":0.0,
  10. "recentSuccesses":25.195472984170983,
  11. "lastRequestTime":"2013-12-22T13:32:44.673-05:00",
  12. "lastResponseTime":"2013-12-22T13:32:44.677-05:00",
  13. "age":"14155.28ms",
  14. "recentFailureRatio":0.0,
  15. "recentFailuresByType":{}
  16. }
  18. ]

如果一个节点发生故障，您会看到如下所示的响应。此例中，一个节点发生了一连串的错误。recentFailuresByType字段列出了节点上发生的Java异常。

错误响应样例：

  1. HTTP/1.1 200 OK
  3. Vary: Accept Content-Type: text/javascript
  5. [
  7. {
  9.    ​    "age": "4.45m", "lastFailureInfo": { "message":
  10. ​     "Connect Timeout", "stack": [
  11.    ​     "org.eclipse.jetty.io.ManagedSelector$ConnectTimeout.run(ManagedSelector.java:683)",
  12.    ​     .... "java.lang.Thread.run(Thread.java:745)" ],
  13.    ​     "suppressed": [], "type":
  14.    ​     "java.net.SocketTimeoutException" }, "lastRequestTime":
  15.    ​     "2017-08-05T11:53:00.647Z", "lastResponseTime":
  16.    ​     "2017-08-05T11:53:00.647Z", "recentFailureRatio":
  17.    ​     0.47263053472046446, "recentFailures": 2.8445543205610617,
  18.    ​     "recentFailuresByType": {
  19.    ​     "java.net.SocketTimeoutException": 2.8445543205610617 },
  20.    ​     "recentRequests": 6.018558073577414, "recentSuccesses":
  21.    ​     3.1746446343010297, "uri": "<http://172.19.0.3:8080>"
  23. }
  25. ]
  • GET /v1/node/failed

调用此服务将返回一个JSON文档，其中列出了所有上次心跳检测失败的节点。由此调用返回的信息与前一个业务返回的信息相同。

响应样例：

  2. [
  3. {
  5. "age": "1.37m", "lastFailureInfo": { "message":
  6. "Connect Timeout", "stack": [
  7. "org.eclipse.jetty.io.ManagedSelector$ConnectTimeout.run(ManagedSelector.java:683)",
  8. ...
  9. "java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617)",
  10. "java.lang.Thread.run(Thread.java:745)" ], "suppressed":
  11. [], "type": "java.net.SocketTimeoutException" },
  12. "lastRequestTime": "2017-08-05T11:52:42.647Z",
  13. "lastResponseTime": "2017-08-05T11:52:42.647Z",
  14. "recentFailureRatio": 0.22498784153043677,
  15. "recentFailures": 20.11558290058638,
  16. "recentFailuresByType": {
  17. "java.net.SocketTimeoutException": 20.11558290058638 },
  18. "recentRequests": 89.40742203558189, "recentSuccesses":
  19. 69.30583024727453, "uri": "<http://172.19.0.3:8080>"
  21. }
  22. ]