springboot actuator 常用接口

概述

微服务作为一项在云中部署应用和服务的新技术是当下比较热门话题，而微服务的特点决定了功能模块的部署是分布式的，运行在不同的机器上相互通过服务调用进行交互，业务流会经过多个微服务的处理和传递，在这种框架下，微服务的监控显得尤为重要。

而Actuator正是Spring Boot提供的对应用系统的监控和管理的集成功能，可以查看应用配置的详细信息，例如自动化配置信息、创建的Spring beans信息、系统环境变量的配置信以及Web请求的详细信息等。如果使用不当或者一些不经意的疏忽，可能造成信息泄露等严重的安全隐患。

Actuator使用

Actuator应用监控使用只需要添加spring-boot-starter-actuator依赖即可，如下：

　　　　　<dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>

可以在application.properties中指定actuator的访问路径，如指定路径为/monitor：

management.context-path=/monitor

此时，运行示例,访问/monitor/env即可查看系统环境变量的配置信息，之后再访问/monitor/trace即可查看所有Web请求的详细信息，包括请求方法、路径、时间戳以及请求和响应的头信息甚至cookie信息，如图:

Actuator监控分成两类：原生端点和用户自定义扩展端点，原生的主要有：

路径描述
/autoconfig提供了一份自动配置报告，记录哪些自动配置条件通过了，哪些没通过
/beans描述应用程序上下文里全部的Bean，以及它们的关系
/env获取全部环境属性
/configprops描述配置属性(包含默认值)如何注入Bean
/dump获取线程活动的快照
/health报告应用程序的健康指标，这些值由HealthIndicator的实现类提供
/info获取应用程序的定制信息，这些信息由info打头的属性提供
/mappings描述全部的URI路径，以及它们和控制器(包含Actuator端点)的映射关系
/metrics报告各种应用程序度量信息，比如内存用量和HTTP请求计数
/shutdown关闭应用程序，要求endpoints.shutdown.enabled设置为true
/trace提供基本的HTTP请求跟踪信息(时间戳、HTTP头等)
安全措施

如果上述请求接口不做任何安全限制，安全隐患显而易见。实际上Spring Boot也提供了安全限制功能。比如要禁用/env接口，则可设置如下：

endpoints.env.enabled= false

如果只想打开一两个接口，那就先禁用全部接口，然后启用需要的接口：

endpoints.enabled = false
endpoints.metrics.enabled = true

另外也可以引入spring-boot-starter-security依赖

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-security</artifactId>
 </dependency>

在application.properties中指定actuator的端口以及开启security功能，配置访问权限验证，这时再访问actuator功能时就会弹出登录窗口，需要输入账号密码验证后才允许访问。

management.port=8099
management.security.enabled=true
security.user.name=admin
security.user.password=admin
安全建议

在使用Actuator时，不正确的使用或者一些不经意的疏忽，就会造成严重的信息泄露等安全隐患。在代码审计时如果是springboot项目并且遇到actuator依赖，则有必要对安全依赖及配置进行复查。也可作为一条规则添加到黑盒扫描器中进一步把控。
安全的做法是一定要引入security依赖，打开安全限制并进行身份验证。同时设置单独的Actuator管理端口并配置不对外网开放。

参考：spring-boot-starter-actuator监控接口详解 - 简书

spring-boot-starter-actuator功能简介

根据应用依赖和配置自动创建出来的监控和管理端点。通过这些端点，我们可以实时获取系统应用的各项监控指标。

spring-boot-starter-actuator功能集成

第一步：添加相关jar包依赖

<!--srping-boot-actuator-->

<dependency>

    <groupId>org.springframework.boot</groupId>

    <artifactId>spring-boot-starter-actuator</artifactId>

</dependency>

第二步：application.properties 配置Spring-Boot-Actuator配置

#spring-boot-actuator配置

#开放所有的web Endpoints

management.endpoints.web.exposure.include=*

第三步：获取监控端点详细信息和效果展示

通过访问：http://localhost:8082/actuator,获取监控端点详细信息

字符串格式化：

