由于 Spring Boot 依赖于 Spring Security 的默认设置，因此默认开启 CSRF 保护。这意味着在使用默认安全配置时，需要POST（关闭和记录器端点）、aPUT或 a的执行器端点DELETE会收到 403（禁止）错误。

您可以在Spring Security Reference Guide中找到有关 CSRF 保护的更多信息。

端点上的操作通过其参数接收输入。当通过 Web 公开时，这些参数的值取自 URL 的查询参数和 JSON 请求正文。当通过 JMX 公开时，参数被映射到 MBean 操作的参数。默认情况下需要参数。@javax.annotation.Nullable通过使用或注释它们可以使它们成为可选的@org.springframework.lang.Nullable。

您可以将 JSON 请求正文中的每个根属性映射到端点的参数。考虑以下 JSON 请求正文：

您可以使用它来调用接受String name和int counter参数的写入操作，如以下示例所示：

使用 Jersey、Spring MVC 或 Spring WebFlux 通过 HTTP 自动公开 、@Endpoint或@WebEndpoint上的操作。@EndpointWebExtension如果 Jersey 和 Spring MVC 都可用，则使用 Spring MVC。

servlet 可以通过实现一个带有注释的类来公开为端点，该类@ServletEndpoint也实现了Supplier<EndpointServlet>. Servlet 端点提供与 servlet 容器的更深层次的集成，但以牺牲可移植性为代价。它们旨在用于将现有 servlet 公开为端点。对于新端点，应尽可能首选@Endpoint和注释。@WebEndpoint

您可以使用@ControllerEndpoint和@RestControllerEndpoint实现仅由 Spring MVC 或 Spring WebFlux 公开的端点。通过使用 Spring MVC 和 Spring WebFlux 的标准注释来映射方法，例如@RequestMapping和@GetMapping，端点的 ID 用作路径的前缀。控制器端点提供与 Spring 的 Web 框架的更深层次的集成，但以牺牲可移植性为代价。应尽可能首选@Endpointand注释。@WebEndpoint

在适当的时候，Spring Boot 会自动配置HealthIndicators下表中列出的内容。您也可以通过配置启用或禁用选定的指标management.health.key.enabled，key如下表所示：

其他HealthIndicators可用但默认情况下未启用：

要提供自定义健康信息，您可以注册实现该HealthIndicator接口的 Spring bean。您需要提供该health()方法的实现并返回Health响应。Health响应应包含状态，并且可以选择包含要显示的其他详细信息。以下代码显示了一个示例HealthIndicator实现：

除了 Spring Boot 的预定义Status类型之外，Health还可以返回一个Status表示新系统状态的自定义。在这种情况下，您还需要提供StatusAggregator接口的自定义实现，或者您必须使用management.endpoint.health.status.order配置属性配置默认实现。

例如，假设在您的一个实现中使用了一个Status带有代码的new 。要配置严重性顺序，请将以下属性添加到您的应用程序属性中：FATALHealthIndicator

响应中的 HTTP 状态代码反映了整体健康状况。默认情况下，OUT_OF_SERVICE映射DOWN到 503。任何未映射的健康状态，包括UP，都映射到 200。如果您通过 HTTP 访问健康端点，您可能还需要注册自定义状态映射。配置自定义映射会禁用 和 的默认DOWN映射OUT_OF_SERVICE。如果要保留默认映射，则必须显式配置它们以及任何自定义映射。例如，以下属性映射FATAL到 503（服务不可用）并保留 和 的默认DOWN映射OUT_OF_SERVICE：

下表显示了内置状态的默认状态映射：

对于响应式应用程序，例如使用 Spring WebFlux 的应用程序，ReactiveHealthContributor提供了一个非阻塞契约来获取应用程序健康。与传统的 类似HealthContributor，健康信息是从 a 的内容中收集的ReactiveHealthContributorRegistry（默认情况下， allHealthContributor和ReactiveHealthContributor您的 中定义的实例ApplicationContext）。HealthContributors不检查响应式 API 的常规在弹性调度程序上执行。

要从反应式 API 提供自定义健康信息，您可以注册实现该ReactiveHealthIndicator接口的 Spring bean。以下代码显示了一个示例ReactiveHealthIndicator实现：

