Java 微服务治理：Sentinel 限流降级 + Spring Boot Admin 监控

Mon, 15 Jun 2020 00:00:00 +0800

微服务架构跑起来后，稳定性保障是头等大事——限流、熔断、降级、监控告警缺一不可。本篇把 Alibaba Sentinel 限流和 Spring Boot Admin 监控两套核心组件的 Docker 化部署整理清楚。

阅读对象：Java 后端 / 微服务架构师 覆盖范围：Sentinel Dashboard 部署 + Spring Boot Admin 部署 + 微服务接入 + 限流规则配置 + 告警通知 + Loki 日志集成

一、微服务治理全景

1
2
3
4
5
6
7
8
9


微服务治理体系
 ├─ 服务注册发现：Nacos / Consul / Eureka
 ├─ 配置中心：Nacos / Apollo
 ├─ API 网关：Spring Cloud Gateway / Zuul
 ├─ 服务调用：OpenFeign / Dubbo
 ├─ 服务熔断：Sentinel / Hystrix（已停维）
 ├─ 链路追踪：Sleuth + Zipkin / SkyWalking
 ├─ 监控告警：Spring Boot Admin / Prometheus + Grafana
 └─ 日志聚合：ELK / Loki

本篇聚焦：Sentinel（限流熔断）+ Spring Boot Admin（监控）。

When to use Sentinel：

微服务架构，需要防雪崩

双 11、618 大促流量控制

第三方接口调用熔断

秒杀、抢购等高并发场景

When to use Spring Boot Admin：

Spring Boot 微服务集群监控

JVM 指标 / 线程 / 内存 / 日志统一查看

实时健康检查 + 告警

二、Alibaba Sentinel

2.1 简介

Sentinel 是阿里开源的流量控制 / 熔断降级组件，2018 年开源：

维度	Sentinel	Hystrix（已停维）	Resilience4j
流量控制	✅ 多种策略	简单	简单
熔断降级	✅	✅	✅
系统自适应保护	✅（Load / CPU / RT）	❌	❌
控制台	✅ 可视化	简单	无
规则持久化	✅ Nacos / Apollo / 文件	配置中心	代码
社区活跃度	高	已停维	中

2.2 Sentinel Dashboard 部署

下载：v1.8.6

1
2
3
4
5
6
7
8
9


# 1. docker 启动
docker run -d --name sentinel --restart=always \
 -p 18080:8080 \
 -v /home/project/safety/sentinel/jar:/jar \
 lwd/jdk:8u371 \
 java -Dserver.port=8080 \
 -Dcsp.sentinel.dashboard.server=localhost:8080 \
 -Dproject.name=sentinel-dashboard \
 -jar /jar/sentinel-dashboard-1.8.6.jar

docker-compose 完整版：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


version: "3"
x-logging: &loki-logging
 driver: loki
 options:
 loki-url: "http://internal.example.com:3100/loki/api/v1/push"
 max-size: "50m"
 max-file: "10"
 loki-pipeline-stages: |
 - multiline:
 firstline: '^\[\d{2}:\d{2}:\d{2} \w{4}\]'
services:
 sentinel:
 image: lwd/jdk:8u371
 container_name: sentinel
 restart: always
 logging: *loki-logging
 network_mode: host
 volumes:
 - "/home/project/safety/sentinel/jar:/jar"
 command: java -Dserver.port=8080 \
 -Dcsp.sentinel.dashboard.server=localhost:8080 \
 -Dproject.name=sentinel-dashboard \
 -jar /jar/sentinel-dashboard-1.8.6.jar

2.3 访问 Dashboard

1
2


http://<IP>:18080
默认账号：sentinel / sentinel

2.4 微服务接入 Sentinel

添加依赖：

1
2
3
4


<dependency>
 <groupId>com.alibaba.cloud</groupId>
 <artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
</dependency>

配置：

1
2
3
4
5
6
7
8
9


spring:
 application:
 name: my-service
 cloud:
 sentinel:
 transport:
 dashboard: localhost:18080  # Sentinel Dashboard 地址
 port: 8719 # 与 Dashboard 通信端口
 eager: true # 启动时立刻注册

