.. _arch_overview_dns_resolution: DNS Resolution ============== Many Envoy components resolve DNS: different cluster types ( :ref:`strict dns `, :ref:`logical dns `); the :ref:`dynamic forward proxy ` system (which is composed of a cluster and a filter); the udp :ref:`dns filter `, etc. Envoy uses `c-ares `_ as a third party DNS resolution library. On Apple OSes Envoy additionally offers resolution using Apple specific APIs via the ``envoy.restart_features.use_apple_api_for_dns_lookups`` runtime feature. The Apple-based DNS Resolver emits the following stats rooted in the ``dns.apple`` stats tree: .. csv-table:: :header: Name, Type, Description :widths: 1, 1, 2 connection_failure, Counter, Number of failed attempts to connect to the DNS server socket_failure, Counter, Number of failed attempts to obtain a file descriptor to the socket to the DNS server processing_failure, Counter, Number of failures when processing data from the DNS server