在适当的时候，Spring Boot 会自动配置以下内容ReactiveHealthIndicators：

有时将健康指标组织成可用于不同目的的组很有用。

要创建运行状况指标组，您可以使用该management.endpoint.health.group.<name>属性并将运行状况指标 ID 列表指定为include或exclude。例如，要创建一个仅包含数据库指标的组，您可以定义以下内容：

然后，您可以通过点击 来检查结果localhost:8080/actuator/health/custom。

同样，要创建一个从组中排除数据库指标并包含所有其他指标的组，您可以定义以下内容：

默认情况下，组继承与系统运行状况相同StatusAggregator的HttpCodeStatusMapper设置。但是，您也可以在每个组的基础上定义这些。如果需要，您还可以覆盖show-detailsandroles属性：

健康组还可以包括/排除CompositeHealthContributor. 您还可以仅包含/排除CompositeHealthContributor. 这可以使用组件的完全限定名称来完成，如下所示：

在上面的示例中，custom组将包含HealthContributor名称primary为组合的组件test。在这里，primary它本身是一个组合，HealthContributor具有该名称的b将被排除在custom组之外。

可以在主端口或管理端口上的附加路径上提供运行状况组。这在 Kubernetes 等云环境中很有用，在这些环境中，出于安全目的，为执行器端点使用单独的管理端口是很常见的。拥有一个单独的端口可能会导致不可靠的健康检查，因为即使健康检查成功，主应用程序也可能无法正常工作。可以为健康组配置额外的路径，如下所示：

这将使live健康组在主服务器端口上可用/healthz。前缀是强制性的，并且必须是server:（表示主服务器端口）或management:（表示管理端口，如果已配置）。路径必须是单个路径段。

DataSource运行状况指示器显示标准数据源和路由数据源 bean 的运行状况。路由数据源的健康状况包括其每个目标数据源的健康状况。在健康端点的响应中，每个路由数据源的目标都使用其路由键命名。如果您不想在指标的输出中包含路由数据源，请设置management.health.db.ignore-routing-data-sources为true。

Actuator 将“liveness”和“readiness”探针配置为 Health Groups。这意味着他们可以使用所有健康组功能。例如，您可以配置其他运行状况指标：

默认情况下，Spring Boot 不会向这些组添加其他健康指标。

“活跃度”探测不应依赖于外部系统的健康检查。如果应用程序的活动状态被破坏，Kubernetes 会尝试通过重新启动应用程序实例来解决该问题。这意味着如果外部系统（例如数据库、Web API 或外部缓存）发生故障，Kubernetes 可能会重新启动所有应用程序实例并产生级联故障。

至于“就绪”探测，应用程序开发人员必须仔细选择检查外部系统。出于这个原因，Spring Boot 在就绪探测中不包括任何额外的健康检查。如果应用程序实例的就绪状态未准备好，Kubernetes 不会将流量路由到该实例。一些外部系统可能不被应用程序实例共享，在这种情况下，它们可以包含在就绪探测中。其他外部系统可能对应用程序不是必需的（应用程序可能有断路器和回退），在这种情况下绝对不应该包括它们。不幸的是，所有应用程序实例共享的外部系统是常见的，您必须做出判断：将其包含在就绪探针中，并期望在外部服务关闭时应用程序停止服务或将其排除在外并处理堆栈更高的故障，也许通过在调用者中使用断路器。

此外，如果应用程序使用 Kubernetes自动缩放，它可能会对从负载均衡器中取出的应用程序做出不同的反应，具体取决于其自动缩放器配置。

Kubernetes Probes 支持的一个重要方面是它与应用程序生命周期的一致性。AvailabilityState（这是应用程序的内存中的内部状态）和实际的探针（暴露该状态）之间存在显着差异。根据应用程序生命周期的阶段，探针可能不可用。

Spring Boot在启动和关闭期间发布应用程序事件，探针可以监听此类事件并公开AvailabilityState信息。

下表显示了AvailabilityStateHTTP 连接器在不同阶段的状态。

当 Spring Boot 应用程序启动时：

当 Spring Boot 应用程序关闭时：

在适当的时候，Spring 会自动配置以下InfoContributorbean：

