原版文档:
文档:Spring Boot Actuator.note
链接:http://note.youdao.com/noteshare?id=fca965ad3f7ae3f79260d09056f0af6d&sub=827C15DFB1A440E0B6C6C1A947AE3132
一、什么是 Actuator
二、集成 Actuator
三、Endpoints 介绍
四、端点配置
默认暴露
暴露配置
路径映射
管理端口调整
端点响应缓存
五、端点保护
六、重要端点解析
/health 端点
/metrics 端点
/loggers 端点
/info 端点
/beans 端点
/heapdump 端点
/threaddump 端点
七、自定义Endpoint
八、Spring Boot Admin
1、添加相关依赖
2、启动类添加软件
3、将服务注册到 Spring Boot Admin
一、什么是 Actuator
Spring Boot Actuator 模块提供了生产级别的功能,比如健康检查,审计,指标收集,HTTP 跟踪等,帮助我们监控和管理Spring Boot 应用。
这个模块是一个采集应用内部信息暴露给外部的模块,上述的功能都可以通过HTTP 和 JMX 访问。
因为暴露内部信息的特性,Actuator 也可以和一些外部的应用监控系统整合(Prometheus, Graphite, DataDog, Influx, Wavefront, New Relic等)。
这些监控系统提供了出色的仪表板,图形,分析和警报,可帮助你通过一个统一友好的界面,监视和管理你的应用程序。
Actuator使用Micrometer与这些外部应用程序监视系统集成。这样一来,只需很少的配置即可轻松集成外部的监控系统。
Micrometer 为 Java 平台上的性能数据收集提供了一个通用的 API,应用程序只需要使用 Micrometer 的通用 API 来收集性能指标即可。
Micrometer 会负责完成与不同监控系统的适配工作。这就使得切换监控系统变得很容易。
需要注意的是:
SpringBoot 1.x 和 2.x 的 Actuator 监控设定差超多,不仅提供的 endpoint 路径不一样,连 application.properties 的配置也不一样,此处介绍的为 SpringBoot 2.x 版本。
二、集成 Actuator
如果要使用 SpringBoot Actuator 提供的监控功能,需要先加入相关的 maven dependency:
org.springframework.boot
spring-boot-starter-actuator
2.3.4.RELEASE
只要加上了这个 maven dependency,SpringBoot 在运行时就会自动开启和这两个 endpoint,我们就可以透过这两个 endpoint 查看当前 SpringBoot 运行的情况。/actuator/health/actuator/info
Actuator 其实还提供更多样化的 endpoint 让我们监控 SpringBoot Application,但是因为安全因素,所以需要另外设置才能打开这些 endpoint,详细的设置方式下面解说。
访问,查看暴露出来的端点:http://localhost:8099/actuator
{
“_links”: {
“self”: {
“href”: “http://localhost:28088/actuator”,
“templated”: false
},
“health”: {
“href”: “http://localhost:28088/actuator/health”,
“templated”: false
},
“health-path”: {
“href”: “http://localhost:28088/actuator/health/{*path}”,
“templated”: true
},
“info”: {
“href”: “http://localhost:28088/actuator/info”,
“templated”: false
}
}
}
三、Endpoints 介绍
Spring Boot 提供了所谓的 endpoints (下文翻译为端点)给外部来与应用程序进行访问和交互。
打比方来说, 端点 提供了关于应用健康情况的一些基础信息。 端点提供了一些有用的应用程序指标(JVM 内存使用、系统CPU使用等)。/healthmetrics
这些 Actuator 模块本来就有的端点我们称之为原生端点。 根据端点的作用的话,我们大概可以分为三大类:
应用配置类:获取应用程序中加载的应用配置、环境变量、自动化配置报告等与Spring Boot应用密切相关的配置类信息。
度量指标类:获取应用程序运行过程中用于监控的度量指标,比如:内存信息、线程池信息、HTTP请求统计等。
操作控制类:提供了对应用的关闭等操作类功能。
需要注意的就是:
每一个端点都可以通过配置来单独禁用或者启动
不同于Actuator 1.x,Actuator 2.x 的大多数端点默认被禁掉。 Actuator 2.x 中的默认端点增加了前缀。 默认暴露的两个端点为和 /actuator/actuator/health/actuator/info
Actuator 提供的所有 endpoint:
HTTP方法 Endpoint 描述
GET /actuator 查看有哪些 Actuator endpoint 是开放的
GET /actuator/auditevent 查看 audit 的事件,例如认证进入、订单失败,需要搭配 Spring security 使用,sample code
GET /actuator/beans 查看运行当下里面全部的 bean,以及他们的关系
GET /actuator/conditions 查看自动配置的结果,记录哪些自动配置条件通过了,哪些没通过
GET /actuator/configprops 查看注入带有 @ConfigurationProperties 类的 properties 值为何(包含默认值)
GET /actuator/env (常用) 查看全部环境属性,可以看到 SpringBoot 加载了哪些 properties,以及这些 properties 的值(但是会自动掉带有 key、password、secret 等关键词的 properties 的值,保护安全信息)*
GET /actuator/flyway 查看 flyway DB 的 migration 信息
GET /actuator/health (常用) 查看当前 SpringBoot 运行的健康指标,值由 HealthIndicator 的实现类提供(所以可以自定义一些健康指标信息,加到这里面)
GET /actuator/heapdump 取得 JVM 当下的 heap dump,会下载一个档案
GET /actuator/info 查看 properties 中 info 开头的属性的值,没啥用
GET /actuator/mappings 查看全部的 endpoint(包含 Actuator 的),以及他们和 Controller 的关系
GET /actuator/metrics(常用) 查看有哪些指标可以看(ex: jvm.memory.max、system.cpu.usage),要再使用分别查看各指标的详细信息/actuator/metrics/{metric.name}
GET /actuator/scheduledtasks 查看定时任务的信息
POST /actuator/shutdown 唯一一个需要 POST 请求的 endpoint,关闭这个 SpringBoot 程序
四、端点配置
默认暴露
我们可以通过以下配置,来配置通过JMX 和 HTTP 暴露的端点。
Property Default
management.endpoints.jmx.exposure.exclude
management.endpoints.jmx.exposure.include *
management.endpoints.web.exposure.exclude
management.endpoints.web.exposure.include info, healt
因为安全的因素,所以 Actuator 默认只会开放和这两个 endpoint,如果要开放其他 endpoint 的话,需要额外在 application.properties 中做设置。/actuator/health/actuator/info
暴露配置
#可以这样写,就会开启所有endpoints(不包含shutdown)
management.endpoints.web.exposure.include=*
#也可以这样写,就只会开启指定的endpoint,因此此处只会再额外开启/actuator/beans和/actuator/mappings
management.endpoints.web.exposure.include=beans,mappings
management.endpoints.web.exposure.exclude=beans
management.endpoints.web.exposure.include=*
#如果要开启/actuator/shutdown,要额外再加这一行
management.endpoint.shutdown.enabled=true
路径映射
默认情况下所有端点都暴露在“/actuator”路径下,也可以改變的路徑,可以自定義成自己想要的:/actuator
#这样写的话,原本内置的/actuator/xxx路径,都会变成/manage/xxx,可以用来防止被其他人猜到
management.endpoints.web.base-path=/manage
#同时可以将health修改成healthcheck
management.endpoints.web.path-mapping.health=healthcheck
管理端口调整
#指定端口,默认跟server.port一样,可以防止被其他人猜到
management.server.port=10111
端点响应缓存
对于一些不带参数的端点请求会自动进行缓存,我们可以通过如下方式配置缓存时间,下面配置表示 beans 端点的缓存时间为 100s
management.endpoint.beans.cache.time-to-live=100s
五、端点保护
如果开启了 Actuator 默认不打开的 endpoints,建议一定要加上 Spring security 之类的做 endpoint 保护,避免重要信息外泄。 因为端点的信息和产生的交互都是非常敏感的,必须防止未经授权的外部访问。
这里我们使用 Spring Security 保护,首先添加相关依赖:
org.springframework.boot
spring-boot-starter-security
添加之后,我们需要定义安全校验规则,来覆盖Spring Security 的默认配置。
这里我给出了两个版本的模板配置:
import org.springframework.boot.actuate.autoconfigure.security.servlet.EndpointRequest;
import org.springframework.boot.actuate.context.ShutdownEndpoint;
import org.springframework.boot.autoconfigure.security.servlet.PathRequest;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
@Configuration
public class ActuatorSecurityConfig extends WebSecurityConfigurerAdapter {
/*
* version1:
* 1. 限制 '/shutdown'端点的访问,只允许ACTUATOR访问
* 2. 允许外部访问其他的端点
* 3. 允许外部访问静态资源
* 4. 允许外部访问 '/'
* 5. 其他的访问需要被校验
* version2:
* 1. 限制所有端点的访问,只允许ACTUATOR访问
* 2. 允许外部访问静态资源
* 3. 允许外部访问 '/'
* 4. 其他的访问需要被校验
*/
@Override
protected void configure(HttpSecurity http) throws Exception {
// version1
// http
// .authorizeRequests()
// .requestMatchers(EndpointRequest.to(ShutdownEndpoint.class))
// .hasRole(“ADMIN”)
// .requestMatchers(EndpointRequest.toAnyEndpoint())
// .permitAll()
// .requestMatchers(PathRequest.toStaticResources().atCommonLocations())
// .permitAll()
// .antMatchers(“/”)
// .permitAll()
// .antMatchers(“/**”)
// .authenticated()
// .and()
// .httpBasic();
// version2
http
.authorizeRequests()
.requestMatchers(EndpointRequest.toAnyEndpoint())
.hasRole("ADMIN")
.requestMatchers(PathRequest.toStaticResources().atCommonLocations())
.permitAll()
.antMatchers("/")
.permitAll()
.antMatchers("/**")
.authenticated()
.and()
.httpBasic();
}
}
application.properties的相关配置如下:
spring.security.user.name=actuator
spring.security.user.password=actuator
spring.security.user.roles=ADMIN
我们使用浏览器访问 http://localhost:8080/actuator/health 端点接口,会先弹出个登录框,只有登录后才能访问。
六、重要端点解析
/health 端点
/health配置
当我们开启health的健康端点时,我们能够查到应用健康信息是一个汇总的信息,访问 http://127.0.0.1:10111/actuator/health时,我们获取到的信息是{“status”:“UP”} ,status的值还有可能是 DOWN。
要想查看详细的应用健康信息需要配置:
management.endpoint.health.show-details=always
该属性可以使用以下值之一进行配置:
never:不展示详细信息,up或者down的状态,默认配置
when-authorized:详细信息将会展示给通过认证的用户。 授权的角色可以通过配置management.endpoint.health.roles
always:对所有用户暴露详细信息
按照上述配置,配置成之后,我们启动项目再次访问 http://127.0.0.1:10111/actuator/health,获取的信息如下:always
{
“status”: “UP”,
“components”: {
“db”: {
“status”: “UP”,
“details”: {
“database”: “MySQL”,
“validationQuery”: “isValid()”
}
},
“diskSpace”: {
“status”: “UP”,
“details”: {
“total”: 336325505024,
“free”: 302146060288,
“threshold”: 10485760,
“exists”: true
}
},
“ping”: {
“status”: “UP”
}
}
}
从上面的应用的详细健康信息发现,健康信息包含磁盘空间、redis、DB,启用监控的这个spring boot应用确实是连接了redis和oracle DB,actuator就自动给监控起来了,确实是很方便、很有用。
/health端点有很多自动配置的健康指示器:如redis、rabbitmq、db等组件。 当你的项目有依赖对应组件的时候,这些健康指示器就会被自动装配,继而采集对应的信息。
如上面的 diskSpace 节点信息就是 在起作用。DiskSpaceHealthIndicator
上述截图取自官方文档。
当如上的组件有一个状态异常,应用服务的整体状态即为down。 我们也可以通过配置禁用某个组件的健康监测。
management.health.mongo.enabled: false
或者禁用所有自动配置的健康指示器:
management.health.defaults.enabled: false
/health原理
Spring boot的健康信息都是从ApplicationContext中的各种Beans中收集到的,Spring boot框架中包含了大量的HealthIndicators的实现类,当然你也可以实现自己认为的健康状态。HealthIndicator
默认情况下,最终的spring boot应用的状态是由汇总而成的,汇总的算法是:HealthAggregator
设置状态码顺序:。setStatusOrder(Status.DOWN, Status.OUT_OF_SERVICE, Status.UP, Status.UNKNOWN)
过滤掉不能识别的状态码。
如果无任何状态码,整个spring boot应用的状态是 UNKNOWN。
将所有收集到的状态码按照 1 中的顺序排序。
返回有序状态码序列中的第一个状态码,作为整个spring boot应用的状态。
源代码请参见:。org.springframework.boot.actuate.health.OrderedHealthAggregator
Spring boot框架自带的 HealthIndicators 目前包括:
名字 描述
CassandraHealthIndicator 检查 Cassandra 数据库是否已启动。
DiskSpaceHealthIndicator 检查磁盘空间是否不足。
DataSourceHealthIndicator 检查是否可以获取 到 的连接。DataSource
ElasticsearchHealthIndicator 检查 Elasticsearch 集群是否已启动。
InfluxDbHealthIndicator 检查 InfluxDB 服务器是否已启动。
JmsHealthIndicator 检查 JMS 代理是否已启动。
MailHealthIndicator 检查邮件服务器是否已启动。
MongoHealthIndicator 检查 Mongo 数据库是否已启动。
Neo4jHealthIndicator 检查 Neo4j 服务器是否已启动。
RabbitHealthIndicator 检查 Rabbit 服务器是否已启动。
RedisHealthIndicator 检查 Redis 服务器是否已启动。
SolrHealthIndicator 检查 Solr 服务器是否已启动。
你可以通过management.health.defaults.enabled这个配置项将它们全部禁用掉,也可以通过management.health.xxxx.enabled将其中任意一个禁用掉。
自定义 HealthIndicator
有时候需要提供自定义的健康状态检查信息,你可以通过实现HealthIndicator的接口来实现,并将该实现类注册为spring bean。
你需要实现其中的health()方法,并返回自定义的健康状态响应信息,该响应信息应该包括一个状态码和要展示详细信息。
例如,下面就是一个接口HealthIndicator的实现类:
import org.springframework.boot.actuate.health.Health;
import org.springframework.boot.actuate.health.HealthIndicator;
import org.springframework.stereotype.Component;
@Component
public class MyHealthIndicator implements HealthIndicator {
@Override
public Health health() {
int errorCode = check(); // perform some specific health check
if (errorCode != 0) {
return Health.down().withDetail("Error Code", errorCode).build();
}
return Health.up().build();
}
}
另外,除了Spring boot定义的几个状态类型,我们也可以自定义状态类型,用来表示一个新的系统状态。
在这种情况下,你还需要实现接口 HealthAggregator ,或者通过配置 management.health.status.order 来继续使用HealthAggregator的默认实现。
例如,在你自定义的健康检查HealthIndicator的实现类中,使用了自定义的状态类型FATAL,为了配置该状态类型的严重程度,你需要在application的配置文件中添加如下配置:
management.health.status.order=FATAL, DOWN, OUT_OF_SERVICE, UNKNOWN, UP
在做健康检查时,响应中的HTTP状态码反应了整体的健康状态,(例如,UP 对应 200, 而 OUT_OF_SERVICE 和 DOWN 对应 503)。
同样,你也需要为自定义的状态类型设置对应的HTTP状态码,例如,下面的配置可以将 FATAL 映射为 503(服务不可用):
management.health.status.http-mapping.FATAL=503
如果你需要更多的控制,你可以定义自己的 HealthStatusHttpMapper bean。
下面是内置健康状态类型对应的HTTP状态码列表:
Status Mapping
DOWN SERVICE_UNAVAILABLE (503)
OUT_OF_SERVICE SERVICE_UNAVAILABLE (503)
UP No mapping by default, so http status is 200
UNKNOWN No mapping by default, so http status is 200
/metrics 端点
默认关闭状态,需要设置
查看所有可追踪的度量
/metrics端点用来返回当前应用的各类重要度量指标,比如:内存信息、线程信息、垃圾回收信息、tomcat、数据库连接池等。
{
“names”: [
“hikaricp.connections”,
“hikaricp.connections.acquire”,
“hikaricp.connections.active”,
“hikaricp.connections.creation”,
“hikaricp.connections.idle”,
“hikaricp.connections.max”,
“hikaricp.connections.min”,
“hikaricp.connections.pending”,
“hikaricp.connections.timeout”,
“hikaricp.connections.usage”,
“jvm.buffer.count”,
“jvm.buffer.memory.used”,
“jvm.buffer.total.capacity”,
“jvm.classes.loaded”,
“jvm.classes.unloaded”,
“jvm.gc.live.data.size”,
“jvm.gc.max.data.size”,
“jvm.gc.memory.allocated”,
“jvm.gc.memory.promoted”,
“jvm.gc.pause”,
“jvm.memory.committed”,
“jvm.memory.max”,
“jvm.memory.used”,
“jvm.threads.daemon”,
“jvm.threads.live”,
“jvm.threads.peak”,
“jvm.threads.states”,
“logback.events”,
“process.cpu.usage”,
“process.start.time”,
“process.uptime”,
“system.cpu.count”,
“system.cpu.usage”,
“tomcat.cache.access”,
“tomcat.cache.hit”,
“tomcat.global.error”,
“tomcat.global.received”,
“tomcat.global.request”,
“tomcat.global.request.max”,
“tomcat.global.sent”,
“tomcat.servlet.error”,
“tomcat.servlet.request”,
“tomcat.servlet.request.max”,
“tomcat.sessions.active.current”,
“tomcat.sessions.active.max”,
“tomcat.sessions.alive.max”,
“tomcat.sessions.created”,
“tomcat.sessions.expired”,
“tomcat.sessions.rejected”,
“tomcat.threads.busy”,
“tomcat.threads.config.max”,
“tomcat.threads.current”,
“zipkin.reporter.messages”,
“zipkin.reporter.messages.total”,
“zipkin.reporter.queue.bytes”,
“zipkin.reporter.queue.spans”,
“zipkin.reporter.spans”,
“zipkin.reporter.spans.dropped”,
“zipkin.reporter.spans.total”
]
}
查看某个度量的详细信息
不同于1.x,Actuator在这个界面看不到具体的指标信息,只是展示了一个指标列表。为了获取到某个指标的详细信息,我们可以请求具体的指标信息,像这样:
localhost:28088/actuator/metrics/jvm.memory.max
{
“name”: “jvm.memory.max”,
“description”: “The maximum amount of memory in bytes that can be used for memory management”,
“baseUnit”: “bytes”,
“measurements”: [
{
“statistic”: “VALUE”,
“value”: 5577375743
}
],
“availableTags”: [
{
“tag”: “area”,
“values”: [
“heap”,
“nonheap”
]
},
{
“tag”: “id”,
“values”: [
“Compressed Class Space”,
“PS Old Gen”,
“PS Survivor Space”,
“Metaspace”,
“PS Eden Space”,
“Code Cache”
]
}
]
}
你也可以用query param的方式查看单独的一块区域。比如你可以访问。结果就是:
localhost:28088/actuator/metrics/jvm.memory.max?tag=id:Metaspace
{
“name”: “jvm.memory.max”,
“description”: “The maximum amount of memory in bytes that can be used for memory management”,
“baseUnit”: “bytes”,
“measurements”: [
{
“statistic”: “VALUE”,
“value”: -1
}
],
“availableTags”: [
{
“tag”: “area”,
“values”: [
“nonheap”
]
}
]
}
添加自定义统计指标
除了使用 metrics 端点默认的这些统计指标外,我们还可以实现自定义统计指标。Metrics 提供 4 种基本的度量类型:Gauge、Counter、Timer、Summary。下面分别进行介绍。
1,Gauge(计量器)
Gauge(计量器)是最简单的度量类型,只有一个简单的返回值,他用来记录一些对象或者事物的瞬时值。
(1)假设我们在一个 Contoller 使用一个类型为 Gauge 的计数器来记录一个数值:
1,Gauge(计量器)
Gauge(计量器)是最简单的度量类型,只有一个简单的返回值,他用来记录一些对象或者事物的瞬时值。
(1)假设我们在一个 Contoller 使用一个类型为 Gauge 的计数器来记录一个数值:
(2)通过 /actuator/metrics 接口可以看到我们自定义的这个指标:
(3)假设我们访问了 /hello 接口后,再次通过 /actuator/metrics/user.test.gauge 这个自定义度量的消息信息,显示如下:
2,Counter(计数器)
Counter(计数器)简单理解就是一种只增不减的计数器。它通常用于记录服务的请求数量、完成的任务数量、错误的发生数量等等。
(1)为方便使用首先我们自定义一个计数器服务:
@Service
public class MyCounterService {
static final Counter userCounter = Metrics.counter(“user.counter.total”, “services”, “demo”);
public void processCollectResult() {
userCounter.increment(1D);
}
}
(2)然后增加一个 controller,触发这个服务:
@RestController
public class HelloController {
@Autowired
MyCounterService myCounterService;
@GetMapping("/hello")
public void hello() {
myCounterService.processCollectResult();
}
}
(3)通过 /actuator/metrics 接口可以看到我们自定义的这个指标:
(4)假设我们访问了 3 次 /hello 接口,再次通过 /actuator/metrics/user.counter.total 这个自定义度量的消息信息,显示如下:
3,Timer(计时器)
Timer(计时器)可以同时测量一个特定的代码逻辑块的调用(执行)速度和它的时间分布。
简单来说,就是在调用结束的时间点记录整个调用块执行的总时间,适用于测量短时间执行的事件的耗时分布,例如消息队列消息的消费速率。
(1)假设我们在一个 Contoller 使用 Timer 来记录某个方法的执行时长:
注意:在实际生产环境中,可以通过 spring-aop 把记录方法耗时的逻辑抽象到一个切面中,这样就能减少不必要的冗余的模板代码。
@RestController
public class HelloController {
private Timer timer = Metrics.timer("user.test.timer","timer", "timersample");
@GetMapping("/hello")
public void hello() {
// 执行createOrder方法并记录执行时间
timer.record(() -> createOrder());
}
//模拟方法耗时
private void createOrder() {
try {
TimeUnit.SECONDS.sleep(3);
} catch (InterruptedException e) {
}
}
}
(2)假设我们访问了 3 次 /hello 接口,再次通过 /actuator/metrics/user.test.timer 这个自定义度量的消息信息,显示如下:
4,Summary(摘要)
Summary(摘要)用于跟踪事件的分布。它类似于一个计时器,但更一般的情况是,它的大小并不一定是一段时间的测量值。
在 micrometer 中,对应的类是 DistributionSummary,它的用法有点像 Timer,但是记录的值是需要直接指定,而不是通过测量一个任务的执行时间。
(1)假设我们在一个 Contoller 使用 Summary 来连续记录三次值:
@RestController
public class HelloController {
private DistributionSummary summary = Metrics.summary("user.test.summary","summary", "summarysample");
@GetMapping("/hello")
public void hello() {
summary.record(2D);
summary.record(3D);
summary.record(4D);
}
}
(2)假设我们访问 /hello 接口后,再次通过 /actuator/metrics/user.test.summary 这个自定义度量的消息信息,显示如下:
/loggers 端点
查看日志等级
/loggers 端点暴露了我们程序内部配置的所有logger的信息。我们访问可以看到:/actuator/loggers
你也可以通过下述方式访问单独一个logger:
http://localhost:8080/actuator/loggers/{name}
比如我现在访问 logger,roothttp://localhost:8080/actuator/loggers/root:
{
“configuredLevel”: “INFO”,
“effectiveLevel”: “INFO”
}
改变运行时日志等级
/loggers端点能够动态修改你的日志等级。
比如,我们可以通过以下几种方式来修改 logger的日志等级。我们只需要发起一个URL 为的请求,POST报文如下:roothttp://localhost:8080/actuator/loggers/rootPOST
{
“configuredLevel”: “DEBUG”
}
1、使用工具修改:
2、使用浏览器修改:
先在chrome浏览器中,按F12打开console(控制台);然后执行以下脚本(url参数根据自己需求进行修改),回车执行。
fetch(new Request(‘http://localhost:8080/masl/actuator/loggers/ROOT’,{
method:‘POST’,
headers: {‘Content-Type’: ‘application/json;charset=UTF-8’},
body:“{“configuredLevel”: “DEBUG”}”
})).then((resp)=>{console.log(resp)})
3、使用shell脚本修改:
curl -X “POST” “http://localhost:8080/masl/actuator/loggers/ROOT” -H “Content-Type: application/json;charset=UTF-8” -d ‘{“configuredLevel”: “DEBUG”}’
仔细想想,这个功能是不是非常有用。还可以只修改某个类的日志级别(把上面的ROOT替换成类的全路径,如:com.zat.asl.MaslApplication)
如果在生产环境中,你想要你的应用输出一些Debug信息以便于你诊断一些异常情况,你只需要按照上述方式就可以修改,而不需要重启应用。
/info 端点
/info端点可以用来展示应用信息,主要包含三大类:自定义信息、Git 信息、以及项目构建信息。下面主要介绍自定义信息。
(1)自定义信息可以在 application.properties 配置文件中添加,这些以 info 开头的信息将在 info 端点中显示出来:
info.app.name=actuator-test-demo
info.app.encoding=UTF-8
info.app.java.source=1.8
info.app.java.target=1.8
(2)我们也可以通过 Java 代码自定义信息,只需要将自定义类继承自 InfoContributor,然后实现该类中的 contribute 方法即可:
@Component
public class MyInfo implements InfoContributor {
@Override
public void contribute(Info.Builder builder) {
Map
info.put(“name”, “航歌”);
info.put(“email”, “[email protected]”);
builder.withDetail(“author”, info);
}
}
/beans 端点
/beans端点会返回Spring 容器中所有bean的别名、类型、是否单例、依赖等信息。
访问,返回如下:http://localhost:8080/actuator/beans
/heapdump 端点
访问:会自动生成一个 Jvm 的堆文件 heapdump。我们可以使用 JDK 自带的 Jvm 监控工具 VisualVM 打开此文件查看内存快照。http://localhost:8080/actuator/heapdump
/threaddump 端点
这个端点我个人觉得特别有用,方便我们在日常定位问题的时候查看线程的情况。 主要展示了线程名、线程ID、线程的状态、是否等待锁资源、线程堆栈等信息。就是可能查看起来不太直观。
访问返回如下:http://localhost:8080/actuator/threaddump
这个端点属于操作控制类端点,可以优雅关闭 Spring Boot 应用。要使用这个功能首先需要在配置文件中开启:
management.endpoint.shutdown.enabled=true
由于 shutdown 接口默认只支持 POST 请求,我们启动Demo项目,发起请求:POST
curl -X “POST” “http://localhost:8080/actuator/shutdown”
返回信息:
{
“message”: “Shutting down, bye…”
}
然后应用程序被关闭。类似停服的操作还有很多,比如restart、pause等。可根据具体版本进行配置。
由于开放关闭应用的操作本身是一件非常危险的事,所以真正在线上使用的时候,我们需要对其加入一定的保护机制,
比如:定制Actuator的端点路径、整合Spring Security进行安全校验等。(不是特别必要的话,这个端点不用开)。
定制Actuator的端点路径和端口:
management.endpoints.web.base-path 自定义shutdown的请求路径;
management.server.address 设置为本地ip,防止远程访问该连接进行关闭服务;
management.server.port 自定义shutdown请求路径的端口号;
调整后的配置文件如下:
management:
endpoint:
shutdown:
enabled: true
endpoints:
web:
exposure:
include: ‘’
jmx:
exposure:
include: '’
server:
# 自定义端口
port: 8888
# 不允许远程管理连接,安全性考虑
address: 127.0.0.1
七、自定义Endpoint
默认的端点虽然可以满足大多数的需求,但一些特殊的需求还是需要能够支持自定义端点的。
自定义 Endpoint 端点,只需要在我们的新建Bean上使用 @Endpoint 注解即可, Bean 中的方法就可以通过 JMX 或者 HTTP 公开。
除此之外,还可以使用 @JmxEndpoint 或 @WebEndpoint 编写 EndPoint。但这些 EndPoint 仅限于各自的公开方式。例如,@WebEndpoint 仅通过HTTP公开,而不通过JMX公开。
那么是不是类中所有的方法都支持对外公开呢?
很明显不是的。Actuator提供了三个用于方法上的注解,只有加三个注解的方法才支持对外公开,并且每个注解都有支持它的HTTP method。
@ReadOperation对应HTTP的GET请求
@WriteOperation对应HTTP的POST请求
@DeleteOperation对应HTTP的DELETE请求
@Component
@Endpoint(id = “my”)
public class EndpointCustom {
@ReadOperation
public String endpointCustomRead(String content) {
return "请求的内容: " + content;
}
@WriteOperation
public String endpointCustomWrite(String content) {
return "写的内容: " + content;
}
@DeleteOperation
public String endpointCustomDelete(String content) {
return "删除的内容: " + content;
}
}
对应GET请求:
curl -X GET http://localhost:8080/actuator/my?content=endpointGet
执行之后,会返回信息“请求的内容: endpointGet”。
同样的POST请求为:
curl -X POST http://localhost:8080/actuator/my?content=endpointPost
DELETE请求为:
curl -X DELETE http://localhost:8080/actuator/my?content=endpointDELETE
上面只是简单自定义实例,根据具体的业务场景,可以定义更加丰富的端点实现。
八、Spring Boot Admin
Spring Boot 有一个非常好用的监控和管理的源软件,这个软件就是 Spring Boot Admin。该软件能够将 Actuator 中的信息进行界面化的展示,也可以监控所有 Spring Boot 应用的健康状况,提供实时警报功能。
主要的功能点有:
显示应用程序的监控状态
应用程序上下线监控
查看 JVM,线程信息
可视化的查看日志以及下载日志文件
动态切换日志级别
Http 请求信息跟踪
其他功能点……
1、添加相关依赖
org.springframework.boot
spring-boot-starter-web
2、启动类添加软件
@EnableAdminServer
@SpringBootApplication
public class ActuatorAdminApplication {
public static void main(String[] args) {
SpringApplication.run(ActuatorAdminApplication.class, args);
}
}
启动成功
3、将服务注册到 Spring Boot Admin
添加依赖
de.codecentric
spring-boot-admin-starter-client
2.3.1
添加配置
spring.boot.admin.client.url:Spring Boot Admin 服务端地址。
spring.boot.admin.client.url=http://localhost:4444
4、登录admin首页查看应用状态
http://localhost:4444/wallboard
基本信息如下:
日志配置