限流示例：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


@RestController
public class OrderController {

 @GetMapping("/order/create")
 @SentinelResource(value = "createOrder", blockHandler = "handleBlock")
 public String createOrder() {
 return "success";
 }

 // 限流后的回调
 public String handleBlock(BlockException e) {
 return "系统繁忙，请稍后重试";
 }
}

2.5 限流规则配置

Dashboard → 簇点链路 → 找到 createOrder → 流控：

1
2
3
4


阈值类型：QPS
单机阈值：100
流控模式：直接
流控效果：快速失败

效果：每秒超过 100 个请求 → 触发限流 → 调用 handleBlock。

2.6 熔断降级

Dashboard → 熔断规则：

1
2
3
4
5


资源名：createOrder
熔断策略：慢调用比例
最大 RT：500ms
熔断时长：10s
最小请求数：5

效果：5 个请求中慢调用（>500ms）占比超阈值 → 熔断 10s。

2.7 规则持久化（生产必做）

默认规则存内存，重启就丢。生产用 Nacos 持久化：

1
2
3
4


<dependency>
 <groupId>com.alibaba.csp</groupId>
 <artifactId>sentinel-datasource-nacos</artifactId>
</dependency>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


spring:
 cloud:
 sentinel:
 datasource:
 ds1:
 nacos:
 server-addr: nacos.internal.example.com:8848
 dataId: sentinel-flow-rules
 groupId: DEFAULT_GROUP
 rule-type: flow

三、Spring Boot Admin

3.1 简介

Spring Boot Admin 是 Spring Boot 应用的统一监控中心：

应用健康检查（UP / DOWN / OFFLINE / UNKNOWN）
JVM 指标（内存、线程、GC、堆栈）
HTTP 请求追踪
日志查看（实时拉取）
配置信息（Spring Environment）
告警通知（邮件 / Slack / PagerDuty / 钉钉 / 飞书）

3.2 创建 Admin Server

pom.xml：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


<dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
 <groupId>de.codecentric</groupId>
 <artifactId>spring-boot-admin-starter-server</artifactId>
 <version>2.5.6</version>
</dependency>
<dependency>
 <groupId>org.projectlombok</groupId>
 <artifactId>lombok</artifactId>
 <optional>true</optional>
</dependency>

Application.java：

1
2
3
4
5
6
7


@SpringBootApplication
@EnableAdminServer
public class SpringbootAdminApplication {
 public static void main(String[] args) {
 SpringApplication.run(SpringbootAdminApplication.class, args);
 }
}

application.yml：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


server:
 port: 4396
spring:
 application:
 name: springbootadmin
 boot:
 admin:
 notify:
 slack:
 enabled: true
 webhook-url: https://hooks.slack.com/services/{{SLACK_TOKEN}}
 mail:
 enabled: true
 from: noreply@example.com

3.3 部署

1
2
3
4
5


docker run -d --name springbootadmin --restart=always \
 -p 14396:4396 \
 -v /home/docker/springboot-admin/jar:/jar \
 lwd/jdk:8u371 \
 java -jar /jar/SpringbootAdmin-0.0.1-SNAPSHOT.jar

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


# docker-compose
version: "3"
x-logging: &loki-logging
 driver: loki
 options:
 loki-url: "http://internal.example.com:3100/loki/api/v1/push"
services:
 admin:
 image: lwd/jdk:8u371
 container_name: admin
 restart: always
 logging: *loki-logging
 network_mode: host
 volumes:
 - "/home/project/safety/admin/jar:/jar"
 command: java -jar /jar/SpringbootAdmin-0.0.1-SNAPSHOT.jar

访问：

1

http://<IP>:14396

3.4 微服务注册到 Admin

添加依赖：

1
2
3
4
5


<dependency>
 <groupId>de.codecentric</groupId>
 <artifactId>spring-boot-admin-starter-client</artifactId>
 <version>2.5.6</version>
</dependency>

配置：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


spring:
 boot:
 admin:
 client:
 url: http://admin.internal.example.com:14396
 instance:
 name: my-service
 prefer-ip: true
