Skip to content

Eureka 配置详解

Eureka 包含四个部分的配置

  • instance:当前Eureka Instance 实例信息配置

  • client:Eureka Client 客户端特性配置

  • server:Eureka Server注册中心特性配置

  • dashboard:Eureka Server注册中心仪表盘配置

Eureka Instance 实例信息配置

Eureka Instance的配置信息全部保存在 org.springframework.cloud.netflix.eureka.EurekaInstanceConfigBean 配置类里,实际上它是 com.netflix.appinfo.EurekaInstanceConfig 的实现类,替代了netflix的com.netflix.appinfo.CloudInstanceConfig 的默认实现。Eureka Instance 的配置信息全部以 eureka.instance.xxx 的格式配置。

  • appname = unknown 应用名,首先获取 spring.application.name 的值,如果取值为空,则取默认unknown。

  • appGroupName = null 应用组名

  • instanceEnabledOnit = false 实例注册到Eureka上是,是否立刻开启通讯。有时候应用在准备好服务之前需要一些预处理。

  • nonSecurePort = 80 非安全的端口

  • securePort = 443 安全端口

  • nonSecurePortEnabled = true 是否开启非安全端口通讯

  • securePortEnabled = false 是否开启安全端口通讯

  • leaseRenewalIntervalInSeconds = 30 实例续约间隔时间

  • leaseExpirationDurationInSeconds = 90 实例超时时间,表示最大leaseExpirationDurationInSeconds秒后没有续约,Server就认为他不可用了,随之就会将其剔除。

  • virtualHostName = unknown 虚拟主机名,首先获取 spring.application.name 的值,如果取值为空,则取默认unknown。

  • instanceId 注册到eureka上的唯一实例ID,不能与相同appname的其他实例重复。

  • secureVirtualHostName = unknown 安全虚拟主机名,首先获取 spring.application.name 的值,如果取值为空,则取默认 unknown。

  • metadataMap = new HashMap(); 实例元数据,可以供其他实例使用。比如spring-boot-admin在监控时,获取实例的上下文和端口

  • dataCenterInfo = new MyDataCenterInfo(DataCenterInfo.Name.MyOwn); 实例部署的数据中心。如AWS、MyOwn。

  • ipAddress=null 实例的IP地址

  • statusPageUrlPath = “/actuator/info” 实例状态页相对url

  • statusPageUrl = null 实例状态页绝对URL

  • homePageUrlPath = “/” 实例主页相对URL

  • homePageUrl = null 实例主页绝对URL

  • healthCheckUrlUrlPath = “/actuator/health” 实例健康检查相对URL

  • healthCheckUrl = null 实例健康检查绝对URL

  • secureHealthCheckUrl = null 实例安全的健康检查绝对URL

  • namespace = “eureka” 配置属性的命名空间(Spring Cloud中被忽略)

  • hostname = null 主机名,不配置的时候讲根据操作系统的主机名来获取

  • preferIpAddress = false 是否优先使用IP地址作为主机名的标识

Eureka Client 客户端特性配置

Eureka Client客户端特性配置是对作为Eureka客户端的特性配置,包括Eureka注册中心,本身也是一个Eureka Client。Eureka Client特性配置全部在 org.springframework.cloud.netflix.eureka.EurekaClientConfigBean 中,实际上它是 com.netflix.discovery.EurekaClientConfig 的实现类,替代了netxflix的默认实现。Eureka Client客户端特性配置全部以 eureka.client.xxx 的格式配置。

  • enabled=true 是否启用Eureka client。

  • registryFetchIntervalSeconds=30 定时从Eureka Server拉取服务注册信息的间隔时间

  • instanceInfoReplicationIntervalSeconds=30 定时将实例信息(如果变化了)复制到Eureka Server的间隔时间。(InstanceInfoReplicator线程)

  • initialInstanceInfoReplicationIntervalSeconds=40 首次将实例信息复制到Eureka Server的延迟时间。(InstanceInfoReplicator线程)

  • eurekaServiceUrlPollIntervalSeconds=300 拉取Eureka Server地址的间隔时间(Eureka Server有可能增减)

  • proxyPort=null Eureka Server的代理端口

  • proxyHost=null Eureka Server的代理主机名

  • proxyUserName=null Eureka Server的代理用户名

  • proxyPassword=null Eureka Server的代理密码

  • eurekaServerReadTimeoutSeconds=8 从Eureka Server读取信息的超时时间

  • eurekaServerConnectTimeoutSeconds=5 连接Eureka Server的超时时间

  • backupRegistryImpl=null Eureka Client第一次启动时获取服务注册信息的调用的回溯实现。Eureka Client启动时首次会检查有没有BackupRegistry的实现类,如果有实现类,则优先从这个实现类里获取服务注册信息。

  • eurekaServerTotalConnections=200 Eureka client连接Eureka Server的链接总数

  • eurekaServerTotalConnectionsPerHost=50 Eureka client连接单台Eureka Server的链接总数

  • eurekaServerURLContext=null 当Eureka server的列表在DNS中时,Eureka Server的上下文路径。如http://xxxx/eureka。

  • eurekaServerPort=null 当Eureka server的列表在DNS中时,Eureka Server的端口。

  • eurekaServerDNSName=null 当Eureka server的列表在DNS中时,且要通过DNSName获取Eureka Server列表时,DNS名字。

  • region=“us-east-1” 实例所属区域。

  • eurekaConnectionIdleTimeoutSeconds = 30 Eureka Client和Eureka Server之间的Http连接的空闲超时时间。

  • heartbeatExecutorThreadPoolSize=2 心跳(续约)执行器线程池大小。

  • heartbeatExecutorExponentialBackOffBound=10 心跳执行器在续约过程中超时后的再次执行续约的最大延迟倍数。默认最大延迟时间=10 * eureka.instance.leaseRenewalIntervalInSeconds

  • cacheRefreshExecutorThreadPoolSize=2 cacheRefreshExecutord的线程池大小(获取注册信息)

  • cacheRefreshExecutorExponentialBackOffBound=10 cacheRefreshExecutord的再次执行的最大延迟倍数。默认最大延迟时间=10 *eureka.client.registryFetchIntervalSeconds

  • serviceUrl= new HashMap();serviceUrl.put(DEFAULT_ZONE, DEFAULT_URL); Eureka Server的分区地址。默认添加了一个defualtZone。也就是最常用的配置eureka.client.service-url.defaultZone=xxx

  • registerWithEureka=true 是否注册到Eureka Server。

  • preferSameZoneEureka=true 是否使用相同Zone下的Eureka server。

  • logDeltaDiff=false 是否记录Eureka Server和Eureka Client之间注册信息的差异

  • disableDelta=false 是否开启增量同步注册信息。

  • fetchRemoteRegionsRegistry=null 获取注册服务的远程地区,以逗号隔开。

  • availabilityZones=new HashMap() 可用分区列表。用逗号隔开。

  • filterOnlyUpInstances = true 是否只拉取UP状态的实例。

  • fetchRegistry=true 是否拉取注册信息。

  • shouldUnregisterOnShutdown = true 是否在停止服务的时候向Eureka Server发起Cancel指令。

  • shouldEnforceRegistrationAtInit = false 是否在初始化过程中注册服务。

