org.apache.hc.client5.http.observation.impl

Class MeteredDnsResolver

java.lang.Object

org.apache.hc.client5.http.observation.impl.MeteredDnsResolver

All Implemented Interfaces:

DnsResolver

public final class MeteredDnsResolver
extends Object
implements DnsResolver

DnsResolver wrapper that records DNS resolution metrics via Micrometer.

Exposes the following meters (names are prefixed by MetricConfig.prefix):

• <prefix>.dns.resolve (timer) — latency of resolve(String)
• <prefix>.dns.resolutions (counter) — outcome-count of resolve(String)
• <prefix>.dns.canonical (timer) — latency of resolveCanonicalHostname(String)
• <prefix>.dns.canonicals (counter) — outcome-count of resolveCanonicalHostname(String)

Tags:

• result = ok|error
• host (only when ObservingOptions.TagLevel#EXTENDED)
• plus any common tags

Since:

5.6

Constructor Summary

Constructors

Constructor and Description
MeteredDnsResolver(DnsResolver delegate, io.micrometer.core.instrument.MeterRegistry registry, MetricConfig mc, ObservingOptions opts)

Method Summary

Modifier and Type	Method and Description
InetAddress[]	resolve(String host)
String	resolveCanonicalHostname(String host)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.hc.client5.http.DnsResolver

resolve

Constructor Detail

MeteredDnsResolver

public MeteredDnsResolver(DnsResolver delegate,
                          io.micrometer.core.instrument.MeterRegistry registry,
                          MetricConfig mc,
                          ObservingOptions opts)

Parameters:

delegate - underlying resolver

registry - meter registry

mc - metric configuration (prefix, common tags). If null, defaults are used.

opts - observing options (for tag level). If null, ObservingOptions.DEFAULT is used.

Method Detail

resolve

public InetAddress[] resolve(String host)
                      throws UnknownHostException

Specified by:

resolve in interface DnsResolver

Throws:

UnknownHostException

resolveCanonicalHostname

public String resolveCanonicalHostname(String host)
                                throws UnknownHostException

Specified by:

resolveCanonicalHostname in interface DnsResolver

Throws:

UnknownHostException