常用应用配置属性

DeepSeek V3 中英对照 Common application properties

你可以在 application.properties 文件、application.yml 文件或作为命令行开关中指定各种属性。本附录提供了常见的 Spring Cloud Commons 属性列表，并引用了使用这些属性的底层类。

备注

属性贡献可以来自类路径上的额外 jar 文件，因此你不应将其视为一个详尽的列表。此外，你也可以定义自己的属性。

可观测性元数据

可观测性 - 指标

以下是本项目声明的所有指标列表。

断路器功能观测

当我们将传递给 CircuitBreaker 作为后备方案的函数进行包装时创建的观察结果。

指标名称 spring.cloud.circuitbreaker（由约定类 org.springframework.cloud.client.circuitbreaker.observation.DefaultCircuitBreakerObservationConvention 定义）。类型 timer。

指标名称 spring.cloud.circuitbreaker.active (由约定类 org.springframework.cloud.client.circuitbreaker.observation.DefaultCircuitBreakerObservationConvention 定义)。类型 long task timer。

important

在启动观测后添加的 KeyValues 可能不会出现在 *.active 指标中。

important

Micrometer 内部使用 纳秒 作为基本单位。然而，每个后端决定实际的基本单位。（例如，Prometheus 使用秒）

封闭类的完全限定名 org.springframework.cloud.client.circuitbreaker.observation.CircuitBreakerObservationDocumentation。

important

所有标签都必须以 spring.cloud.circuitbreaker 前缀开头！

表 1. 低基数键

名称	描述
spring.cloud.circuitbreaker.type (必填)	定义包装 lambda 的类型。

断路器供应商观察

当我们将传递给 CircuitBreaker 的 Supplier 包装起来时创建的观察。

指标名称 spring.cloud.circuitbreaker（由约定类 org.springframework.cloud.client.circuitbreaker.observation.DefaultCircuitBreakerObservationConvention 定义）。类型 timer。

指标名称 spring.cloud.circuitbreaker.active（由约定类 org.springframework.cloud.client.circuitbreaker.observation.DefaultCircuitBreakerObservationConvention 定义）。类型 long task timer。

important

在启动观测后添加的 KeyValues 可能不会出现在 *.active 指标中。

important

Micrometer 内部使用 纳秒 作为基本单位。然而，每个后端决定实际的基本单位。（例如，Prometheus 使用秒）

封闭类的完全限定名 org.springframework.cloud.client.circuitbreaker.observation.CircuitBreakerObservationDocumentation。

important

所有标签都必须以 spring.cloud.circuitbreaker 前缀开头！

表 2. 低基数键

Name	Description
spring.cloud.circuitbreaker.type (required)	定义包装 lambda 的类型。

可观测性 - 跨度

以下是本项目声明的所有 Span 列表。

断路器函数观测跨度

当我们将传递给 CircuitBreaker 作为后备方案的函数进行包装时创建的观察结果。

Span 名称 spring.cloud.circuitbreaker (由约定类 org.springframework.cloud.client.circuitbreaker.observation.DefaultCircuitBreakerObservationConvention 定义)。

封闭类的完全限定名 org.springframework.cloud.client.circuitbreaker.observation.CircuitBreakerObservationDocumentation。

important

所有标签都必须以 spring.cloud.circuitbreaker 前缀开头！

表 3. 标签键

Name	Description
spring.cloud.circuitbreaker.type (required)	定义包装 lambda 的类型。

断路器供应商观测跨度

当我们将传递给 CircuitBreaker 的 Supplier 包装时创建的观察。

Span 名称 spring.cloud.circuitbreaker (由约定类 org.springframework.cloud.client.circuitbreaker.observation.DefaultCircuitBreakerObservationConvention 定义)。

封闭类的完全限定名 org.springframework.cloud.client.circuitbreaker.observation.CircuitBreakerObservationDocumentation。

important

所有标签都必须以 spring.cloud.circuitbreaker 前缀开头！

表 4. 标签键

名称	描述
spring.cloud.circuitbreaker.type (required)	定义包装 lambda 的类型。

章节总结

📄️Configuration Properties

Below you can find a list of configuration properties.