Talk about the fetch-remote-regions-registry attribute of eurekclient



This article mainly studies the fetch-remote-regions-registry attribute of eureka client.

Configure fetch-remote-regions-registry

      "sourceType": "",
      "name": "eureka.client.fetch-remote-regions-registry",
      "description": "Comma separated list of regions for which the eureka registry information will be\n fetched. It is mandatory to define the availability zones for each of these regions\n as returned by availabilityZones. Failing to do so, will result in failure of\n discovery client startup.",
      "type": "java.lang.String"


spring-cloud-netflix-eureka-client-2.0.0.RC1-sources.jar! /org/springframework/cloud/netflix/eureka/

     * Comma separated list of regions for which the eureka registry information will be
     * fetched. It is mandatory to define the availability zones for each of these regions
     * as returned by availabilityZones. Failing to do so, will result in failure of
     * discovery client startup.
    private String fetchRemoteRegionsRegistry;

    public String fetchRegistryForRemoteRegions() {
        return this.fetchRemoteRegionsRegistry;

    public String getFetchRemoteRegionsRegistry() {
        return fetchRemoteRegionsRegistry;

    public void setFetchRemoteRegionsRegistry(String fetchRemoteRegionsRegistry) {
        this.fetchRemoteRegionsRegistry = fetchRemoteRegionsRegistry;

As can be seen from the text, if fetch-remote-regions-registry is configured, then the availability-zones corresponding to remote region needs to be configured, otherwise exceptions will be thrown. See the code for details.


eureka-client-1.8.8-sources.jar! /com/netflix/discovery/

     * A default for the mapping that we know of, if a remote region is configured to be fetched but does not have
     * any availability zone mapping, we will use these defaults. OTOH, if the remote region has any mapping defaults
     * will not be used.
    private final Multimap<String, String> defaultRegionVsAzMap =
            Multimaps.newListMultimap(new HashMap<String, Collection<String>>(), new Supplier<List<String>>() {
                public List<String> get() {
                    return new ArrayList<String>();

    public synchronized void setRegionsToFetch(String[] regionsToFetch) {
        if (null != regionsToFetch) {
            this.regionsToFetch = regionsToFetch;
  "Fetching availability zone to region mapping for regions {}", (Object) regionsToFetch);
            for (String remoteRegion : regionsToFetch) {
                Set<String> availabilityZones = getZonesForARegion(remoteRegion);
                if (null == availabilityZones
                        || (availabilityZones.size() == 1 && availabilityZones.contains(DEFAULT_ZONE))
                        || availabilityZones.isEmpty()) {
          "No availability zone information available for remote region: {}"
                            + ". Now checking in the default mapping.", remoteRegion);
                    if (defaultRegionVsAzMap.containsKey(remoteRegion)) {
                        Collection<String> defaultAvailabilityZones = defaultRegionVsAzMap.get(remoteRegion);
                        for (String defaultAvailabilityZone : defaultAvailabilityZones) {
                            availabilityZoneVsRegion.put(defaultAvailabilityZone, remoteRegion);
                    } else {
                        String msg = "No availability zone information available for remote region: " + remoteRegion
                                + ". This is required if registry information for this region is configured to be "
                                + "fetched.";
                        throw new RuntimeException(msg);
                } else {
                    for (String availabilityZone : availabilityZones) {
                        availabilityZoneVsRegion.put(availabilityZone, remoteRegion);

  "Availability zone to region mapping for all remote regions: {}", availabilityZoneVsRegion);
        } else {
  "Regions to fetch is null. Erasing older mapping if any.");
            this.regionsToFetch = EMPTY_STR_ARRAY;

As can be seen, if the availabilityZones corresponding to the region is empty or defaultZone, the defaultregionvsazmap.containskey (remoteregion) will be determined, and if false, the incoming branch will throw a RuntimeException.

Use fetch-remote-regions-registry


eureka-client-1.8.8-sources.jar! /com/netflix/discovery/

    void refreshRegistry() {
        try {
            boolean isFetchingRemoteRegionRegistries = isFetchingRemoteRegionRegistries();

            boolean remoteRegionsModified = false;
            // This makes sure that a dynamic change to remote regions to fetch is honored.
            String latestRemoteRegions = clientConfig.fetchRegistryForRemoteRegions();
            if (null != latestRemoteRegions) {
                String currentRemoteRegions = remoteRegionsToFetch.get();
                if (!latestRemoteRegions.equals(currentRemoteRegions)) {
                    // Both remoteRegionsToFetch and AzToRegionMapper.regionsToFetch need to be in sync
                    synchronized (instanceRegionChecker.getAzToRegionMapper()) {
                        if (remoteRegionsToFetch.compareAndSet(currentRemoteRegions, latestRemoteRegions)) {
                            String[] remoteRegions = latestRemoteRegions.split(",");
                            remoteRegionsModified = true;
                        } else {
                  "Remote regions to fetch modified concurrently," +
                                    " ignoring change from {} to {}", currentRemoteRegions, latestRemoteRegions);
                } else {
                    // Just refresh mapping to reflect any DNS/Property change

            boolean success = fetchRegistry(remoteRegionsModified);
            if (success) {
                registrySize = localRegionApps.get().size();
                lastSuccessfulRegistryFetchTimestamp = System.currentTimeMillis();

            if (logger.isDebugEnabled()) {
                StringBuilder allAppsHashCodes = new StringBuilder();
                allAppsHashCodes.append("Local region apps hashcode: ");
                allAppsHashCodes.append(", is fetching remote regions? ");
                for (Map.Entry<String, Applications> entry : remoteRegionVsApps.entrySet()) {
                    allAppsHashCodes.append(", Remote region: ");
                    allAppsHashCodes.append(" , apps hashcode: ");
                logger.debug("Completed cache refresh task for discovery. All Apps hash code is {} ",
        } catch (Throwable e) {
            logger.error("Cannot fetch registry from server", e);

    private boolean isFetchingRemoteRegionRegistries() {
        return null != remoteRegionsToFetch.get();

It can be seen here that if the remoteRegion has not changed, the logic to go is InstanceRegion Checker. GetAztorEgionMapper (). Refresh Mapping ();
This method of refreshRegistry has a scheduled task that will be called regularly.


eureka-client-1.8.8-sources.jar! /com/netflix/discovery/

    private final Map<String, String> availabilityZoneVsRegion = new ConcurrentHashMap<String, String>();

    public synchronized void refreshMapping() {"Refreshing availability zone to region mappings.");

RefreshMapping calls setRegionsToFetch, which mainly updates the mapping information of remote region and its availabilityZone in the configuration file to AvailabilityZone.


eureka-client-1.8.8-sources.jar! /com/netflix/discovery/

public class PropertyBasedAzToRegionMapper extends AbstractAzToRegionMapper {

    public PropertyBasedAzToRegionMapper(EurekaClientConfig clientConfig) {

    protected Set<String> getZonesForARegion(String region) {
        return new HashSet<String>(Arrays.asList(clientConfig.getAvailabilityZones(region)));


spring-cloud-netflix-eureka-client-2.0.0.RC1-sources.jar! /org/springframework/cloud/netflix/eureka/

     * Gets the list of availability zones (used in AWS data centers) for the region in
     * which this instance resides.
     * The changes are effective at runtime at the next registry fetch cycle as specified
     * by registryFetchIntervalSeconds.
    private Map<String, String> availabilityZones = new HashMap<>();

    public String[] getAvailabilityZones(String region) {
        String value = this.availabilityZones.get(region);
        if (value == null) {
            value = DEFAULT_ZONE;
        return value.split(",");

The availabilityZones here is the eureka.client.availability-zones attribute specified in the configuration file.

Using availabilityZoneVsRegion


eureka-client-1.8.8-sources.jar! /com/netflix/discovery/

    public String getRegionForAvailabilityZone(String availabilityZone) {
        String region = availabilityZoneVsRegion.get(availabilityZone);
        if (null == region) {
            return parseAzToGetRegion(availabilityZone);
        return region;

     * Tries to determine what region we're in, based on the provided availability zone.
     * @param availabilityZone the availability zone to inspect
     * @return the region, if available; null otherwise
    protected String parseAzToGetRegion(String availabilityZone) {
        // Here we see that whether the availability zone is following a pattern like <region><single letter>
        // If it is then we take ignore the last letter and check if the remaining part is actually a known remote
        // region. If yes, then we return that region, else null which means local region.
        if (!availabilityZone.isEmpty()) {
            String possibleRegion = availabilityZone.substring(0, availabilityZone.length() - 1);
            if (availabilityZoneVsRegion.containsValue(possibleRegion)) {
                return possibleRegion;
        return null;


eureka-client-1.8.8-sources.jar! /com/netflix/discovery/

    public String getInstanceRegion(InstanceInfo instanceInfo) {
        if (instanceInfo.getDataCenterInfo() == null || instanceInfo.getDataCenterInfo().getName() == null) {
            logger.warn("Cannot get region for instance id:{}, app:{} as dataCenterInfo is null. Returning local:{} by default",
                    instanceInfo.getId(), instanceInfo.getAppName(), localRegion);

            return localRegion;
        if (DataCenterInfo.Name.Amazon.equals(instanceInfo.getDataCenterInfo().getName())) {
            AmazonInfo amazonInfo = (AmazonInfo) instanceInfo.getDataCenterInfo();
            Map<String, String> metadata = amazonInfo.getMetadata();
            String availabilityZone = metadata.get(AmazonInfo.MetaDataKey.availabilityZone.getName());
            if (null != availabilityZone) {
                return azToRegionMapper.getRegionForAvailabilityZone(availabilityZone);

        return null;

InstanceRegionChecker. GetInstanceRegion uses AztoregionMapper. GetRegionForAvailabilityZone (AvailabilityZone)
However, it should be noted that this is only used when dataCenterInfo is Amazon.


The fetch-remote-regions-registry attribute of eureka client seems to be of great use. In actual code, it is only used when dataCenterInfo is Amazon. For normal non-Amazon environment, the default dataCenterInfo is MyOwn, so this attribute is not needed.