package envoy.extensions.clusters.dns.v3

Get desktop application:
View/edit binary Protocol Buffers messages

[#next-free-field: 10]

• optional google.protobuf.Duration dns_refresh_rate = 3

  This value is the cluster’s DNS refresh rate. The value configured must be at least 1ms. If this setting is not specified, the value defaults to 5000ms.

• optional DnsCluster.RefreshRate dns_failure_refresh_rate = 4

  This is the cluster’s DNS refresh rate when requests are failing. If this setting is not specified, the failure refresh rate defaults to the DNS refresh rate.

• bool respect_dns_ttl = 5

  Optional configuration for setting cluster's DNS refresh rate. If the value is set to true, cluster's DNS refresh rate will be set to resource record's TTL which comes from DNS resolution.

• optional google.protobuf.Duration dns_jitter = 6

  DNS jitter causes the cluster to refresh DNS entries later by a random amount of time to avoid a stampede of DNS requests. This value sets the upper bound (exclusive) for the random amount. There will be no jitter if this value is omitted.

• optional config.core.v3.TypedExtensionConfig typed_dns_resolver_config = 7

  DNS resolver type configuration extension. This extension can be used to configure c-ares, apple, or any other DNS resolver types and the related parameters. For example, an object of :ref:`CaresDnsResolverConfig<envoy_v3_api_msg_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig>` can be packed into this ``typed_dns_resolver_config``. This configuration replaces the :ref:`Cluster.typed_dns_resolver_config<envoy_v3_api_field_config.cluster.v3.Cluster.typed_dns_resolver_config>` configuration which replaces :ref:`Cluster.dns_resolution_config<envoy_v3_api_field_config.cluster.v3.Cluster.dns_resolution_config>`. During the transition period when :ref:`DnsCluster.typed_dns_resolver_config<envoy_v3_api_field_extensions.clusters.dns.v3.DnsCluster.typed_dns_resolver_config>`, :ref:`Cluster.typed_dns_resolver_config<envoy_v3_api_field_config.cluster.v3.Cluster.typed_dns_resolver_config>`, and :ref:`Cluster.dns_resolution_config<envoy_v3_api_field_config.cluster.v3.Cluster.dns_resolution_config>` exist, Envoy will use :ref:`DnsCluster.typed_dns_resolver_config<envoy_v3_api_field_extensions.clusters.dns.v3.DnsCluster.typed_dns_resolver_config>` and ignore DNS resolver-related fields in :ref:`Cluster<envoy_v3_api_msg_config.cluster.v3.Cluster>` if the cluster is configured via the :ref:`Cluster.cluster_type<envoy_v3_api_field_config.cluster.v3.Cluster.cluster_type>` extension point with the :ref:`DnsCluster<envoy_v3_api_msg_extensions.clusters.dns.v3.DnsCluster>` extension type. Otherwise, see :ref:`Cluster.typed_dns_resolver_config<envoy_v3_api_field_config.cluster.v3.Cluster.typed_dns_resolver_config>`. [#extension-category: envoy.network.dns_resolver]

• common.dns.v3.DnsLookupFamily dns_lookup_family = 8

  The DNS IP address resolution policy. If this setting is not specified, the value defaults to :ref:`AUTO<envoy_v3_api_enum_value_extensions.clusters.common.dns.v3.DnsLookupFamily.AUTO>`.

• bool all_addresses_in_single_endpoint = 9

  If true, all returned addresses are considered to be associated with a single endpoint, which maps to :ref:`logical DNS discovery <arch_overview_service_discovery_types_logical_dns>` semantics. Otherwise, each address is considered to be a separate endpoint, which maps to :ref:`strict DNS discovery <arch_overview_service_discovery_types_strict_dns>` semantics.

Used in: DnsCluster

• optional google.protobuf.Duration base_interval = 1

  Specifies the base interval between refreshes. This parameter is required and must be greater than zero and less than :ref:`max_interval <envoy_v3_api_field_extensions.clusters.dns.v3.DnsCluster.RefreshRate.max_interval>`.

• optional google.protobuf.Duration max_interval = 2

  Specifies the maximum interval between refreshes. This parameter is optional, but must be greater than or equal to the :ref:`base_interval <envoy_v3_api_field_extensions.clusters.dns.v3.DnsCluster.RefreshRate.base_interval>` if set. The default is 10 times the :ref:`base_interval <envoy_v3_api_field_extensions.clusters.dns.v3.DnsCluster.RefreshRate.base_interval>`.