management:
 endpoints:
 web:
 exposure:
 include: "*"
 endpoint:
 health:
 show-details: always

重启微服务 → 30 秒后 Admin 后台就能看到这个应用。

3.5 Admin 后台功能

Applications → 点击应用：

Details：基本信息
Metrics：JVM / 内存 / 线程
Environment：配置
Logging：实时日志（Level 实时调整）
JVM：堆栈、线程、GC
Mappings：REST API 列表
Trace：最近 HTTP 请求
Threads：线程详情（可以 dump 堆栈）
Heapdump：下载堆转储

3.6 告警通知

邮件告警（最常用）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


spring:
 mail:
 host: smtp.example.com
 port: 465
 username: noreply@example.com
 password: {{SMTP_PASS}}
 boot:
 admin:
 notify:
 mail:
 enabled: true
 to:
 - ops-team@example.com
 from: noreply@example.com

Slack 告警：

1
2
3
4
5
6
7
8


spring:
 boot:
 admin:
 notify:
 slack:
 enabled: true
 webhook-url: https://hooks.slack.com/services/{{TOKEN}}
 channel: '#alerts'

钉钉告警（自定义 NotificationListener）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


@Component
public class DingTalkNotifier implements Notifier {
 @Override
 public void notify(InstanceEvent event) {
 if (event instanceof InstanceStatusChangedEvent) {
 // 调钉钉 Webhook
 sendToDingTalk(((InstanceStatusChangedEvent) event).getInstance().getRegistration().getName());
 }
 }
}

四、限流 vs 监控告警的配合

场景	Sentinel	Spring Boot Admin
应用崩溃	熔断防止雪崩	告警 + JVM 监控
接口慢	慢调用比例熔断	Thread dump 分析
流量激增	QPS 限流	QPS / TPS 指标
内存爆	（不管）	JVM 内存告警
依赖服务挂	熔断下游	Health Check 告警

生产推荐两者都上——Sentinel 做"主动防御"，Admin 做"被动感知"。

五、典型坑位

5.1 Sentinel Dashboard 看不到应用

修复：

1
2
3
4
5
6


spring:
 cloud:
 sentinel:
 transport:
 dashboard: localhost:18080  # 用 IP，不用 localhost
 eager: true # 启动时主动注册

触发初始化：访问任意接口（Sentinel 是懒加载，没人调用就不知道有这个接口）。

5.2 限流规则不生效

修复：

1
2
3
4
5


// 1. 必须加 @SentinelResource
@SentinelResource(value = "createOrder", blockHandler = "handleBlock")

// 2. 或者用 URL 流控（不推荐）
// Dashboard → 流控规则 → 资源名填 /order/create

5.3 Admin 显示应用 OFFLINE

修复：

1
2
3
4
5
6


spring:
 boot:
 admin:
 client:
 instance:
 prefer-ip: true

应用注册到 Admin 时用 IP，不是 hostname。

5.4 Admin 看不到日志

修复：

1
2
3
4
5


logging:
 file:
 name: /app/logs/myapp.log
 pattern:
 file: "%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n"

日志文件路径必须固定，Admin 才能拉取。

六、生产级架构

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


 ┌─────────────────┐
 │ Spring Cloud │
 │ Gateway │
 └────────┬────────┘
 │
 ┌──────────────────────┼──────────────────────┐
 │ │ │
 ┌──────▼──────┐ ┌───────▼──────┐ ┌───────▼──────┐
 │ service-a │ │ service-b │ │ service-c │
 └──────┬──────┘ └───────┬──────┘ └───────┬──────┘
 │ │ │
 │ 注册信息 + 健康检查 + JVM 指标 │
 └──────────────────────┼──────────────────────┘
 │
 ┌──────────▼──────────┐
 │ Spring Boot Admin │
 │ Dashboard │
 └─────────────────────┘
 │
 ┌──────────▼──────────┐
 │ Sentinel │
 │ Dashboard │
 └─────────────────────┘

所有微服务都做 3 件事：

注册到 Nacos
监控到 Spring Boot Admin
限流配置到 Sentinel