是否启用单个贡献者由其management.info.<id>.enabled属性控制。不同的贡献者对此属性有不同的默认值，这取决于他们的先决条件和他们公开的信息的性质。

没有先决条件表明它们应该被启用，默认情况下禁用env、java和贡献者。os每个都可以通过将其management.info.<id>.enabled属性设置为 来启用true。

和buildinfogit贡献者默认启用。每个都可以通过将其management.info.<id>.enabled属性设置为 来禁用false。或者，要禁用通常默认启用的每个贡献者，请将management.info.defaults.enabled属性设置为false.

启用贡献者后env，您可以通过设置Spring 属性来自定义info端点公开的数据。info.*键下的所有Environment属性都会info自动公开。例如，您可以将以下设置添加到application.properties文件中：

端点的另一个有用特性是它能够在项目构建时info发布有关源代码存储库状态的信息。git如果GitPropertiesbean 可用，您可以使用info端点来公开这些属性。

默认情况下，端点公开git.branch、git.commit.id和git.commit.time属性（如果存在）。如果您不希望端点响应中有任何这些属性，则需要将它们从git.properties文件中排除。如果要显示完整的 git 信息（即 的全部内容git.properties），使用management.info.git.mode属性，如下：

info要完全禁用来自端点的 git 提交信息，请将management.info.git.enabled属性设置为false，如下所示：

如果BuildPropertiesbean 可用，info端点还可以发布有关您的构建的信息。如果META-INF/build-info.properties类路径中有文件可用，则会发生这种情况。

info端点发布有关您的 Java 运行时环境的信息，请参阅了解JavaInfo更多详细信息。

info端点发布有关您的操作系统的信息，有关更多详细信息，请参阅OsInfo。

要提供自定义应用程序信息，您可以注册实现该InfoContributor接口的 Spring bean。

以下示例提供example具有单个值的条目：

如果您到达info端点，您应该会看到包含以下附加条目的响应：

Jolokia 有许多设置，您通常可以通过设置 servlet 参数来配置这些设置。使用 Spring Boot，您可以使用您的application.properties文件。为此，请在参数前加上management.endpoint.jolokia.config.，如以下示例所示：

如果您使用 Jolokia 但不想让 Spring Boot 配置它，请将management.endpoint.jolokia.enabled属性设置为false，如下所示：

默认情况下，AppOptics 注册表会定期将指标推送到api.appoptics.com/v1/measurements. 要将指标导出到 SaaS AppOptics，必须提供您的 API 令牌：

默认情况下，指标会导出到在本地计算机上运行的Atlas 。您可以提供Atlas 服务器的位置：

Datadog 注册表会定期将指标推送到datadoghq。要将指标导出到Datadog，您必须提供您的 API 密钥：

如果您另外提供应用程序密钥（可选），则元数据（如仪表描述、类型和基本单位）也将被导出：

默认情况下，指标会发送到 Datadog 美国站点( api.datadoghq.com)。如果您的 Datadog 项目托管在其他站点之一上，或者您需要通过代理发送指标，请相应地配置 URI：

您还可以更改将指标发送到 Datadog 的时间间隔：

Dynatrace 提供了两个指标摄取 API，这两个 API 都是为Micrometer实现的。您可以在此处找到有关 Micrometer 指标摄取的 Dynatrace 文档。命名空间中的配置属性v1仅在导出到Timeseries v1 API时适用。命名空间中的配置属性v2仅在导出到Metrics v2 API时适用。请注意，此集成一次只能导出到API 的一个v1或版本，这是首选。如果在命名空间中设置了（v1 需要但在 v2 中未使用），则将指标导出到端点。否则，假定。v2v2device-idv1v1v2

默认情况下，指标会导出到本地机器上运行的Elastic 。您可以使用以下属性提供要使用的 Elastic 服务器的位置：

默认情况下，指标会导出到本地机器上运行的Ganglia 。您可以提供Ganglia 服务器主机和端口，如以下示例所示：

默认情况下，指标会导出到本地计算机上运行的Graphite 。您可以提供Graphite 服务器主机和端口，如以下示例所示：

Micrometer 提供了一个默认值HierarchicalNameMapper，用于控制维度计量器 ID 如何映射到平面分层名称。

