stackrox · parametalol · Sep 26, 2025 · May 28, 2025 · Sep 26, 2025 · Sep 26, 2025
diff --git a/central/metrics/custom/runner.go b/central/metrics/custom/runner.go
@@ -18,10 +18,12 @@ import (
 	"github.com/stackrox/rox/central/metrics/custom/tracker"
 	custom "github.com/stackrox/rox/central/metrics/custom/tracker"
 	policyDS "github.com/stackrox/rox/central/policy/datastore"
+	"github.com/stackrox/rox/central/telemetry/centralclient"
 	"github.com/stackrox/rox/generated/storage"
 	"github.com/stackrox/rox/pkg/grpc/authn"
 	"github.com/stackrox/rox/pkg/logging"
 	"github.com/stackrox/rox/pkg/sac"
+	"github.com/stackrox/rox/pkg/telemetry/phonehome/telemeter"
 )
 
 type trackerRunner []struct {
@@ -158,4 +160,16 @@ func (tr trackerRunner) ServeHTTP(w http.ResponseWriter, req *http.Request) {
 	registry.Lock()
 	defer registry.Unlock()
 	registry.ServeHTTP(w, req)
+	go phonehome()
+}
+
+func phonehome() {
+	props := map[string]any{
+		"Total custom Prometheus registries": metrics.GetCustomRegistriesCount(),
+	}
+
+	centralclient.Singleton().Telemeter().Track(
+		"Served custom Prometheus metrics", nil,
+		telemeter.WithTraits(props),
+		telemeter.WithNoDuplicates("prom_registries"))
 }
diff --git a/central/metrics/custom/tracker/tracker_base.go b/central/metrics/custom/tracker/tracker_base.go
@@ -1,20 +1,25 @@
 package tracker
 
 import (
+	"cmp"
 	"context"
 	"iter"
 	"maps"
 	"net/http"
 	"slices"
+	"strings"
 	"sync/atomic"
 	"time"
 
 	"github.com/pkg/errors"
 	"github.com/stackrox/rox/central/metrics"
+	"github.com/stackrox/rox/central/telemetry/centralclient"
 	"github.com/stackrox/rox/generated/storage"
 	"github.com/stackrox/rox/pkg/grpc/authn"
 	"github.com/stackrox/rox/pkg/logging"
+	"github.com/stackrox/rox/pkg/set"
 	"github.com/stackrox/rox/pkg/sync"
+	"github.com/stackrox/rox/pkg/telemetry/phonehome/telemeter"
 )
 
 var (
@@ -269,10 +274,34 @@ func (tracker *TrackerBase[Finding]) Gather(ctx context.Context) {
 	if cfg.period == 0 || time.Since(gatherer.lastGather) < cfg.period {
 		return
 	}
+	begin := time.Now()
 	if err := tracker.track(ctx, gatherer.registry, cfg.metrics); err != nil {
 		log.Errorf("Failed to gather %s metrics: %v", tracker.description, err)
 	}
-	gatherer.lastGather = time.Now()
+	end := time.Now()
+	gatherer.lastGather = end
+
+	descriptionTitle := strings.ToTitle(tracker.description[0:1]) + tracker.description[1:]
+	centralclient.Singleton().Telemeter().Track(
+		descriptionTitle+" metrics gathered", nil,
+		telemeter.WithTraits(tracker.makeProps(descriptionTitle, end.Sub(begin))),
+		telemeter.WithNoDuplicates(tracker.metricPrefix))
+}
+
+func (tracker *TrackerBase[Finding]) makeProps(descriptionTitle string, duration time.Duration) map[string]any {
+	props := make(map[string]any, 3)
+	props["Total "+descriptionTitle+" metrics"] = len(tracker.config.metrics)
+	props[descriptionTitle+" metrics labels"] = getLabels(tracker.config.metrics)
+	props[descriptionTitle+" gathering seconds"] = uint32(duration.Round(time.Second).Seconds())
+	return props
+}
+
+func getLabels(metrics MetricDescriptors) []Label {
+	labels := set.NewSet[Label]()
+	for _, metricLabels := range metrics {
+		labels.AddAll(metricLabels...)
+	}
+	return labels.AsSortedSlice(cmp.Less)
 }
 
 // getGatherer returns the existing or a new gatherer for the given userID.

diff --git a/central/metrics/custom/tracker/tracker_base_test.go b/central/metrics/custom/tracker/tracker_base_test.go
@@ -5,6 +5,7 @@ import (
 	"iter"
 	"maps"
 	"slices"
+	"strings"
 	"testing"
 	"time"
 
@@ -307,3 +308,33 @@ func makeAdminContext(t *testing.T) context.Context {
 	ctx := basic.ContextWithAdminIdentity(t, authProvider)
 	return ctx
 }
+
+func Test_makeProps(t *testing.T) {
+	ctrl := gomock.NewController(t)
+	rf := mocks.NewMockCustomRegistry(ctrl)
+
+	tracker := MakeTrackerBase("test", "telemetry test",
+		testLabelGetters,
+		makeTestGatherFunc(testData))
+	tracker.registryFactory = func(string) metrics.CustomRegistry { return rf }
+
+	md := makeTestMetricDescriptors(t)
+	tracker.Reconfigure(&Configuration{
+		metrics: md,
+		toAdd:   slices.Collect(maps.Keys(md)),
+		period:  time.Hour,
+	})
+	descriptionTitle := strings.ToTitle(tracker.description[0:1]) + tracker.description[1:]
+	props := tracker.makeProps(descriptionTitle, 12345*time.Millisecond)
+	get := func(key string) any {
+		if v, ok := props[key]; ok {
+			return v
+		}
+		return nil
+	}
+
+	assert.Len(t, props, 3)
+	assert.ElementsMatch(t, get("Telemetry test metrics labels"), []Label{"Cluster", "Namespace", "Severity"})
+	assert.Equal(t, len(md), get("Total Telemetry test metrics"))
+	assert.Equal(t, uint32(12), get("Telemetry test gathering seconds"))
+}
diff --git a/central/metrics/custom_registry.go b/central/metrics/custom_registry.go
@@ -99,3 +99,11 @@ func (cr *customRegistry) Reset(metricName string) {
 		gauge.(*prometheus.GaugeVec).Reset()
 	}
 }
+
+// GetCustomRegistriesCount returns the total number of currently known custom
+// registries.
+func GetCustomRegistriesCount() int {
+	registriesMux.Lock()
+	defer registriesMux.Unlock()
+	return len(userRegistries)
+}