traefik/pkg/metrics/prometheus_test.go

509 lines
15 KiB
Go
Raw Normal View History

package metrics
import (
2018-11-14 09:18:03 +00:00
"context"
"fmt"
"net/http"
"strconv"
"testing"
"time"
2019-08-03 01:58:23 +00:00
"github.com/containous/traefik/v2/pkg/config/dynamic"
th "github.com/containous/traefik/v2/pkg/testhelpers"
"github.com/containous/traefik/v2/pkg/types"
"github.com/prometheus/client_golang/prometheus"
dto "github.com/prometheus/client_model/go"
2018-08-06 12:58:03 +00:00
"github.com/stretchr/testify/assert"
)
2018-08-06 12:58:03 +00:00
func TestRegisterPromState(t *testing.T) {
// Reset state of global promState.
defer promState.reset()
testCases := []struct {
desc string
prometheusSlice []*types.Prometheus
initPromState bool
unregisterPromState bool
expectedNbRegistries int
}{
{
desc: "Register once",
prometheusSlice: []*types.Prometheus{{}},
initPromState: true,
2019-07-18 19:36:05 +00:00
unregisterPromState: false,
expectedNbRegistries: 1,
2018-08-06 12:58:03 +00:00
},
{
desc: "Register once with no promState init",
prometheusSlice: []*types.Prometheus{{}},
2019-07-18 19:36:05 +00:00
initPromState: false,
unregisterPromState: false,
expectedNbRegistries: 1,
2018-08-06 12:58:03 +00:00
},
{
desc: "Register twice",
prometheusSlice: []*types.Prometheus{{}, {}},
initPromState: true,
2019-07-18 19:36:05 +00:00
unregisterPromState: false,
expectedNbRegistries: 2,
2018-08-06 12:58:03 +00:00
},
{
desc: "Register twice with no promstate init",
prometheusSlice: []*types.Prometheus{{}, {}},
2019-07-18 19:36:05 +00:00
initPromState: false,
unregisterPromState: false,
expectedNbRegistries: 2,
2018-08-06 12:58:03 +00:00
},
{
desc: "Register twice with unregister",
prometheusSlice: []*types.Prometheus{{}, {}},
initPromState: true,
unregisterPromState: true,
2019-07-18 19:36:05 +00:00
expectedNbRegistries: 2,
2018-08-06 12:58:03 +00:00
},
}
for _, test := range testCases {
2019-07-18 19:36:05 +00:00
test := test
t.Run(test.desc, func(t *testing.T) {
actualNbRegistries := 0
for _, prom := range test.prometheusSlice {
if test.initPromState {
initStandardRegistry(prom)
}
if registerPromState(context.Background()) {
actualNbRegistries++
}
if test.unregisterPromState {
promRegistry.Unregister(promState)
}
promState.reset()
2018-08-06 12:58:03 +00:00
}
2019-07-18 19:36:05 +00:00
promRegistry.Unregister(promState)
assert.Equal(t, test.expectedNbRegistries, actualNbRegistries)
})
2018-08-06 12:58:03 +00:00
}
}
// reset is a utility method for unit testing. It should be called after each
// test run that changes promState internally in order to avoid dependencies
// between unit tests.
func (ps *prometheusState) reset() {
ps.collectors = make(chan *collector)
ps.describers = []func(ch chan<- *prometheus.Desc){}
ps.dynamicConfig = newDynamicConfig()
ps.state = make(map[string]*collector)
}
func TestPrometheus(t *testing.T) {
2019-07-18 19:36:05 +00:00
promState = newPrometheusState()
promRegistry = prometheus.NewRegistry()
2018-06-05 10:32:03 +00:00
// Reset state of global promState.
defer promState.reset()
2019-07-18 19:36:05 +00:00
prometheusRegistry := RegisterPrometheus(context.Background(), &types.Prometheus{AddEntryPointsLabels: true, AddServicesLabels: true})
defer promRegistry.Unregister(promState)
2019-07-18 19:36:05 +00:00
if !prometheusRegistry.IsEpEnabled() || !prometheusRegistry.IsSvcEnabled() {
t.Errorf("PrometheusRegistry should return true for IsEnabled()")
}
prometheusRegistry.ConfigReloadsCounter().Add(1)
prometheusRegistry.ConfigReloadsFailureCounter().Add(1)
prometheusRegistry.LastConfigReloadSuccessGauge().Set(float64(time.Now().Unix()))
prometheusRegistry.LastConfigReloadFailureGauge().Set(float64(time.Now().Unix()))
prometheusRegistry.
2019-07-18 19:36:05 +00:00
EntryPointReqsCounter().
With("code", strconv.Itoa(http.StatusOK), "method", http.MethodGet, "protocol", "http", "entrypoint", "http").
Add(1)
prometheusRegistry.
2019-07-18 19:36:05 +00:00
EntryPointReqDurationHistogram().
With("code", strconv.Itoa(http.StatusOK), "method", http.MethodGet, "protocol", "http", "entrypoint", "http").
Observe(1)
prometheusRegistry.
2019-07-18 19:36:05 +00:00
EntryPointOpenConnsGauge().
With("method", http.MethodGet, "protocol", "http", "entrypoint", "http").
Set(1)
prometheusRegistry.
2019-07-18 19:36:05 +00:00
ServiceReqsCounter().
With("service", "service1", "code", strconv.Itoa(http.StatusOK), "method", http.MethodGet, "protocol", "http").
Add(1)
prometheusRegistry.
2019-07-18 19:36:05 +00:00
ServiceReqDurationHistogram().
With("service", "service1", "code", strconv.Itoa(http.StatusOK), "method", http.MethodGet, "protocol", "http").
Observe(10000)
prometheusRegistry.
2019-07-18 19:36:05 +00:00
ServiceOpenConnsGauge().
With("service", "service1", "method", http.MethodGet, "protocol", "http").
Set(1)
prometheusRegistry.
2019-07-18 19:36:05 +00:00
ServiceRetriesCounter().
With("service", "service1").
Add(1)
prometheusRegistry.
2019-07-18 19:36:05 +00:00
ServiceServerUpGauge().
With("service", "service1", "url", "http://127.0.0.10:80").
Set(1)
delayForTrackingCompletion()
metricsFamilies := mustScrape()
2019-07-18 19:36:05 +00:00
testCases := []struct {
name string
labels map[string]string
assert func(*dto.MetricFamily)
}{
{
name: configReloadsTotalName,
assert: buildCounterAssert(t, configReloadsTotalName, 1),
},
{
name: configReloadsFailuresTotalName,
assert: buildCounterAssert(t, configReloadsFailuresTotalName, 1),
},
{
name: configLastReloadSuccessName,
assert: buildTimestampAssert(t, configLastReloadSuccessName),
},
{
name: configLastReloadFailureName,
assert: buildTimestampAssert(t, configLastReloadFailureName),
},
{
2019-07-18 19:36:05 +00:00
name: entryPointReqsTotalName,
labels: map[string]string{
"code": "200",
"method": http.MethodGet,
"protocol": "http",
"entrypoint": "http",
},
2019-07-18 19:36:05 +00:00
assert: buildCounterAssert(t, entryPointReqsTotalName, 1),
},
{
2019-07-18 19:36:05 +00:00
name: entryPointReqDurationName,
labels: map[string]string{
"code": "200",
"method": http.MethodGet,
"protocol": "http",
"entrypoint": "http",
},
2019-07-18 19:36:05 +00:00
assert: buildHistogramAssert(t, entryPointReqDurationName, 1),
},
{
2019-07-18 19:36:05 +00:00
name: entryPointOpenConnsName,
labels: map[string]string{
"method": http.MethodGet,
"protocol": "http",
"entrypoint": "http",
},
2019-07-18 19:36:05 +00:00
assert: buildGaugeAssert(t, entryPointOpenConnsName, 1),
},
{
2019-07-18 19:36:05 +00:00
name: serviceReqsTotalName,
labels: map[string]string{
"code": "200",
"method": http.MethodGet,
"protocol": "http",
2019-07-18 19:36:05 +00:00
"service": "service1",
},
2019-07-18 19:36:05 +00:00
assert: buildCounterAssert(t, serviceReqsTotalName, 1),
},
{
2019-07-18 19:36:05 +00:00
name: serviceReqDurationName,
labels: map[string]string{
"code": "200",
"method": http.MethodGet,
"protocol": "http",
2019-07-18 19:36:05 +00:00
"service": "service1",
},
2019-07-18 19:36:05 +00:00
assert: buildHistogramAssert(t, serviceReqDurationName, 1),
},
{
2019-07-18 19:36:05 +00:00
name: serviceOpenConnsName,
labels: map[string]string{
"method": http.MethodGet,
"protocol": "http",
2019-07-18 19:36:05 +00:00
"service": "service1",
},
2019-07-18 19:36:05 +00:00
assert: buildGaugeAssert(t, serviceOpenConnsName, 1),
},
{
2019-07-18 19:36:05 +00:00
name: serviceRetriesTotalName,
labels: map[string]string{
2019-07-18 19:36:05 +00:00
"service": "service1",
},
2019-07-18 19:36:05 +00:00
assert: buildGreaterThanCounterAssert(t, serviceRetriesTotalName, 1),
},
{
2019-07-18 19:36:05 +00:00
name: serviceServerUpName,
labels: map[string]string{
2019-07-18 19:36:05 +00:00
"service": "service1",
"url": "http://127.0.0.10:80",
},
2019-07-18 19:36:05 +00:00
assert: buildGaugeAssert(t, serviceServerUpName, 1),
},
}
2019-07-18 19:36:05 +00:00
for _, test := range testCases {
test := test
t.Run(test.name, func(t *testing.T) {
family := findMetricFamily(test.name, metricsFamilies)
if family == nil {
t.Errorf("gathered metrics do not contain %q", test.name)
return
}
2019-07-18 19:36:05 +00:00
for _, label := range family.Metric[0].Label {
val, ok := test.labels[*label.Name]
if !ok {
t.Errorf("%q metric contains unexpected label %q", test.name, *label.Name)
} else if val != *label.Value {
t.Errorf("label %q in metric %q has wrong value %q, expected %q", *label.Name, test.name, *label.Value, val)
}
}
test.assert(family)
})
}
}
2018-06-05 10:32:03 +00:00
func TestPrometheusMetricRemoval(t *testing.T) {
2019-07-18 19:36:05 +00:00
promState = newPrometheusState()
promRegistry = prometheus.NewRegistry()
2018-06-05 10:32:03 +00:00
// Reset state of global promState.
defer promState.reset()
2019-07-18 19:36:05 +00:00
prometheusRegistry := RegisterPrometheus(context.Background(), &types.Prometheus{AddEntryPointsLabels: true, AddServicesLabels: true})
defer promRegistry.Unregister(promState)
configurations := make(dynamic.Configurations)
configurations["providerName"] = &dynamic.Configuration{
HTTP: th.BuildConfiguration(
th.WithRouters(
th.WithRouter("foo",
th.WithServiceName("bar")),
),
th.WithLoadBalancerServices(th.WithService("bar",
th.WithServers(th.WithServer("http://localhost:9000"))),
),
2018-06-05 10:32:03 +00:00
),
}
2018-11-14 09:18:03 +00:00
2019-07-18 19:36:05 +00:00
OnConfigurationUpdate(configurations, []string{"entrypoint1"})
2018-06-05 10:32:03 +00:00
// Register some metrics manually that are not part of the active configuration.
// Those metrics should be part of the /metrics output on the first scrape but
// should be removed after that scrape.
prometheusRegistry.
2019-07-18 19:36:05 +00:00
EntryPointReqsCounter().
2018-06-05 10:32:03 +00:00
With("entrypoint", "entrypoint2", "code", strconv.Itoa(http.StatusOK), "method", http.MethodGet, "protocol", "http").
Add(1)
prometheusRegistry.
2019-07-18 19:36:05 +00:00
ServiceReqsCounter().
With("service", "service2", "code", strconv.Itoa(http.StatusOK), "method", http.MethodGet, "protocol", "http").
Add(1)
2018-06-05 10:32:03 +00:00
prometheusRegistry.
2019-07-18 19:36:05 +00:00
ServiceServerUpGauge().
With("service", "service1", "url", "http://localhost:9999").
2018-06-05 10:32:03 +00:00
Set(1)
delayForTrackingCompletion()
2019-07-18 19:36:05 +00:00
assertMetricsExist(t, mustScrape(), entryPointReqsTotalName, serviceReqsTotalName, serviceServerUpName)
assertMetricsAbsent(t, mustScrape(), entryPointReqsTotalName, serviceReqsTotalName, serviceServerUpName)
2018-06-05 10:32:03 +00:00
// To verify that metrics belonging to active configurations are not removed
// here the counter examples.
prometheusRegistry.
2019-07-18 19:36:05 +00:00
EntryPointReqsCounter().
2018-06-05 10:32:03 +00:00
With("entrypoint", "entrypoint1", "code", strconv.Itoa(http.StatusOK), "method", http.MethodGet, "protocol", "http").
Add(1)
2018-06-05 10:32:03 +00:00
delayForTrackingCompletion()
2019-07-18 19:36:05 +00:00
assertMetricsExist(t, mustScrape(), entryPointReqsTotalName)
assertMetricsExist(t, mustScrape(), entryPointReqsTotalName)
}
2018-06-05 10:32:03 +00:00
func TestPrometheusRemovedMetricsReset(t *testing.T) {
// Reset state of global promState.
defer promState.reset()
2019-07-18 19:36:05 +00:00
prometheusRegistry := RegisterPrometheus(context.Background(), &types.Prometheus{AddEntryPointsLabels: true, AddServicesLabels: true})
defer promRegistry.Unregister(promState)
2018-06-05 10:32:03 +00:00
labelNamesValues := []string{
2019-07-18 19:36:05 +00:00
"service", "service",
2018-06-05 10:32:03 +00:00
"code", strconv.Itoa(http.StatusOK),
"method", http.MethodGet,
"protocol", "http",
}
prometheusRegistry.
2019-07-18 19:36:05 +00:00
ServiceReqsCounter().
2018-06-05 10:32:03 +00:00
With(labelNamesValues...).
Add(3)
delayForTrackingCompletion()
2018-06-05 10:32:03 +00:00
metricsFamilies := mustScrape()
2019-07-18 19:36:05 +00:00
assertCounterValue(t, 3, findMetricFamily(serviceReqsTotalName, metricsFamilies), labelNamesValues...)
2018-06-05 10:32:03 +00:00
// There is no dynamic configuration and so this metric will be deleted
// after the first scrape.
2019-07-18 19:36:05 +00:00
assertMetricsAbsent(t, mustScrape(), serviceReqsTotalName)
2018-06-05 10:32:03 +00:00
prometheusRegistry.
2019-07-18 19:36:05 +00:00
ServiceReqsCounter().
2018-06-05 10:32:03 +00:00
With(labelNamesValues...).
Add(1)
delayForTrackingCompletion()
metricsFamilies = mustScrape()
2019-07-18 19:36:05 +00:00
assertCounterValue(t, 1, findMetricFamily(serviceReqsTotalName, metricsFamilies), labelNamesValues...)
}
// Tracking and gathering the metrics happens concurrently.
// In practice this is no problem, because in case a tracked metric would miss
// the current scrape, it would just be there in the next one.
// That we can test reliably the tracking of all metrics here, we sleep
// for a short amount of time, to make sure the metric will be present
// in the next scrape.
func delayForTrackingCompletion() {
time.Sleep(250 * time.Millisecond)
}
func mustScrape() []*dto.MetricFamily {
2019-07-18 19:36:05 +00:00
families, err := promRegistry.Gather()
if err != nil {
panic(fmt.Sprintf("could not gather metrics families: %s", err))
}
return families
}
2018-06-05 10:32:03 +00:00
func assertMetricsExist(t *testing.T, families []*dto.MetricFamily, metricNames ...string) {
t.Helper()
2018-06-05 10:32:03 +00:00
for _, metricName := range metricNames {
if findMetricFamily(metricName, families) == nil {
t.Errorf("gathered metrics should contain %q", metricName)
}
}
}
2018-06-05 10:32:03 +00:00
func assertMetricsAbsent(t *testing.T, families []*dto.MetricFamily, metricNames ...string) {
t.Helper()
2018-06-05 10:32:03 +00:00
for _, metricName := range metricNames {
if findMetricFamily(metricName, families) != nil {
t.Errorf("gathered metrics should not contain %q", metricName)
}
}
}
func findMetricFamily(name string, families []*dto.MetricFamily) *dto.MetricFamily {
for _, family := range families {
if family.GetName() == name {
return family
}
}
return nil
}
2018-06-05 10:32:03 +00:00
func findMetricByLabelNamesValues(family *dto.MetricFamily, labelNamesValues ...string) *dto.Metric {
if family == nil {
return nil
}
for _, metric := range family.Metric {
if hasMetricAllLabelPairs(metric, labelNamesValues...) {
return metric
}
}
return nil
}
func hasMetricAllLabelPairs(metric *dto.Metric, labelNamesValues ...string) bool {
for i := 0; i < len(labelNamesValues); i += 2 {
name, val := labelNamesValues[i], labelNamesValues[i+1]
if !hasMetricLabelPair(metric, name, val) {
return false
}
}
return true
}
func hasMetricLabelPair(metric *dto.Metric, labelName, labelValue string) bool {
for _, labelPair := range metric.Label {
if labelPair.GetName() == labelName && labelPair.GetValue() == labelValue {
return true
}
}
return false
}
func assertCounterValue(t *testing.T, want float64, family *dto.MetricFamily, labelNamesValues ...string) {
t.Helper()
metric := findMetricByLabelNamesValues(family, labelNamesValues...)
if metric == nil {
t.Error("metric must not be nil")
return
}
if metric.Counter == nil {
t.Errorf("metric %s must be a counter", family.GetName())
return
}
if cv := metric.Counter.GetValue(); cv != want {
t.Errorf("metric %s has value %v, want %v", family.GetName(), cv, want)
}
}
func buildCounterAssert(t *testing.T, metricName string, expectedValue int) func(family *dto.MetricFamily) {
return func(family *dto.MetricFamily) {
if cv := int(family.Metric[0].Counter.GetValue()); cv != expectedValue {
t.Errorf("metric %s has value %d, want %d", metricName, cv, expectedValue)
}
}
}
func buildGreaterThanCounterAssert(t *testing.T, metricName string, expectedMinValue int) func(family *dto.MetricFamily) {
return func(family *dto.MetricFamily) {
if cv := int(family.Metric[0].Counter.GetValue()); cv < expectedMinValue {
t.Errorf("metric %s has value %d, want at least %d", metricName, cv, expectedMinValue)
}
}
}
func buildHistogramAssert(t *testing.T, metricName string, expectedSampleCount int) func(family *dto.MetricFamily) {
return func(family *dto.MetricFamily) {
if sc := int(family.Metric[0].Histogram.GetSampleCount()); sc != expectedSampleCount {
t.Errorf("metric %s has sample count value %d, want %d", metricName, sc, expectedSampleCount)
}
}
}
func buildGaugeAssert(t *testing.T, metricName string, expectedValue int) func(family *dto.MetricFamily) {
return func(family *dto.MetricFamily) {
if gv := int(family.Metric[0].Gauge.GetValue()); gv != expectedValue {
t.Errorf("metric %s has value %d, want %d", metricName, gv, expectedValue)
}
}
}
func buildTimestampAssert(t *testing.T, metricName string) func(family *dto.MetricFamily) {
return func(family *dto.MetricFamily) {
if ts := time.Unix(int64(family.Metric[0].Gauge.GetValue()), 0); time.Since(ts) > time.Minute {
t.Errorf("metric %s has wrong timestamp %v", metricName, ts)
}
}
}