聊一聊SpringBoot服务监控机制
前言
任何一个服务如果没有监控,那就是两眼一抹黑,无法知道当前服务的运行情况,也就无法对可能出现的异常状况进行很好的处理,所以对任意一个服务来说,监控都是必不可少的。
就目前而言,大部分微服务应用都是基于 springboot
来构建,所以了解 springboot
的监控特性是非常有必要的,而 springboot
也提供了一些特性来帮助我们监控应用。
本文基于 springboot 2.3.1.release
版本演示。
springboot 监控
springboot
中的监控可以分为 http
端点和 jmx
两种方式来监控当前应用的运行状况和指标收集
http endpoints 监控
执行器端点允许您监视应用程序并与之交互。springboot
包括许多内置的端点,并允许我们添加自己的端点。可以通过 http
或 jmx
启用或禁用每个端点,并公开(使其可以远程访问)。每个端点都有一个唯一的 id
,访问时可以通过如下地址进行访问:http:ip:port/{id}
(springboot 1.x ),而在 springboot 2.x
版本中,默认新增了一个 /actuator
作为基本路,访问地址则对应为 :http:ip:port/actuator/{id}
。
使用 http
监控非常简单,在 springboot
项目中,引入如下依赖:
<dependencies> <dependency> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter-actuator</artifactid> </dependency> </dependencies>
默认就可以通过地址 http:localhost:8080/actuator/health
,访问之后得到如下结果:
springboot
中提供了非常多的默认端点监控,但是出于安全考虑,默认情况下有些端点并不是开启状态,如 shutdown
端点就是默认关闭的。
内置端点
springboot
中默认提供的常用内置端点如下:
端点 id | 描述 |
---|---|
auditevents | 公开当前应用程序的审计事件信息,需要 auditeventrepository bean。 |
beans | 展示程序中所有的 bean。 |
caches | 公开可用的缓存。 |
conditions | 展示配置类或者自动装配类中的条件,以及它们匹配或者不匹配的原因。 |
configprops | 显示所有 @configurationproperties 中的配置属性。 |
env | 显示 configurableenvironment 中的所有环境。 |
health | 显示应用程序运行状况信息。 |
httptrace | 显示 http 跟踪信息(默认情况下统计最近 100 次请求),需要 httptracerepository bean。 |
info | 显示任意程序信息。 |
integrationgraph | 显示 spring 集成图,需要依赖 spring-integration-core。 |
loggers | 展示和修改应用中的 loggers 配置。 |
metrics | 展示当前应用监控指标的度量。 |
mappings | 展示所有 @requestmapping 路径。 |
scheduledtasks | 展示应用中的所有定时任务信息。 |
sessions | 允许从 spring 会话支持的会话存储中检索和删除用户会话。需要使用基于 spring session web应用程序。 |
shutdown | 优雅的关闭程序,默认禁止了该端点的访问。 |
虽然说这里的大部分端点都是默认开启的,但是默认暴露(允许对外访问)的只有 health
和 info
端点,所以如果需要允许端点对外暴露,可以通过如下配置(如果想要暴露所有的端点,则可以直接配置 "*"
):
management: endpoints: web: exposure: include: [health,info,mappings] //或者直接配置 "*"
另外,开启或禁用某一个端点,也可以通过通过如下配置进行动态控制:
management.endpoint.<id>.enabled=true
接下来我们挑选几个重点的端点来介绍一下。
health 端点
health
断点默认只是展示当前应用健康信息,但是我们可以通过另一个配置打开详细信息,这样不仅仅会监控当前应用,还会监控与当前应用相关的其他第三方应用,如 redis
。
management: endpoint: health: show-details: always
这个配置打开之后,我们连接上 redis
之后再次访问 health
端点,就可以展示 redis
服务的健康信息了:
loggers 端点
访问 http://localhost:8080/actuator/loggers
可以查看当前应用的日志级别等信息:
这里面本身并不特别,但是有一个功能却非常有用,比如我们生产环境日志级别一般都是 info
,但是现在有一个 bug
通过 info
级别无法排查,那么我们就可以临时修改 log
级别。
比如上图中的 root
节点是 info
级别,那么我们可以通过 postman
等工具来发一个 post
请求修改日志级别。
修改之后就会发现,日志由原来的 info
变成了 debug
:
metrics 端点
metrics
是一个非常重要的监控端点,其监控内容覆盖了 jvm
内存、堆、类加载、处理器和 tomcat
容器等一些重要指标:
可以看到这里面包含了非常多的指标,任意访问一个指标就可以查看对应的指标信息:
自定义监控端点
通过上面的介绍,可以看到 springboot
提供的监控非常强大,但是就算再全面的监控也不可能满足所有人的需求,所以 springboot
也支持自定义监控端点。
自定义监控端点常用注解
自定义一个监控端点主要有如下常用注解:
- @endpoint:定义一个监控端点,同时支持
http
和jmx
两种方式。 - @webendpoint:定义一个监控端点,只支持
http
方式。 - @jmxendpoint:定义一个监控端点,只支持
jmx
方式。
以上三个注解作用在类上,表示当前类是一个监控端点,另外还有一些注解会用在方法和参数上:
- @readoperation:作用在方法上,可用来返回端点展示的信息(通过
get
方法请求)。 - @writeoperation:作用在方法上,可用来修改端点展示的信息(通过
post
方法请求)。 - @deleteoperation:作用在方法上,可用来删除对应端点信息(通过
delete
方法请求)。 - @selector:作用在参数上,用来定位一个端点的具体指标路由。
来,一起写一个自己的监控端点
定义一个类,并使用 @endpoint
注解标注标识,同时定义几个方法用 @readoperation
和 @writeoperation
注解来标注:
@endpoint(id="myendpoint") @component public class myendpoint { private string status = "up"; private string detail = "一切正常"; // @readoperation // public string test1(){ // return "wolf"; // } // @readoperation // public map<string,string> test2(){ // map<string,string> map = new hashmap(); // map.put("status","up"); // return map; // } @readoperation public jsonobject test3(){ jsonobject jsonobject= new jsonobject(); jsonobject.put("status",status); jsonobject.put("detail",detail); return jsonobject; } @readoperation public jsonobject test3_1(@selector string name){ jsonobject jsonobject= new jsonobject(); if ("status".equals(name)){ jsonobject.put("status",status); }else if ("detail".equals(name)){ jsonobject.put("detail",detail); } return jsonobject; } @writeoperation//动态修改指标 public void test4(@selector string name,@nullable string value){ if (!stringutils.isempty(value)){ if ("status".equals(name)){ status = value; }else if ("detail".equals(name)){ detail = value; } } } }
@component
注解表示将该类交给 spring
进行管理,或者也可以再定义一个 configuration
类来加载该 bean
也可以,当然,如果我们需要提供给第三方使用,如果无法保证当前包名被扫描,则需要使用 springboot
的自动装配机制将该类进行管理。
@readoperation
方法可以返回 string
或者 jsonobject
或者 map
集合等。参数上加了 @selector
注解则表示访问断端点的时候可以直接访问子节点。
完成了上面的类,启动 springboot
应用,接下来就可以直接通过 http://localhost:8080/actuator/myendpoint
进行访问了:
同时,因为 test3_1
方法使用了 @selector
注解,所以我们可以通过这个方法每一个指标的明细:
而带有 @writeoperation
注解的方法可以用来修改指标,这个方法需要用 post
进行访问,访问的参数可以直接使用字符串传参,也可以直接使用 json
进行传参,修改之后再次查看就可以发现指标已经被动态修改:
jmx 监控
jmx
全称为 java management extensions,即 java
管理扩展。它提供了对 java
应用程序和 jvm
的监控管理。通过jmx
我们可以监控服务器中各种资源的使用情况以及线程,内存和 cpu
等使用情况。
打开 jdk
下提供的工具 jconsole
:
打开之后这里会监控到我们已经启动的应用,双击进入:
如何手动注册一个 jmx mbean
定义一个接口 systeminfombean
(注意名字必须要用 mbean
结尾):
public interface systeminfombean { int getcpucore(); long gettotalmemory(); void shutdown(); }
再定义一个类实现 systeminfombean
接口,实现类的明明方式为接口名去掉 mbean
:
public class systeminfo implements systeminfombean { @override public int getcpucore() { return runtime.getruntime().availableprocessors(); } @override public long gettotalmemory() { return runtime.getruntime().totalmemory(); } @override public void shutdown() { system.exit(0); } }
最后就是需要将该实现类进行注册:
public class jmxregistermain { public static void main(string[] args) throws notcompliantmbeanexception, instancealreadyexistsexception, mbeanregistrationexception, malformedobjectnameexception, ioexception { mbeanserver mbeanserver= managementfactory.getplatformmbeanserver(); objectname objectname=new objectname("com.lonely.wolf.note.springboot.actuator.jmx:type=systeminfo"); systeminfo systeminfo =new systeminfo(); mbeanserver.registermbean(systeminfo,objectname);//注册 system.in.read();//防止程序结束 } }
运行该 main
方法,再打开 jconsole
就可以看到成功注册了一个 mbean
:
同样的,spring
当中只要我们使用了 @@endpoint
或者 @jmxendpoint
注解,就会自动帮我们注册一个 mbean
,其原理也是利用了自动装配机制。
其他监控
除了 springboot
自带的监控之外,也有其他第三方开源的强大监控系统,如 prometheus
,而且 springboot
也将其进行了集成,使用 prometheus
时只需要引入如下 jar
包即可:
<dependency> <groupid>io.micrometer</groupid> <artifactid>micrometer-registry-prometheus</artifactid> </dependency>
当然,如果使用 prometheus
的话需要单独安装,而且一般会选择 prometheus
+ grafana
来共同实现一个监控平台,在这里就不做过多介绍,如果感兴趣的朋友可以自己去了解下这两种软件的使用。
总结
本文主要讲述了 spring boot actuator
的使用,并分别介绍了其中两种监控类型 http
和 jmx
,最后通过一个例子来实现了自定义的端点,同时也实现了手动注册一个 mbean
的方法。
到此这篇关于聊一聊springboot服务监控机制的文章就介绍到这了,更多相关springboot服务监控机制内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持!
上一篇: 工作室寒假题单部分思路
下一篇: 如何查看笔记本电脑电池容量?