序
Spring Boot有四大神器，分别是auto-configuration、starters、cli、actuator，本文主要讲actuator。actuator是spring boot提供的对应用系统的自省和监控的集成功能，可以对应用系统进行配置查看、相关功能统计等。
spring-boot-starter-actuator模块的实现对于实施微服务的中小团队来说，可以有效地减少监控系统在采集应用指标时的开发量。当然，它也并不是万能的，有时候我们也需要对其做一些简单的扩展来帮助我们实现自身系统个性化的监控需求。下面，在本文中，我们将详解的介绍一些关于spring-boot-starter-actuator模块的内容，包括它的原生提供的端点以及一些常用的扩展和配置方式。
使用actuator
添加依赖
|
1
2
3
4
|
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actuator</artifactId></dependency> |
主要暴露的功能
| HTTP方法 | 路径 | 描述 | 鉴权 |
|---|---|---|---|
| GET | /autoconfig | 查看自动配置的使用情况 | true |
| GET | /configprops | 查看配置属性，包括默认配置 | true |
| GET | /beans | 查看bean及其关系列表 | true |
| GET | /dump | 打印线程栈 | true |
| GET | /env | 查看所有环境变量 | true |
| GET | /env/{name} | 查看具体变量值 | true |
| GET | /health | 查看应用健康指标 | false |
| GET | /info | 查看应用信息 | false |
| GET | /mappings | 查看所有url映射 | true |
| GET | /metrics | 查看应用基本指标 | true |
| GET | /metrics/{name} | 查看具体指标 | true |
| POST | /shutdown | 关闭应用 | true |
| GET | /trace | 查看基本追踪信息 | true |
/autoconfig
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
{ "positiveMatches": { "AuditAutoConfiguration.AuditEventRepositoryConfiguration": [ { "condition": "OnBeanCondition", "message": "@ConditionalOnMissingBean (types: org.springframework.boot.actuate.audit.AuditEventRepository; SearchStrategy: all) found no beans" } ] }, "negativeMatches": { "CacheStatisticsAutoConfiguration": [ { "condition": "OnBeanCondition", "message": "@ConditionalOnBean (types: org.springframework.cache.CacheManager; SearchStrategy: all) found no beans" } ] }} |
/configprops
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
{ "management.health.status.CONFIGURATION_PROPERTIES": { "prefix": "management.health.status", "properties": { "order": null } }, "multipart.CONFIGURATION_PROPERTIES": { "prefix": "multipart", "properties": { "enabled": false, "maxRequestSize": "10Mb", "location": null, "fileSizeThreshold": "0", "maxFileSize": "1Mb" } }, "environmentEndpoint": { "prefix": "endpoints.env", "properties": { "id": "env", "enabled": true, "sensitive": true } }} |
/beans
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
|
[ { "context": "application:8080", "parent": null, "beans": [ { "bean": "appMain", "scope": "singleton", "type": "com.xixicat.AppMain$$EnhancerBySpringCGLIB$$29382b14", "resource": "null", "dependencies": [ ] }, { "bean": "videoInfoMapper", "scope": "singleton", "type": "com.xixicat.dao.VideoInfoMapper", "resource": "file [/Users/xixicat/workspace/video-uber/target/classes/com/xixicat/dao/VideoInfoMapper.class]", "dependencies": [ "sqlSessionFactory" ] } ] }] |
/dump
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
|
[ { "threadName": "Signal Dispatcher", "threadId": 4, "blockedTime": -1, "blockedCount": 0, "waitedTime": -1, "waitedCount": 0, "lockName": null, "lockOwnerId": -1, "lockOwnerName": null, "inNative": false, "suspended": false, "threadState": "RUNNABLE", "stackTrace": [ ], "lockedMonitors": [ ], "lockedSynchronizers": [ ], "lockInfo": null }, { "threadName": "Reference Handler", "threadId": 2, "blockedTime": -1, "blockedCount": 217, "waitedTime": -1, "waitedCount": 9, "lockName": "java.lang.ref.Reference$Lock@45de945", "lockOwnerId": -1, "lockOwnerName": null, "inNative": false, "suspended": false, "threadState": "WAITING", "stackTrace": [ { "methodName": "wait", "fileName": "Object.java", "lineNumber": -2, "className": "java.lang.Object", "nativeMethod": true }, { "methodName": "wait", "fileName": "Object.java", "lineNumber": 503, "className": "java.lang.Object", "nativeMethod": false }, { "methodName": "run", "fileName": "Reference.java", "lineNumber": 133, "className": "java.lang.ref.Reference$ReferenceHandler", "nativeMethod": false } ], "lockedMonitors": [ ], "lockedSynchronizers": [ ], "lockInfo": { "className": "java.lang.ref.Reference$Lock", "identityHashCode": 73263429 } }] |
/env
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
{ profiles: [], server.ports: { local.server.port: 8080 }, servletContextInitParams: {}, systemProperties: { java.runtime.name: "Java(TM) SE Runtime Environment", sun.boot.library.path: "/Library/Java/JavaVirtualMachines/jdk1.7.0_79.jdk/Contents/Home/jre/lib", java.vm.version: "24.79-b02", gopherProxySet: "false", maven.multiModuleProjectDirectory: "/Users/xixicat/workspace/video-uber", java.vm.vendor: "Oracle Corporation", java.vendor.url: "http://java.oracle.com/", guice.disable.misplaced.annotation.check: "true", path.separator: ":", java.vm.name: "Java HotSpot(TM) 64-Bit Server VM", file.encoding.pkg: "sun.io", user.country: "CN", sun.java.launcher: "SUN_STANDARD", sun.os.patch.level: "unknown", PID: "763", java.vm.specification.name: "Java Virtual Machine Specification", user.dir: "/Users/xixicat/workspace/video-uber", java.runtime.version: "1.7.0_79-b15", java.awt.graphicsenv: "sun.awt.CGraphicsEnvironment", java.endorsed.dirs: "/Library/Java/JavaVirtualMachines/jdk1.7.0_79.jdk/Contents/Home/jre/lib/endorsed", os.arch: "x86_64", java.io.tmpdir: "/var/folders/tl/xkf4nr61033gd6lk5d3llz080000gn/T/", line.separator: " ", java.vm.specification.vendor: "Oracle Corporation", os.name: "Mac OS X", classworlds.conf: "/Users/xixicat/devtool/maven-3.3.3/bin/m2.conf", sun.jnu.encoding: "UTF-8", spring.beaninfo.ignore: "true", java.library.path: "/Users/xixicat/Library/Java/Extensions:/Library/Java/Extensions:/Network/Library/Java/Extensions:/System/Library/Java/Extensions:/usr/lib/java:.", java.specification.name: "Java Platform API Specification", java.class.version: "51.0", sun.management.compiler: "HotSpot 64-Bit Tiered Compilers", os.version: "10.10.5", user.home: "/Users/xixicat", user.timezone: "Asia/Shanghai", java.awt.printerjob: "sun.lwawt.macosx.CPrinterJob", file.encoding: "UTF-8", java.specification.version: "1.7", java.class.path: "/Users/xixicat/devtool/maven-3.3.3/boot/plexus-classworlds-2.5.2.jar", user.name: "xixicat", java.vm.specification.version: "1.7", sun.java.command: "org.codehaus.plexus.classworlds.launcher.Launcher spring-boot:run", java.home: "/Library/Java/JavaVirtualMachines/jdk1.7.0_79.jdk/Contents/Home/jre", sun.arch.data.model: "64", user.language: "zh", java.specification.vendor: "Oracle Corporation", awt.toolkit: "sun.lwawt.macosx.LWCToolkit", java.vm.info: "mixed mode", java.version: "1.7.0_79", java.ext.dirs: "/Users/xixicat/Library/Java/Extensions:/Library/Java/JavaVirtualMachines/jdk1.7.0_79.jdk/Contents/Home/jre/lib/ext:/Library/Java/Extensions:/Network/Library/Java/Extensions:/System/Library/Java/Extensions:/usr/lib/java", sun.boot.class.path: "/Library/Java/JavaVirtualMachines/jdk1.7.0_79.jdk/Contents/Home/jre/lib/resources.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0_79.jdk/Contents/Home/jre/lib/rt.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0_79.jdk/Contents/Home/jre/lib/sunrsasign.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0_79.jdk/Contents/Home/jre/lib/jsse.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0_79.jdk/Contents/Home/jre/lib/jce.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0_79.jdk/Contents/Home/jre/lib/charsets.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0_79.jdk/Contents/Home/jre/lib/jfr.jar:/Library/Java/JavaVirtualMachines/jdk1.7.0_79.jdk/Contents/Home/jre/classes", java.awt.headless: "true", java.vendor: "Oracle Corporation", maven.home: "/Users/xixicat/devtool/maven-3.3.3", file.separator: "/", LOG_EXCEPTION_CONVERSION_WORD: "%wEx", java.vendor.url.bug: "http://bugreport.sun.com/bugreport/", sun.io.unicode.encoding: "UnicodeBig", sun.cpu.endian: "little", sun.cpu.isalist: "" }, systemEnvironment: { TERM: "xterm-256color", ZSH: "/Users/xixicat/.oh-my-zsh", GVM_BROKER_SERVICE: "http://release.gvm.io", GRIFFON_HOME: "/Users/xixicat/.gvm/griffon/current", JAVA_MAIN_CLASS_763: "org.codehaus.plexus.classworlds.launcher.Launcher", JAVA_HOME: "/Library/Java/JavaVirtualMachines/jdk1.7.0_79.jdk/Contents/Home", SHLVL: "1", MAVEN_CMD_LINE_ARGS: " spring-boot:run", __CF_USER_TEXT_ENCODING: "0x1F5:0x19:0x34", GROOVY_HOME: "/Users/xixicat/.gvm/groovy/current", XPC_FLAGS: "0x0", GVM_INIT: "true", JBAKE_HOME: "/Users/xixicat/.gvm/jbake/current", PWD: "/Users/xixicat/workspace/video-uber", GVM_DIR: "/Users/xixicat/.gvm", GVM_VERSION: "2.4.3", MAVEN_PROJECTBASEDIR: "/Users/xixicat/workspace/video-uber", LOGNAME: "xixicat", SSH_AUTH_SOCK: "/private/tmp/com.apple.launchd.93xr1duECQ/Listeners", SPRINGBOOT_HOME: "/Users/xixicat/.gvm/springboot/current", GAIDEN_HOME: "/Users/xixicat/.gvm/gaiden/current", LAZYBONES_HOME: "/Users/xixicat/.gvm/lazybones/current", OLDPWD: "/Users/xixicat/workspace/video-uber", SHELL: "/bin/zsh", JBOSSFORGE_HOME: "/Users/xixicat/.gvm/jbossforge/current", LC_CTYPE: "zh_CN.UTF-8", TMPDIR: "/var/folders/tl/xkf4nr61033gd6lk5d3llz080000gn/T/", GVM_SERVICE: "http://api.gvmtool.net", GVM_PLATFORM: "Darwin", CLASSPATH: ".:/Users/xixicat/.m2/repository/co/paralleluniverse/quasar-core/0.7.2/quasar-core-0.7.2.jar", GLIDE_HOME: "/Users/xixicat/.gvm/glide/current", PATH: "/Users/xixicat/.gvm/vertx/current/bin:/Users/xixicat/.gvm/springboot/current/bin:/Users/xixicat/.gvm/lazybones/current/bin:/Users/xixicat/.gvm/jbossforge/current/bin:/Users/xixicat/.gvm/jbake/current/bin:/Users/xixicat/.gvm/groovyserv/current/bin:/Users/xixicat/.gvm/groovy/current/bin:/Users/xixicat/.gvm/griffon/current/bin:/Users/xixicat/.gvm/grails/current/bin:/Users/xixicat/.gvm/gradle/current/bin:/Users/xixicat/.gvm/glide/current/bin:/Users/xixicat/.gvm/gaiden/current/bin:/Users/xixicat/.gvm/crash/current/bin:/Users/xixicat/.gvm/asciidoctorj/current/bin:/Users/xixicat/bin:/usr/local/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/git/bin:/Users/xixicat/devtool/maven-3.3.3/bin:/Users/xixicat/devtool/gradle-2.6/bin:/Users/xixicat/devtool/android-sdk/platform-tools", GRADLE_HOME: "/Users/xixicat/.gvm/gradle/current", GROOVYSERV_HOME: "/Users/xixicat/.gvm/groovyserv/current", GRAILS_HOME: "/Users/xixicat/.gvm/grails/current", USER: "xixicat", LESS: "-R", PAGER: "less", HOME: "/Users/xixicat", CRASH_HOME: "/Users/xixicat/.gvm/crash/current", XPC_SERVICE_NAME: "0", VERTX_HOME: "/Users/xixicat/.gvm/vertx/current", GVM_BROADCAST_SERVICE: "http://cast.gvm.io", Apple_PubSub_Socket_Render: "/private/tmp/com.apple.launchd.y6fNwP8Sk6/Render", LSCOLORS: "Gxfxcxdxbxegedabagacad", ASCIIDOCTORJ_HOME: "/Users/xixicat/.gvm/asciidoctorj/current" }, applicationConfig: [classpath: /application.properties]: { pool.acquireIncrement: "1", pool.minPoolSize: "5", pool.initialPoolSize: "1", database.username: "root", pool.maxIdleTime: "60", database.url: "jdbc:mysql://127.0.0.1:3307/video_uber?autoReconnect=true&useUnicode=true&characterEncoding=UTF-8&zeroDateTimeBehavior=convertToNull", spring.jackson.dateFormat: "yyyy-MM-dd'T'HH:mm:ss", database.slave.username: "root", spring.jackson.serialization.write - dates - as - timestamps: "false", pool.idleTimeout: "30000", database.slave.url: "jdbc:mysql://127.0.0.1:3307/demo?autoReconnect=true&useUnicode=true&characterEncoding=UTF-8&zeroDateTimeBehavior=convertToNull", server.port: "8080", database.slave.password: "******", database.password: "******", database.driverClassName: "com.mysql.jdbc.Driver", pool.maxPoolSize: "50", database.dataSourceClassName: "com.mysql.jdbc.jdbc2.optional.MysqlDataSource" }} |
/health
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
{ status: "UP", diskSpace: { status: "UP", total: 249779191808, free: 193741590528, threshold: 10485760 }, db: { status: "UP", database: "MySQL", hello: 1 }} |
/info
需要自己在application.properties里头添加信息，比如
|
1
2
3
4
|
info: contact: email: xixicat@gmail.com phone: 0755-82890987 |
然后请求就可以出来了
|
1
2
3
4
5
6
|
{ "contact": { "phone": "0755-82890987", "email": "xixicat@gmail.com" }} |
/mappings
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
|
{ { [/metrics || /metrics.json], methods = [GET], produces = [application / json] }: { bean: "endpointHandlerMapping", method: "public java.lang.Object org.springframework.boot.actuate.endpoint.mvc.EndpointMvcAdapter.invoke()" }, { [/beans || /beans.json], methods = [GET], produces = [application / json] }: { bean: "endpointHandlerMapping", method: "public java.lang.Object org.springframework.boot.actuate.endpoint.mvc.EndpointMvcAdapter.invoke()" }, { [/health || /health.json], produces = [application / json] }: { bean: "endpointHandlerMapping", method: "public java.lang.Object org.springframework.boot.actuate.endpoint.mvc.HealthMvcEndpoint.invoke(java.security.Principal)" }, { [/info || /info.json], methods = [GET], produces = [application / json] }: { bean: "endpointHandlerMapping", method: "public java.lang.Object org.springframework.boot.actuate.endpoint.mvc.EndpointMvcAdapter.invoke()" }, { [/trace || /trace.json], methods = [GET], produces = [application / json] }: { bean: "endpointHandlerMapping", method: "public java.lang.Object org.springframework.boot.actuate.endpoint.mvc.EndpointMvcAdapter.invoke()" }, { [/autoconfig || /autoconfig.json], methods = [GET], produces = [application / json] }: { bean: "endpointHandlerMapping", method: "public java.lang.Object org.springframework.boot.actuate.endpoint.mvc.EndpointMvcAdapter.invoke()" }} |
/metrics
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
|
{mem: 499404,mem.free: 257591,processors: 8,instance.uptime: 4284997,uptime: 4294909,systemload.average: 1.84521484375,heap.committed: 437248,heap.init: 262144,heap.used: 179656,heap: 3728384,nonheap.committed: 62848,nonheap.init: 24000,nonheap.used: 62156,nonheap: 133120,threads.peak: 18,threads.daemon: 6,threads.totalStarted: 176,threads: 16,classes: 10294,classes.loaded: 10294,classes.unloaded: 0,gc.ps_scavenge.count: 11,gc.ps_scavenge.time: 405,gc.ps_marksweep.count: 0,gc.ps_marksweep.time: 0,datasource.primary.active: 0,datasource.primary.usage: 0,counter.status.200.autoconfig: 1,counter.status.200.beans: 1,counter.status.200.configprops: 1,counter.status.200.dump: 1,counter.status.200.env: 1,counter.status.200.health: 1,counter.status.200.info: 1,counter.status.200.mappings: 1,gauge.response.autoconfig: 81,gauge.response.beans: 15,gauge.response.configprops: 105,gauge.response.dump: 76,gauge.response.env: 4,gauge.response.health: 43,gauge.response.info: 1,gauge.response.mappings: 4} |
/shutdown
要真正生效，得配置文件开启
|
1
|
endpoints.shutdown.enabled: true |
/trace
记录最近100个请求的信息
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
|
[{ "timestamp": 1452955704922, "info": { "method": "GET", "path": "/metrics", "headers": { "request": { "Accept - Encoding": "gzip, deflate, sdch", "Upgrade - Insecure - Requests": "1", "Accept - Language": "zh-CN,zh;q=0.8,en;q=0.6", "User - Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.111 Safari/537.36", "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8", "Connection": "keep-alive", "Host": "localhost:8080" }, "response": { "Content - Type": "application/json; charset=UTF-8", "X - Application - Context": "application:8080", "Date": "Sat, 16 Jan 2016 14:48:24 GMT", "status": "200" } } }}, { "timestamp": 1452951489549, "info": { "method": "GET", "path": "/autoconfig", "headers": { "request": { "Accept - Encoding": "gzip, deflate, sdch", "Upgrade - Insecure - Requests": "1", "Accept - Language": "zh-CN,zh;q=0.8,en;q=0.6", "User - Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.111 Safari/537.36", "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8", "Connection": "keep-alive", "Host": "localhost:8080" }, "response": { "Content - Type": "application/json; charset=UTF-8", "X - Application - Context": "application:8080", "Date": "Sat, 16 Jan 2016 13:38:09 GMT", "status": "200" } } }}] |
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持服务器之家。
原文链接：https://segmentfault.com/a/1190000004318360