Eureka Server 注册中心端配置

Eureka Server 注册中心端的配置是对注册中心的特性配置。Eureka Server的配置全部在 org.springframework.cloud.netflix.eureka.server.EurekaServerConfigBean 里,实际上它是com.netflix.eureka.EurekaServerConfig 的实现类,替代了netflix的默认实现。Eureka Server的配置全部以 eureka.server.xxx 的格式进行配置。

  • enableSelfPreservation=true 是否开启自我保护

  • renewalPercentThreshold = 0.85 自我保护续约百分比阀值因子。如果实际续约数小于续约数阀值,则开启自我保护

  • renewalThresholdUpdateIntervalMs = 15 60 1000 续约数阀值更新频率。

  • peerEurekaNodesUpdateIntervalMs = 10 60 1000 Eureka Server节点更新频率。

  • enableReplicatedRequestCompression = false 是否启用复制请求压缩。

  • waitTimeInMsWhenSyncEmpty=5 60 1000 当从其他节点同步实例信息为空时等待的时间。

  • peerNodeConnectTimeoutMs=200 节点间连接的超时时间。

  • peerNodeReadTimeoutMs=200 节点间读取信息的超时时间。

  • peerNodeTotalConnections=1000 节点间连接总数。

  • peerNodeTotalConnectionsPerHost = 500; 单个节点间连接总数。

  • peerNodeConnectionIdleTimeoutSeconds = 30; 节点间连接空闲超时时间。

  • retentionTimeInMSInDeltaQueue = 3 * MINUTES; 增量队列的缓存时间。

  • deltaRetentionTimerIntervalInMs = 30 * 1000; 清理增量队列中过期的频率。

  • evictionIntervalTimerInMs = 60 * 1000; 剔除任务频率。

  • responseCacheAutoExpirationInSeconds = 180; 注册列表缓存超时时间(当注册列表没有变化时)

  • responseCacheUpdateIntervalMs = 30 * 1000; 注册列表缓存更新频率。

  • useReadOnlyResponseCache = true; 是否开启注册列表的二级缓存。

  • disableDelta=false。 是否为client提供增量信息。

  • maxThreadsForStatusReplication = 1; 状态同步的最大线程数。

  • maxElementsInStatusReplicationPool = 10000; 状态同步队列的最大容量。

  • syncWhenTimestampDiffers = true; 当时间差异时是否同步。

  • registrySyncRetries = 0; 注册信息同步重试次数。

  • registrySyncRetryWaitMs = 30 * 1000; 注册信息同步重试期间的时间间隔。

  • maxElementsInPeerReplicationPool = 10000; 节点间同步事件的最大容量。

  • minThreadsForPeerReplication = 5; 节点间同步的最小线程数。

  • maxThreadsForPeerReplication = 20; 节点间同步的最大线程数。

  • maxTimeForReplication = 30000; 节点间同步的最大时间,单位为毫秒。

  • disableDeltaForRemoteRegions = false; 是否启用远程区域增量。

  • remoteRegionConnectTimeoutMs = 1000; 远程区域连接超时时间。

  • remoteRegionReadTimeoutMs = 1000; 远程区域读取超时时间。

  • remoteRegionTotalConnections = 1000; 远程区域最大连接数

  • remoteRegionTotalConnectionsPerHost = 500; 远程区域单机连接数

  • remoteRegionConnectionIdleTimeoutSeconds = 30; 远程区域连接空闲超时时间。

  • remoteRegionRegistryFetchInterval = 30; 远程区域注册信息拉取频率。

  • remoteRegionFetchThreadPoolSize = 20; 远程区域注册信息线程数。

Eureka Server注册中心仪表盘配置

注册中心仪表盘的配置主要是控制注册中心的可视化展示。以eureka.dashboard.xxx的格式配置。

  • path="/" 仪表盘访问路径

  • enabled=true 是否启用仪表盘