引入上述依赖后,客户端便会主动连接 Sentinel 控制台。通过 Sentinel 控制台 即可查看客户端的实时监控。

通常您并不需要关心以下 API,但是如果您对开发控制台感兴趣,以下为监控 API 的文档。

相关 API:

当应用启动之后,可以运行下列命令,获得当前所有簇点(ClusterNode)的列表(JSON 格式):

  1. curl http://localhost:8719/clusterNode

结果示例:

  1. [
  2. {"avgRt":0.0, //平均响应时间
  3. "blockRequest":0, //每分钟拦截的请求个数
  4. "blockedQps":0.0, //每秒拦截个数
  5. "curThreadNum":0, //并发个数
  6. "passQps":1.0, // 每秒成功通过请求
  7. "passReqQps":1.0, //每秒到来的请求
  8. "timeStamp":1529905824134, //时间戳
  9. "totalQps":1.0, // 每分钟请求数
  10. "totalRequest":193},
  11. ....
  12. ]

查询某个簇点的详细信息

  1. curl http://localhost:8719/cnode?id=xxxx

结果示例:

可以用下列命令查询该簇点的调用者统计信息:

  1. curl http://localhost:8719/origin?id=xxxx

结果示例:

  1. id: nodeA
  2. idx origin threadNum passedQps blockedQps totalQps aRt 1m-passed 1m-blocked 1m-total
  3. 1 caller1 0 0 0 0 0 0 0 0
  4. 2 caller2 0 0 0 0 0 0 0 0

其中的 origin 由 ContextUtil.enter(resourceName,origin) 方法中的 origin 指定。

我们可以通过命令 来查询链路入口的链路树形结构:

  1. EntranceNode: machine-root(t:0 pq:1 bq:0 tq:1 rt:0 prq:1 1mp:0 1mb:0 1mt:0)
  2. -EntranceNode1: Entrance1(t:0 pq:1 bq:0 tq:1 rt:0 prq:1 1mp:0 1mb:0 1mt:0)
  3. --nodeA(t:0 pq:1 bq:0 tq:1 rt:0 prq:1 1mp:0 1mb:0 1mt:0)
  4. -EntranceNode2: Entrance1(t:0 pq:1 bq:0 tq:1 rt:0 prq:1 1mp:0 1mb:0 1mt:0)
  5. --nodeA(t:0 pq:1 bq:0 tq:1 rt:0 prq:1 1mp:0 1mb:0 1mt:0)
  6. t:threadNum pq:passQps bq:blockedQps tq:totalQps rt:averageRt prq: passRequestQps 1mp:1m-passed 1mb:1m-blocked 1mt:1m-total

资源的秒级日志

格式说明:

同样的,每秒的拦截日志(block 日志)也会出现在 <用户目录>/logs/csp/sentinel-block.log 文件下。如果没有发生拦截,则该日志不会出现。

  1. 2014-06-20 16:35:10|1|sayHello(java.lang.String,long),FlowException,default,origin|61,0
  2. 2014-06-20 16:35:11|1|sayHello(java.lang.String,long),FlowException,default,origin|1,0
index例子说明
12014-06-20 16:35:10时间戳
2该秒发生的第一个资源
3sayHello(java.lang.String,long)资源名称
4XXXException拦截的原因, 通常 FlowException 代表是被限流规则拦截,DegradeException 则表示被降级,SystemBlockException 则表示被系统保护拦截
5default生效规则的调用来源(参数限流中代表生效的参数)
6origin被拦截资源的调用者,可以为空
761,061 被拦截的数量,0 无意义可忽略

实时查询

相关 API: GET /metric

  1. curl http://localhost:8719/metric?identity=XXX&startTime=XXXX&endTime=XXXX&maxLines=XXXX

需指定以下 URL 参数:

  • identity:资源名称
  • startTime:开始时间(时间戳)
  • endTime:结束时间
  • maxLines:监控数据最大行数

返回和 格式一样的内容。例如:

  1. 1529998904000|2018-06-26 15:41:44|abc|100|0|0|0|0
  2. 1529998905000|2018-06-26 15:41:45|abc|4|5579|104|0|728
  3. 1529998906000|2018-06-26 15:41:46|abc|0|15698|0|0|0
  4. 1529998907000|2018-06-26 15:41:47|abc|0|19262|0|0|0
  5. 1529998908000|2018-06-26 15:41:48|abc|0|19502|0|0|0
  6. 1529998909000|2018-06-26 15:41:49|abc|0|18386|0|0|0
  7. 1529998910000|2018-06-26 15:41:50|abc|0|19189|0|0|0
  8. 1529998911000|2018-06-26 15:41:51|abc|0|16543|0|0|0
  9. 1529998913000|2018-06-26 15:41:53|abc|0|19405|0|0|0