{
        "_links":{
        "self":{
        "href":"http://localhost:8082/actuator",
        "templated":false
        },
        "archaius":{
        "href":"http://localhost:8082/actuator/archaius",
        "templated":false
        },
        "auditevents":{
        "href":"http://localhost:8082/actuator/auditevents",
        "templated":false
        },
        "beans":{
        "href":"http://localhost:8082/actuator/beans",
        "templated":false
        },
        "caches-cache":{
        "href":"http://localhost:8082/actuator/caches/{cache}",
        "templated":true
        },
        "caches":{
        "href":"http://localhost:8082/actuator/caches",
        "templated":false
        },
        "health":{
        "href":"http://localhost:8082/actuator/health",
        "templated":false
        },
        "health-component":{

        "href":"http://localhost:8082/actuator/health/{component}",

        "templated":true

        },

        "health-component-instance":{

        "href":"http://localhost:8082/actuator/health/{component}/{instance}",

        "templated":true

        },

        "conditions":{

        "href":"http://localhost:8082/actuator/conditions",

        "templated":false

        },

        "configprops":{

        "href":"http://localhost:8082/actuator/configprops",

        "templated":false

        },

        "env":{

        "href":"http://localhost:8082/actuator/env",

        "templated":false

        },

        "env-toMatch":{

        "href":"http://localhost:8082/actuator/env/{toMatch}",

        "templated":true

        },

        "info":{

        "href":"http://localhost:8082/actuator/info",

        "templated":false

        },

        "loggers":{

        "href":"http://localhost:8082/actuator/loggers",

        "templated":false

        },

        "loggers-name":{

        "href":"http://localhost:8082/actuator/loggers/{name}",

        "templated":true

        },

        "heapdump":{

        "href":"http://localhost:8082/actuator/heapdump",

        "templated":false

        },

        "threaddump":{

        "href":"http://localhost:8082/actuator/threaddump",

        "templated":false

        },

        "metrics-requiredMetricName":{

        "href":"http://localhost:8082/actuator/metrics/{requiredMetricName}",

        "templated":true

        },

        "metrics":{

        "href":"http://localhost:8082/actuator/metrics",

        "templated":false

        },

        "scheduledtasks":{

        "href":"http://localhost:8082/actuator/scheduledtasks",

        "templated":false

        },

        "httptrace":{

        "href":"http://localhost:8082/actuator/httptrace",

        "templated":false

        },

        "mappings":{

        "href":"http://localhost:8082/actuator/mappings",

        "templated":false

        },

        "refresh":{

        "href":"http://localhost:8082/actuator/refresh",

        "templated":false

        },

        "features":{

        "href":"http://localhost:8082/actuator/features",

        "templated":false

        },

        "service-registry":{

        "href":"http://localhost:8082/actuator/service-registry",

        "templated":false

        }

   }
}

spring-boot-starter-actuator模块生成的原生监控端点，分为三大类：

  1. 应用配置类：获取应用程序中加载的应用配置、环境变量、自动化配置报告等与SpringBoot应用密切相关的配置类信息；这类端点可以帮助我们获取一系列关于Spring应用配置内容的详细报告，比如自动化配置的报告、Bean创建的报告、环境属性的报告等。
  2. 度量指标类：获取应用程序运行过程中用于监控的度量指标，比如内存信息、线程池信息、HTTP请求统计等；
  3. 操作监控类：提供了对应用的关闭等操作类功能；

以上三类监控端点的详细信息，下面我们详细来说明。

第四步：监控端点信息描述

应用配置类：默认启用
  1. /autoconfig: 该端点用来获取应用的自动化配置报告，其中包括所有自动化配置的候选项，同时列举了每个候选项是否满足自动化配置的各个先决条件。该端点可以帮助我们方便地找到一些自动化配置为什么没有生效的具体原因。报告内容分为两部分，如下：
    (1)positiveMatches中返回的是条件匹配成功的自动化配置；
    (2)negativeMathches中返回的是条件匹配不成功的自动化配置。
  2. /beans: 该端点用来获取应用上下文中创建的所有Bean。包含的具体信息如下：
    (1)bean：Bean的名称；
    (2)scope: Bean的作用域；
    (3)type: Bean的Java类型；
    (4)resource: class文件的具体路径；
    (5)dependencies: 依赖的Bean的名称;
  3. /configprops: 该端点用来获取应用中配置的属性信息报告。我们可以通过该报告来看到各个属性的配置路径，比如我们要关闭端点，就可以使用endpoints.configprops.enabled=false来完成设置。
  4. /env: 该端点用来获取应用所有可用的环境属性报告，具体包括环境变量、JVM属性、应用的配置属性、命令行中的参数。通过该端点返回的信息，我们可以看到当前应用加载的配置信息，可以结合@ConfigurationProperties注解将它们引入到应用程序中使用。对于一些敏感属性信息，比如在属性名中包含password,secret,key这些关键词，在返回的时候会使用*来替换。
  5. /mappings: 该端点用来返回所有Spring MVC的控制器映射关系报告。返回的信息有：
    (1)bean属性: 标识该映射关系的请求处理器；
    (2)method属性：标识该映射关系的具体处理类和处理函数；
  6. /info:该端点用来返回一些应用自定义的信息。默认情况下，该端点只会返回一个空的JSON内容。我们可以在application.properties配置文件中设置一些以info为前缀的属性配置信息，就能看到效果。
