mirror of
				https://github.com/coredns/coredns.git
				synced 2025-10-31 10:13:14 -04:00 
			
		
		
		
	Add a NativeHistogramBucketFactor parameter to the use of `NewHistogramVec` in order to enable use of Prometheus Native Histograms. This will store automatically computed sparse buckets in CoreDNS. If a compatible Prometeus requests native histograms this data will returned instead of the static buckets. The default factor of 1.05 should provide high quality resolution data. Signed-off-by: SuperQ <superq@gmail.com>
		
			
				
	
	
		
			93 lines
		
	
	
		
			3.7 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
			
		
		
	
	
			93 lines
		
	
	
		
			3.7 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
| package vars
 | |
| 
 | |
| import (
 | |
| 	"github.com/coredns/coredns/plugin"
 | |
| 
 | |
| 	"github.com/prometheus/client_golang/prometheus"
 | |
| 	"github.com/prometheus/client_golang/prometheus/promauto"
 | |
| )
 | |
| 
 | |
| // Request* and Response* are the prometheus counters and gauges we are using for exporting metrics.
 | |
| var (
 | |
| 	RequestCount = promauto.NewCounterVec(prometheus.CounterOpts{
 | |
| 		Namespace: plugin.Namespace,
 | |
| 		Subsystem: subsystem,
 | |
| 		Name:      "requests_total",
 | |
| 		Help:      "Counter of DNS requests made per zone, protocol and family.",
 | |
| 	}, []string{"server", "zone", "view", "proto", "family", "type"})
 | |
| 
 | |
| 	RequestDuration = promauto.NewHistogramVec(prometheus.HistogramOpts{
 | |
| 		Namespace:                   plugin.Namespace,
 | |
| 		Subsystem:                   subsystem,
 | |
| 		Name:                        "request_duration_seconds",
 | |
| 		Buckets:                     plugin.TimeBuckets,
 | |
| 		NativeHistogramBucketFactor: plugin.NativeHistogramBucketFactor,
 | |
| 		Help:                        "Histogram of the time (in seconds) each request took per zone.",
 | |
| 	}, []string{"server", "zone", "view"})
 | |
| 
 | |
| 	RequestSize = promauto.NewHistogramVec(prometheus.HistogramOpts{
 | |
| 		Namespace:                   plugin.Namespace,
 | |
| 		Subsystem:                   subsystem,
 | |
| 		Name:                        "request_size_bytes",
 | |
| 		Help:                        "Size of the EDNS0 UDP buffer in bytes (64K for TCP) per zone and protocol.",
 | |
| 		Buckets:                     []float64{0, 100, 200, 300, 400, 511, 1023, 2047, 4095, 8291, 16e3, 32e3, 48e3, 64e3},
 | |
| 		NativeHistogramBucketFactor: plugin.NativeHistogramBucketFactor,
 | |
| 	}, []string{"server", "zone", "view", "proto"})
 | |
| 
 | |
| 	RequestDo = promauto.NewCounterVec(prometheus.CounterOpts{
 | |
| 		Namespace: plugin.Namespace,
 | |
| 		Subsystem: subsystem,
 | |
| 		Name:      "do_requests_total",
 | |
| 		Help:      "Counter of DNS requests with DO bit set per zone.",
 | |
| 	}, []string{"server", "zone", "view"})
 | |
| 
 | |
| 	ResponseSize = promauto.NewHistogramVec(prometheus.HistogramOpts{
 | |
| 		Namespace:                   plugin.Namespace,
 | |
| 		Subsystem:                   subsystem,
 | |
| 		Name:                        "response_size_bytes",
 | |
| 		Help:                        "Size of the returned response in bytes.",
 | |
| 		Buckets:                     []float64{0, 100, 200, 300, 400, 511, 1023, 2047, 4095, 8291, 16e3, 32e3, 48e3, 64e3},
 | |
| 		NativeHistogramBucketFactor: plugin.NativeHistogramBucketFactor,
 | |
| 	}, []string{"server", "zone", "view", "proto"})
 | |
| 
 | |
| 	ResponseRcode = promauto.NewCounterVec(prometheus.CounterOpts{
 | |
| 		Namespace: plugin.Namespace,
 | |
| 		Subsystem: subsystem,
 | |
| 		Name:      "responses_total",
 | |
| 		Help:      "Counter of response status codes.",
 | |
| 	}, []string{"server", "zone", "view", "rcode", "plugin"})
 | |
| 
 | |
| 	Panic = promauto.NewCounter(prometheus.CounterOpts{
 | |
| 		Namespace: plugin.Namespace,
 | |
| 		Name:      "panics_total",
 | |
| 		Help:      "A metrics that counts the number of panics.",
 | |
| 	})
 | |
| 
 | |
| 	PluginEnabled = promauto.NewGaugeVec(prometheus.GaugeOpts{
 | |
| 		Namespace: plugin.Namespace,
 | |
| 		Name:      "plugin_enabled",
 | |
| 		Help:      "A metric that indicates whether a plugin is enabled on per server and zone basis.",
 | |
| 	}, []string{"server", "zone", "view", "name"})
 | |
| 
 | |
| 	HTTPSResponsesCount = promauto.NewCounterVec(prometheus.CounterOpts{
 | |
| 		Namespace: plugin.Namespace,
 | |
| 		Subsystem: subsystem,
 | |
| 		Name:      "https_responses_total",
 | |
| 		Help:      "Counter of DoH responses per server and http status code.",
 | |
| 	}, []string{"server", "status"})
 | |
| 
 | |
| 	QUICResponsesCount = promauto.NewCounterVec(prometheus.CounterOpts{
 | |
| 		Namespace: plugin.Namespace,
 | |
| 		Subsystem: subsystem,
 | |
| 		Name:      "quic_responses_total",
 | |
| 		Help:      "Counter of DoQ responses per server and QUIC application code.",
 | |
| 	}, []string{"server", "status"})
 | |
| )
 | |
| 
 | |
| const (
 | |
| 	subsystem = "dns"
 | |
| 
 | |
| 	// Dropped indicates we dropped the query before any handling. It has no closing dot, so it can not be a valid zone.
 | |
| 	Dropped = "dropped"
 | |
| )
 |