默认情况下，Humio 注册表会定期将指标推送到cloud.humio.com。要将指标导出到 SaaS Humio，您必须提供您的 API 令牌：

您还应该配置一个或多个标签来识别指标推送到的数据源：

默认情况下，指标会导出到使用默认配置在本地计算机上运行的Influx v1 实例。要将指标导出到 InfluxDB v2，请配置org、bucket和 身份验证token以写入指标。您可以使用以下命令提供要使用的Influx 服务器的位置：

Micrometer 提供到JMX的分层映射，主要是作为一种在本地查看指标的廉价且可移植的方式。默认情况下，指标会导出到metricsJMX 域。您可以使用以下方式提供要使用的域：

Micrometer 提供了一个默认值HierarchicalNameMapper，用于控制维度计量器 ID 如何映射到平面分层名称。

默认情况下，指标会导出到本地计算机上运行的KairosDB。您可以使用以下方法提供KairosDB 服务器的位置以使用：

New Relic 注册表会定期将指标推送到New Relic。要将指标导出到New Relic，您必须提供您的 API 密钥和帐户 ID：

您还可以更改将指标发送到 New Relic 的时间间隔：

默认情况下，指标是通过 REST 调用发布的，但如果您在类路径中有 Java 代理 API，您也可以使用它：

最后，您可以通过定义自己的NewRelicClientProviderbean 来完全控制。

Prometheus希望抓取或轮询单个应用程序实例的指标。Spring Boot 提供了一个执行器端点，以适当的格式/actuator/prometheus呈现Prometheus 抓取。

以下示例scrape_config添加到prometheus.yml：

还支持Prometheus 示例。要启用此功能，SpanContextSupplier应提供一个 bean。如果您使用Spring Cloud Sleuth，它将为您自动配置，但如果您愿意，您可以随时创建自己的。
请查看Prometheus Docs，因为此功能需要在 Prometheus 端明确启用，并且仅支持使用OpenMetrics格式。

对于可能存在时间不够长而无法被抓取的临时或批处理作业，您可以使用Prometheus Pushgateway支持将指标公开给 Prometheus。要启用 Prometheus Pushgateway 支持，请将以下依赖项添加到您的项目中：

当类路径上存在 Prometheus Pushgateway 依赖项并且management.metrics.export.prometheus.pushgateway.enabled属性设置为 时true，PrometheusPushGatewayManager会自动配置 bean。这管理将指标推送到 Prometheus Pushgateway。

您可以PrometheusPushGatewayManager使用management.metrics.export.prometheus.pushgateway. 对于高级配置，您还可以提供自己的PrometheusPushGatewayManagerbean。

SignalFx 注册表会定期将指标推送到SignalFx。要将指标导出到SignalFx，您必须提供访问令牌：

您还可以更改将指标发送到 SignalFx 的时间间隔：

Micrometer 附带一个简单的内存后端，如果没有配置其他注册表，它会自动用作后备。这使您可以查看在metrics 端点中收集了哪些指标。

只要您使用任何其他可用的后端，内存中的后端就会自行禁用。您也可以显式禁用它：

Stackdriver 注册表会定期将指标推送到Stackdriver。要将指标导出到 SaaS Stackdriver，您必须提供您的 Google Cloud 项目 ID：

您还可以更改将指标发送到 Stackdriver 的时间间隔：

StatsD 注册表通过 UDP 急切地将指标推送到 StatsD 代理。默认情况下，指标会导出到本地计算机上运行的StatsD代理。您可以通过以下方式提供要使用的 StatsD 代理主机、端口和协议：

您还可以更改要使用的 StatsD 线路协议（默认为 Datadog）：

Wavefront 注册表会定期将指标推送到Wavefront。如果您将指标直接导出到Wavefront，则必须提供您的 API 令牌：

或者，您可以在您的环境中使用 Wavefront sidecar 或内部代理将指标数据转发到 Wavefront API 主机：

您还可以更改将指标发送到 Wavefront 的时间间隔：

自动配置通过使用核心 Micrometer 类启用 JVM Metrics。JVM 指标以jvm.计量名称发布。

提供了以下 JVM 指标：