度量指标类：默认启用
  1. /metrics: 该端点用来返回当前应用的各类重要度量指标，比如内存信息、线程信息、垃圾回收信息等。具体信息包含如下：
    (1)系统信息：包括处理器数量processors、运行时间uptime和instance.uptime、系统平均负载systemload.average;
    (2)mem.*: 内存概要信息，包括分配给应用的总内存数量以及当前空闲的内存数量，这些信息来自java.lang.Runtime;
    (3)heap.*: 堆内存使用情况。这些信息来自java.lang.management.MemoryMXBean接口中getHeapMemoryUsage方法获取的java.lang.management.MemoryUsage;
    (4)nonheap.*: 非堆内存使用情况。这些信息来自java.lang.management.MemoryMXBean接口中getNonHeapMemoryUsage方法获取java.lang.management.MemoryUsage;
    (5)threads.*: 线程使用情况，包括线程数、守护线程（daemon)、线程峰值（peak)等，这些信息来自java.lang.management.ThreadMXBean;
    (6)classes.*: 应用加载和卸载的类统计，这些信息来自java.lang.managemeng.ClassLoadingMXBean;
    (7)gc.*: 垃圾收集器的详细信息，包括垃圾回收次数gc.ps_scavenge.count、垃圾回收消耗时间gc.ps_scavenge.time、标记-清除算法的次数gc.ps_marksweep.count、标记-清除算法的消耗时间gc.ps_marksweep.time。这些信息来自java.lang.management.GarbageCollectorMXBean;
    (8)httpsessions.*: Tomcat容器的会话使用情况。包括最大会话数httpsessions.max和活跃会话数httpsessions.active。该度量指标信息仅在引入嵌入式Tomcat作为应用容器的时候才会提供；
    (9)gauge.*: HTTP请求的性能指标之一，它主要用来反映一个绝对值。
    (10)counter.*: HTTP请求的性能指标之一，它主要作为计数器来使用，记录了增加量和减少量。
    报告的具体内容如下：
  2. /health: 该端点用来获取应用的各类健康指标信息。在spring-boot-starter-actuator模块中自带实现了一些常用资源的健康指标检测器，这些健康指标检测器都是通过HealthIndicator接口实现，并且会根据依赖关系的引入实现自动化配置。常见的一些健康指标检测器如下：
    (1)DiskSpaceHealthIndicator: 低磁盘空间检测；
    (2)DataSourceHealthIndicator: 检测DataSource的链接是否成功；
    (3)MongoHealthIndicator: 检测Mongo数据库是否可用；
    (4)RabbitHealthIndicator: 检测Rabbit服务器是否可用；
    (5)RedisHealthIndicator: 检测Redis服务器是否可用；
    (6)SolrHealthIndicator: 检测Solr服务器是否可用；
    我们也可用通过实现HealthIndicator接口来自定义自己的健康指标检测器；
    报告的具体内容如下：
  3. /dump: 该端点用来暴露程序运行中的线程信息。它使用java.lang.management.ThreadMXBean的dumpAllThreads方法来返回所有含有同步信息的活动线程详情；
  4. /trace: 该端点用来返回基本的HTTP跟踪信息。默认情况下，跟踪信息的存储采用org.springframework.boot.actuate.trace.InMemoryTraceRepository实现的内存方式，始终保留最近的100条请求记录。
操作控制类：需要通过属性配置来开启操作

     1./shutdown: 该端点用来实现关闭应用的远程操作，需要配置属性endpoints.shutdown.enable=true才能实现。该操作非常危险，不建议使用。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：/a/109125.html

如若内容造成侵权/违法违规/事实不符，请联系我们进行投诉反馈qq邮箱809451989@qq.com，一经查实，立即删除！

相关文章

H5游戏源码分享-像素小鸟游戏（类似深海潜艇）

H5游戏源码分享-像素小鸟游戏（类似深海潜艇）

H5游戏源码分享-像素小鸟游戏&#xff08;类似深海潜艇&#xff09; 点击屏幕控制小鸟的飞行高度 整个小游戏就用JS完成 项目地址&#xff1a;https://download.csdn.net/download/Highning0007/88483228 <!DOCTYPE HTML> <html><head><meta http-equiv…
阅读更多...
视频格式高效转换：MP4视频批量转MKV格式的方法

