Sentinel API 是阿里巴巴开源的微服务流量控制组件 Sentinel 提供的一组编程接口,允许开发者在应用中直接操作和管理 Sentinel 的各种规则、统计信息以及与 Sentinel 控制台进行交互。以下是对 Sentinel API 使用的一些要点:
-
资源定义与监控:
com.alibaba.csp.sentinel.Entry
和SphU
类提供了资源定义和入口方法。通过调用SphU.entry(resourceName)
方法可以创建一个资源的入口点,并且 Sentinel 将对这个资源的调用进行监控。
-
流量控制规则:
FlowRuleManager
负责流量控制规则的加载和管理。可以通过调用FlowRuleManager.loadRules(rules)
来动态加载或更新流控规则。FlowRule
类表示一个流量控制规则,包含限流阈值(QPS 或并发线程数)、流控模式、统计窗口等属性。
-
熔断降级规则:
DegradeRuleManager
用于管理和加载熔断降级规则,类似地,使用DegradeRuleManager.loadRules(rules)
动态加载降级规则。DegradeRule
定义了熔断降级策略,例如异常比例、RT 等指标的阈值。
-
系统保护规则:
- 对于系统整体负载保护,如 CPU 使用率、线程池使用率等,可以通过
SystemRuleManager
加载和管理相应的系统保护规则。
- 对于系统整体负载保护,如 CPU 使用率、线程池使用率等,可以通过
-
上下文工具:
ContextUtil
类提供了上下文相关的操作,比如获取当前请求的上下文,以及在多线程环境下传递跟踪上下文。
-
规则持久化与同步:
- Sentinel 支持将规则存储到本地文件或配置中心(如 Nacos、Apollo、Zookeeper 等),并实现从这些数据源实时拉取和更新规则的功能。
-
统计信息查询:
- Sentinel 提供了 HTTP API 接口来查询系统的统计信息,例如某个资源的 Metrics 数据。
-
集群状态管理:
- 在分布式场景下,Sentinel 还提供集群管理 API,例如设置集群流控模式、节点状态上报等。
-
事件监听机制:
- Sentinel 内部实现了事件总线机制,允许开发者注册自定义的监听器,当规则变更、资源被限流或者降级时,可以接收到通知。
通过 Sentinel API,开发者可以根据业务需求灵活地调整和扩展 Sentinel 的功能,确保服务在高并发场景下的稳定性。同时,API 也方便了 Sentinel 与其他系统的集成,如日志记录、报警系统等。