自动配置通过使用核心 Micrometer 类启用系统指标。系统指标以system.、process.和disk.计量名称发布。

提供了以下系统指标：

自动配置公开应用程序启动时间指标：

指标由应用程序类的完全限定名称标记。

自动配置启用 Logback 和 Log4J2 的事件指标。详细信息以log4j2.events.或logback.events.仪表名称发布。

只要底层可用，自动配置就可以检测所有可用的beanThreadPoolTaskExecutor和bean 。指标由执行者的名称标记，该名称派生自 bean 名称。ThreadPoolTaskSchedulerThreadPoolExecutor

自动配置启用对 Spring MVC 控制器和功能处理程序处理的所有请求的检测。默认情况下，生成的指标名称为http.server.requests. 您可以通过设置management.metrics.web.server.request.metric-name属性来自定义名称。

@Timed@Controller类和@RequestMapping方法支持注释（有关详细信息，请参阅@Timed Annotation 支持）。如果您不想记录所有 Spring MVC 请求的指标，则可以设置management.metrics.web.server.request.autotime.enabled并false专门使用@Timed注释。

默认情况下，与 Spring MVC 相关的指标标记有以下信息：

要添加到默认标签，请提供一个或多个@Bean实现WebMvcTagsContributor. 要替换默认标签，请提供一个@Bean实现WebMvcTagsProvider.

默认情况下，处理所有请求。要自定义过滤器，请提供一个@Bean实现FilterRegistrationBean<WebMvcMetricsFilter>.

自动配置支持对 Spring WebFlux 控制器和功能处理程序处理的所有请求进行检测。默认情况下，生成的指标名称为http.server.requests. 您可以通过设置management.metrics.web.server.request.metric-name属性来自定义名称。

@Timed@Controller类和@RequestMapping方法支持注释（有关详细信息，请参阅@Timed Annotation 支持）。如果您不想记录所有 Spring WebFlux 请求的指标，则可以设置management.metrics.web.server.request.autotime.enabled并false专门使用@Timed注释。

默认情况下，WebFlux 相关指标标记有以下信息：

要添加到默认标签，请提供一个或多个实现WebFluxTagsContributor. 要替换默认标签，请提供一个实现WebFluxTagsProvider.

自动配置支持检测由 Jersey JAX-RS 实现处理的所有请求。默认情况下，生成的指标名称为http.server.requests. 您可以通过设置management.metrics.web.server.request.metric-name属性来自定义名称。

@Timed请求处理类和方法支持注释（有关详细信息，请参阅@Timed Annotation 支持）。如果您不想记录所有 Jersey 请求的指标，则可以设置management.metrics.web.server.request.autotime.enabled并false专门使用@Timed注释。

默认情况下，Jersey 服务器指标标记有以下信息：

要自定义标签，请提供一个@Bean实现JerseyTagsProvider.

Spring Boot Actuator 管理RestTemplate和WebClient. 为此，您必须注入自动配置的构建器并使用它来创建实例：

您还可以手动应用负责此检测的定制器，即MetricsRestTemplateCustomizer和MetricsWebClientCustomizer。

默认情况下，生成的指标名称为http.client.requests. 您可以通过设置management.metrics.web.client.request.metric-name属性来自定义名称。

默认情况下，由检测客户端生成的指标带有以下信息标记：

要自定义标签，并且根据您选择的客户端，您可以提供一个@Beanthat implementsRestTemplateExchangeTagsProvider或WebClientExchangeTagsProvider. RestTemplateExchangeTags和中有方便的静态函数WebClientExchangeTags。

自动配置仅在启用时MBeanRegistry启用 Tomcat 的检测。默认情况下，MBeanRegistry禁用，但您可以通过设置启用server.tomcat.mbeanregistry.enabled它true。

Tomcat 指标以tomcat.计量名称发布。

自动配置Cache在启动时启用所有可用实例的检测，指标以cache. 缓存检测针对一组基本指标进行了标准化。此外，还提供了特定于缓存的指标。

支持以下缓存库：

指标由缓存的名称和CacheManager从 bean 名称派生的名称标记。

自动配置为任何支持的传输启用 GraphQL 查询的检测。

Spring Boot 记录一个graphql.request计时器：