视频格式高效转换：MP4视频批量转MKV格式的方法

随着数字媒体技术的不断发展&#xff0c;视频格式转换已经成为了我们日常工作中不可或缺的一部分。不同的视频格式适用于不同的场景和设备&#xff0c;因此将视频从一种格式转换为另一种格式往往是我们必须完成的任务。在本文中&#xff0c;我们将重点介绍如何运用云炫AI智剪高…
阅读更多...
Flask路由机制分析之二

Flask路由机制分析之二

一、前言 上篇 《Flask 路由机制分析之一》主要讲了Python函数的特性以及装饰器的基本概念&#xff0c;这节我们具体分析一下路由内部机制&#xff0c;Flask路由依赖于werkzegu的routing模块来实现。 二、werkzegu的routing模块介绍 Werkzegu库的routing模块主要功能在于URL…
阅读更多...
【javaweb】学习日记Day13 - AOP 事务管理 切入点 连接点

【javaweb】学习日记Day13 - AOP 事务管理 切入点 连接点

目录 一、完善解散部门功能 二、spring 事务 &#xff08;1&#xff09;Transactional 事务管理 ① rollbackFor 控制异常类型 ② propagation 事务传播控制 1、定义解散部门操作日记 三、AOP基础 1、概述 2、快速入门 &#xff08;1&#xff09;案例&#xff1a;统…
阅读更多...
测试时间函数

测试时间函数

clock():测试时间函数 测试程序开始运行(即从main开始)到执行当前行需要的时间值,单位毫秒.需要引用time.h 例如&#xff1a;需要需要测试输出0~100需要的时间可以用如下代码&#xff1a; #include<stdio.h> #include<time.h>//单位是毫秒 int main() {clock_t c1…
阅读更多...
Android 3D Launcher锁定IMU界面

Android 3D Launcher锁定IMU界面

故事背景&#xff1a; 最近工厂反馈由于VR设备老化测试完成之后&#xff0c;变绿界面不明显&#xff0c;只占3D系统一部分,每次需要戴头盔&#xff0c;才能确定老化完成。导致工厂效率变低&#xff0c;如果后期产能变大&#xff0c;效率更低。 1、针对以上需求我们需要拆分 1、…
阅读更多...
【SwiftUI系列】2.@State属性包装器

【SwiftUI系列】2.@State属性包装器

上一篇介绍了不透明返回类型&#xff0c;这篇介绍下属性包装器。 这里需要先区别下属性包装器和属性代理两个概念&#xff0c;因为在网络上有不同的称呼。 属性包装器&#xff0c;英文PropertyWrapper。 属性代理&#xff0c;英文PropertyDelegate。 1.属性包装器和属性代理…
阅读更多...
汇编语言-div指令溢出问题

汇编语言-div指令溢出问题

汇编语言-div指令溢出问题 8086CPU中被除数保存在ax(16位)或ax和dx&#xff08;32位&#xff09;中&#xff0c;如果被除数为16位&#xff0c;进行除法运算时al保存商&#xff0c;ah保存余数。如果被除数为32位时&#xff0c;进行除法运算时&#xff0c;ax保存商&#xff0c;d…
阅读更多...
动静分离技术

动静分离技术

一、HAproxy 动静分离 1、概念&#xff1a; HAproxy 动静分离技术是一种用于优化 Web 服务器性能和提高用户体验的策略&#xff0c;它通过将动态内容和静态内容分别路由到不同的后端服务器来实现&#xff0c;减轻服务器负载&#xff0c;提高网站的响应速度。 动态内容包括由…
阅读更多...
NewStarCTF2023week5-隐秘的图片

NewStarCTF2023week5-隐秘的图片

下载附件解压得到两张图片 第一张二维码扫出来提示没有什么 第二张看到的第一直觉是修复&#xff0c;因为缺了三个定位符&#xff0c;比如下面这种&#xff0c;就是修复定位符&#xff1a; 但是这里这道题仔细看一下&#xff0c;修复好了也不像正常的二维码&#xff0c;并且这…
阅读更多...
python自动化测试（七）：鼠标事件

python自动化测试（七）：鼠标事件