七、Spring Boot Admin 高级用法

7.1 日志级别动态调整

Admin 后台 → Logs → 选择 logger → 改 level（如 INFO → DEBUG）。

实时生效，不需要重启应用。

7.2 线程 Dump

Admin 后台 → Threads → Download → 拿 .tdump 文件分析。

典型场景：应用 hang 住时直接 dump 线程看是哪里卡了。

7.3 Heap Dump

Admin 后台 → Heapdump → 下载 .hprof → 用 VisualVM / MAT 分析内存泄漏。

7.4 集成 Spring Security

Admin 后台默认无认证——生产必加：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


@Configuration
public class SecurityConfig {
 @Bean
 public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
 http
 .authorizeHttpRequests(authz -> authz
 .requestMatchers("/login", "/css/**", "/js/**").permitAll()
 .anyRequest().authenticated()
 )
 .formLogin(Customizer.withDefaults());
 return http.build();
 }
}

八、最佳实践清单

Sentinel + Spring Boot Admin 一起上——防御 + 监控双保险
Sentinel 规则持久化到 Nacos——重启不丢
Admin 后台加 Spring Security——避免被公网访问
限流阈值用真实压测数据——不要拍脑袋
熔断时长 10s 起——给下游恢复时间
告警分级——P0（立即响应）/ P1（小时级）/ P2（日级）
告警去重——同一问题 5 分钟内只发一次
告警值班——on-call 机制，避免"狼来了"
JVM 指标进 Prometheus——长期趋势分析
链路追踪进 SkyWalking——慢调用根因分析

2024+ 视角补充

本文写于 2020-06，2024-2026 期间 Java 微服务治理关键演进：

Sentinel 1.8.6+ → 1.8.8+（2024-2025）：Spring Boot 3.x 兼容；JDK 17+ 强制；OpenTelemetry 集成——指标 / Trace 全打通
Sentinel 2.0 路线图（2025-Q3）：AI 限流（基于 LLM 流量预测）；自适应并发（自动调整阈值）
Spring Boot Admin 3.x（2024-2025）：Spring Boot 3.x 兼容；Micrometer Tracing 集成；WebFlux 异步应用监控
微服务治理生态（2024-2026）：
- Spring Cloud Alibaba 2023.0+：Nacos 2.x + Sentinel 1.8+ + Seata 1.8+ + RocketMQ 5.x 一站式
- Spring Cloud 2024+：逐步被 Spring Cloud OpenFeign + 独立组件取代——“Spring Cloud 套件"模式弱化
- Service Mesh（Istio 1.20+ / Linkerd 2.15+）：限流 / 熔断下沉到 Sidecar，Java 业务代码不写限流逻辑——2024+ 趋势
- 可观测三件套：Micrometer + Prometheus + Grafana + Tempo（Trace）——Sentinel 与 OpenTelemetry 融合
Spring Cloud Gateway 4.x（2024）：Reactor 2024+；Spring Cloud LoadBalancer（替代 Ribbon）
云原生时代：Spring Boot 3.4+ + K8s 1.30+ + Istio 1.20+ 是 2025+ Java 微服务黄金组合

实战建议（2025-2026 视角）：

传统 Spring Cloud 套件 → Spring Cloud Alibaba 2023.0.x 仍是 2024+ 稳态
K8s 上 → Service Mesh 优先（限流 / 熔断下沉 Sidecar）
AI 监控 → Micrometer + OpenTelemetry + LLM 异常检测（2025+ 实验性）
存量项目 → 升 Spring Boot 3.4+ + JDK 21 是 2025+ 主路线

下一步

想看 JDK 自建镜像实战（Alpine / Debian / Ubuntu）→ JDK 自建镜像实战
想看 Java 应用 Docker 化（Tomcat / Spring Boot 打包）→ Java 应用 Docker 化
想看 XXL-Job 分布式调度（任务调度平台）→ XXL-Job 分布式调度
想看 Nginx 自建镜像实战（反代安全加固）→ Nginx 自建镜像实战

Spring-Boot-Admin on Liangweidong's blog