单个 GraphQL 查询可能涉及许多DataFetcher调用，因此有一个专用graphql.datafetcher计时器：

graphql.request.datafetch.count 分发摘要DataFetcher计算每个请求进行的重要调用的数量。该指标对于检测“N+1”数据获取问题和考虑批量加载很有用；它提供了对记录的请求"TOTAL"进行的数据获取程序调用的数量"COUNT"，以及"MAX"在所考虑的时间段内对单个请求进行的调用。更多选项可用于配置具有应用程序属性的分发。

单个响应可以包含许多 GraphQL 错误，由graphql.error计数器计数：

自动配置可以DataSource使用前缀为jdbc.connections. 数据源检测会生成表示池中当前活动、空闲、允许的最大连接数和允许的最小连接数的仪表。

指标也由DataSource基于 bean 名称计算的名称标记。

此外，Hikari 特定的指标以hikaricp前缀公开。每个指标都由池的名称标记（您可以使用 控制它spring.datasource.name）。

如果org.hibernate:hibernate-micrometer位于类路径上，则所有EntityManagerFactory启用了统计信息的可用 Hibernate 实例都使用名为hibernate.

度量标准也由 bean 的名称标记，该名称EntityManagerFactory派生自 bean 名称。

要启用统计信息，标准 JPA 属性hibernate.generate_statistics必须设置为true. 您可以在自动配置上启用它EntityManagerFactory：

自动配置启用所有 Spring DataRepository方法调用的检测。默认情况下，生成的指标名称为spring.data.repository.invocations. 您可以通过设置management.metrics.data.repository.metric-name属性来自定义名称。

@TimedRepository类和方法支持注释（有关详细信息，请参阅@Timed Annotation 支持）。如果您不想记录所有Repository调用的指标，则可以设置management.metrics.data.repository.autotime.enabled并false专门使用@Timed注释。

默认情况下，与存储库调用相关的指标标记有以下信息：

要替换默认标签，请提供一个@Bean实现RepositoryTagsProvider.

自动配置启用所有可用 RabbitMQ 连接工厂的检测，其度量标准名为rabbitmq.

只要bean 可用，Spring Integration 就会自动提供Micrometer 支持。MeterRegistry指标以spring.integration.计量名称发布。

自动配置分别为自动配置的消费者工厂和生产者工厂注册 aMicrometerConsumerListener和。MicrometerProducerListener它还注册了一个KafkaStreamsMicrometerListenerfor StreamsBuilderFactoryBean。有关更多详细信息，请参阅 Spring Kafka 文档的Micrometer Native Metrics部分。

本节简要介绍 MongoDB 的可用指标。

ThreadPool自动配置使用 Micrometer绑定 Jetty 的指标JettyServerThreadPoolMetrics。JettyConnector实例的指标使用 Micrometer 绑定JettyConnectionMetrics，当server.ssl.enabled设置为时true，Micrometer绑定JettySslHandshakeMetrics。

您可以@Timed将包中的注释io.micrometer.core.annotation与前面描述的几种支持的技术一起使用。如果支持，您可以在类级别或方法级别使用注释。

例如，以下代码显示了如何使用注解来检测 a 中的所有请求映射@RestController：

如果您只想检测单个映射，则可以在方法上使用注释而不是类：

如果要更改特定方法的计时详细信息，还可以组合类级别和方法级别的注释：

自动配置MicrometerCommandLatencyRecorder为自动配置的LettuceConnectionFactory. 有关更多详细信息，请参阅 Lettuce 文档的Micrometer Metrics 部分。

常用标签通常用于对操作环境进行维度下钻，例如主机、实例、区域、堆栈等。Commons 标签应用于所有仪表并且可以配置，如以下示例所示：

前面的示例分别向所有具有 和 值的仪表添加region和标记。stackus-east-1prod

除了MeterFilterbean 之外，您还可以使用属性以每米为基础应用一组有限的自定义。每米自定义适用于以给定名称开头的任何仪表 ID。以下示例禁用 ID 以example.remote

以下属性允许按米自定义：

有关 、 和 背后概念的更多详细信息percentiles-histogram，percentiles请slo参阅 Micrometer 文档的“直方图和百分位数”部分。