前置条件&#xff1a; 本地部署&#xff1a;ECShop的版本是3.0.0、Google版本是 Google Chrome65.0.3325.162 (正式版本) &#xff08;32 位&#xff09; py的selenium版本是3.11.0 目录 一、前置代码 二、ActionChains类 三、鼠标事件 3.1 悬停事件 3.2 左键单击 3…
阅读更多...
vivo自研AI大模型即将问世，智能手机行业加速迈向AI时代

vivo自研AI大模型即将问世，智能手机行业加速迈向AI时代

当前&#xff0c;以大模型为代表的人工智能技术已发展为新一轮科技革命和产业变革的重要驱动力量&#xff0c;被视作推动经济社会发展的关键增长极。 AI大模型潮起&#xff0c;千行百业走向百舸争流的AI创新应用期&#xff0c;前沿信息技术向手机、PC、车机等消费级终端加速渗…
阅读更多...
k8s集群升级

k8s集群升级

目录 1. 部署cri-docker &#xff08;所有集群节点&#xff09; 2. 升级master节点 3. 升级worker节点 4. 部署containerd 1. 部署cri-docker &#xff08;所有集群节点&#xff09; k8s从1.24版本开始移除了dockershim&#xff0c;所以需要安装cri-docker插件才能使用docker …
阅读更多...
代码签名证书如何申请

代码签名证书如何申请

代码签名证书也称之为软件数字证书&#xff0c;也可以叫作微软信任证书&#xff0c;主要给软件进行身份确定及保护知识产权&#xff0c;也可以被操作系统给信&#xff0c;对于软件开发企业是一项最基本的产品之一。 代码签名证书分为OV和EV两种类型&#xff0c;虽然认证步骤大同…
阅读更多...
【网络协议】聊聊TCP如何做到可靠传输的

【网络协议】聊聊TCP如何做到可靠传输的

网络是不可靠的&#xff0c;所以在TCP协议中通过各种算法等机制保证数据传输的可靠性。生活中如何保证消息可靠传输的&#xff0c;那么就是采用一发一收的方式&#xff0c;但是这样其实效率并不高&#xff0c;所以通常采用的是累计确认或者累计应答。 如何实现一个靠谱的协议&…
阅读更多...
第 369 场周赛 （3题，递归式动态规划）

第 369 场周赛 （3题，递归式动态规划）

第一题 简单题&#xff0c;就不多写了 class Solution:def findKOr(self, nums: List[int], k: int) -> int:ans [0] * 31for n in nums:for i in range(31):if 2**i & n 2**i:ans[i] 1return sum([2**i if ans[i] > k else 0 for i in range(31)])第二题 0 至少…
阅读更多...
Azure - 机器学习：使用 Apache Spark 进行交互式数据整理

Azure - 机器学习：使用 Apache Spark 进行交互式数据整理

目录 本文内容先决条件使用 Apache Spark 进行交互式数据整理Azure 机器学习笔记本中的无服务器 Spark 计算从 Azure Data Lake Storage (ADLS) Gen 2 导入和整理数据从 Azure Blob 存储导入和处理数据从 Azure 机器学习数据存储导入和整理数据 关注TechLead&#xff0c;分享AI…
阅读更多...
论坛介绍 | COSCon'23 开源文化（GL)

论坛介绍 | COSCon'23 开源文化（GL)

众多开源爱好者翘首期盼的开源盛会&#xff1a;第八届中国开源年会&#xff08;COSCon23&#xff09;将于 10月28-29日在四川成都市高新区菁蓉汇举办。本次大会的主题是&#xff1a;“开源&#xff1a;川流不息、山海相映”&#xff01;各位新老朋友们&#xff0c;欢迎到成都&a…
阅读更多...
ZYNQ连载08-Lwip网络组件

ZYNQ连载08-Lwip网络组件

ZYNQ连载08-Lwip网络组件 1. 添加Lwip包 2. Lwip配置 我这里关闭ipv6和dhcp。 3. tcp客户端 #include "include/my_tcp.h" #include "lwip/ip.h"#define THREAD_STACKSIZE 1024 #define SERVER_PORT 8000 #define SERVER_ADDR "192.168.3.190&qu…
阅读更多...
安全架构的设计理论与实践

安全架构的设计理论与实践

安全架构的设计理论与实践 安全架构概述 信息安全面临的威胁 安全架构的定义和范围 信息安全相关的国内外标准及组织 主要安全模型 状态机模型(BLP)模型 Bell-IaPadula模型 Biba模型 Clark-Wilson (CWM)模型 ChineseWall模型 系统安全体系架构规划框架 安全技术体系架构 信息系…
阅读更多...
最新文章

Copyright @ 2022~2023