Document Load Balancing in Spring Cloud Netflix

Documentation Request: Load Balancing in Spring Cloud Netflix

Overview

Spring Cloud Netflix provides integrated load balancing capabilities primarily via Spring Cloud LoadBalancer and Eureka service discovery. Clear documentation will help users understand:

• How load balancing works with Eureka and Spring Cloud LoadBalancer
• Key configuration properties
• Zone-preference logic and metadata
• How to enable/disable or customize load balancing for services
• Best practices and common pitfalls

Core Areas to Cover

• Spring Cloud LoadBalancer Usage
  • How service instances are selected for requests
  • Relationship to DiscoveryClient and logical Eureka service identifiers (VIPs)
• Zone Preference and Configuration
  • How zone is determined (instance metadata, hostname, client config)
  • The role of spring.cloud.loadbalancer.eureka.approximateZoneFromHostname
• Properties and Customization
  • Main configuration properties (with sample values)
  • Example YAML/Java configuration snippets
• Eureka Metadata & Filtering
  • Use of eureka.instance.metadataMap.zone
• Troubleshooting Tips
  • Common misconfigurations
  • How to verify load balancing behavior in logs
• References to Source Code
  • EurekaLoadBalancerProperties.java
  • EurekaLoadBalancerClientConfiguration.java

Benefit

Improved documentation will assist users in comprehending, enabling, and troubleshooting load balancing in Spring Cloud Netflix microservice deployments.

Start by reading EurekaLoadBalancerProperties.java and EurekaLoadBalancerClientConfiguration.java, the two source files referenced in the request, to verify configuration and zone-preference behavior. Done means documentation covers LoadBalancer usage, Eureka discovery and metadata filtering, configuration and customization examples, troubleshooting, and relevant source references.