feat: add hpa created metric

Author: IgorIgnatevBolt

docs/metrics/workload/horizontalpodautoscaler-metrics.md

@@ -13,3 +13,4 @@
 | kube_horizontalpodautoscaler_status_condition        | Gauge       |                                                                                                                           | `horizontalpodautoscaler`=&lt;hpa-name&gt; <br> `namespace`=&lt;hpa-namespace&gt; <br> `condition`=&lt;hpa-condition&gt; <br> `status`=&lt;true\|false\|unknown&gt;                                                                                      | STABLE       |
 | kube_horizontalpodautoscaler_status_current_replicas | Gauge       |                                                                                                                           | `horizontalpodautoscaler`=&lt;hpa-name&gt; <br> `namespace`=&lt;hpa-namespace&gt;                                                                                                                                                                        | STABLE       |
 | kube_horizontalpodautoscaler_status_desired_replicas | Gauge       |                                                                                                                           | `horizontalpodautoscaler`=&lt;hpa-name&gt; <br> `namespace`=&lt;hpa-namespace&gt;                                                                                                                                                                        | STABLE       |
+| kube_horizontalpodautoscaler_created | Gauge       |                                                                                                                           | `horizontalpodautoscaler`=&lt;hpa-name&gt; <br> `namespace`=&lt;hpa-namespace&gt;                                                                                                                                                                        | EXPERIMENTAL |

internal/store/horizontalpodautoscaler.go

@@ -66,6 +66,7 @@ func hpaMetricFamilies(allowAnnotationsList, allowLabelsList []string) []generat
 		createHPAAnnotations(allowAnnotationsList),
 		createHPALabels(allowLabelsList),
 		createHPAStatusCondition(),
+		createHPACreated(),
 	}
 }
 
@@ -413,3 +414,26 @@ func createHPAStatusCondition() generator.FamilyGenerator {
 		}),
 	)
 }
+
+func createHPACreated() generator.FamilyGenerator {
+	return *generator.NewFamilyGeneratorWithStability(
+		"kube_horizontalpodautoscaler_created",
+		"Unix creation timestamp",
+		metric.Gauge,
+		basemetrics.ALPHA,
+		"",
+		wrapHPAFunc(func(a *autoscaling.HorizontalPodAutoscaler) *metric.Family {
+			ms := []*metric.Metric{}
+
+			if !a.CreationTimestamp.IsZero() {
+				ms = append(ms, &metric.Metric{
+					Value: float64(a.CreationTimestamp.Unix()),
+				})
+			}
+
+			return &metric.Family{
+				Metrics: ms,
+			}
+		}),
+	)
+}

internal/store/horizontalpodautoscaler_test.go

@@ -18,6 +18,7 @@ package store
 
 import (
 	"testing"
+	"time"
 
 	autoscaling "k8s.io/api/autoscaling/v2"
 	v1 "k8s.io/api/core/v1"
@@ -46,6 +47,7 @@ func TestHPAStore(t *testing.T) {
 		# HELP kube_horizontalpodautoscaler_status_condition [STABLE] The condition of this autoscaler.
 		# HELP kube_horizontalpodautoscaler_status_current_replicas [STABLE] Current number of replicas of pods managed by this autoscaler.
 		# HELP kube_horizontalpodautoscaler_status_desired_replicas [STABLE] Desired number of replicas of pods managed by this autoscaler.
+		# HELP kube_horizontalpodautoscaler_created Unix creation timestamp
 		# TYPE kube_horizontalpodautoscaler_info gauge
 		# TYPE kube_horizontalpodautoscaler_annotations gauge
 		# TYPE kube_horizontalpodautoscaler_labels gauge
@@ -57,15 +59,17 @@ func TestHPAStore(t *testing.T) {
 		# TYPE kube_horizontalpodautoscaler_status_condition gauge
 		# TYPE kube_horizontalpodautoscaler_status_current_replicas gauge
 		# TYPE kube_horizontalpodautoscaler_status_desired_replicas gauge
+		# TYPE kube_horizontalpodautoscaler_created gauge
 	`
 	cases := []generateMetricsTestCase{
 		{
 			// Verify populating base metric.
 			Obj: &autoscaling.HorizontalPodAutoscaler{
 				ObjectMeta: metav1.ObjectMeta{
-					Generation: 2,
-					Name:       "hpa1",
-					Namespace:  "ns1",
+					Generation:        2,
+					Name:              "hpa1",
+					CreationTimestamp: metav1.Time{Time: time.Unix(1500000000, 0)},
+					Namespace:         "ns1",
 					Labels: map[string]string{
 						"app": "foobar",
 					},
@@ -233,6 +237,7 @@ func TestHPAStore(t *testing.T) {
 				kube_horizontalpodautoscaler_status_condition{condition="AbleToScale",horizontalpodautoscaler="hpa1",namespace="ns1",status="unknown"} 0
 				kube_horizontalpodautoscaler_status_current_replicas{horizontalpodautoscaler="hpa1",namespace="ns1"} 2
 				kube_horizontalpodautoscaler_status_desired_replicas{horizontalpodautoscaler="hpa1",namespace="ns1"} 2
+				kube_horizontalpodautoscaler_created{horizontalpodautoscaler="hpa1",namespace="ns1"} 1.5e+09
 			`,
 			MetricNames: []string{
 				"kube_horizontalpodautoscaler_info",
@@ -246,6 +251,7 @@ func TestHPAStore(t *testing.T) {
 				"kube_horizontalpodautoscaler_status_condition",
 				"kube_horizontalpodautoscaler_annotations",
 				"kube_horizontalpodautoscaler_labels",
+				"kube_horizontalpodautoscaler_created",
 			},
 		},
 		{
@@ -255,9 +261,10 @@ func TestHPAStore(t *testing.T) {
 			},
 			Obj: &autoscaling.HorizontalPodAutoscaler{
 				ObjectMeta: metav1.ObjectMeta{
-					Generation: 2,
-					Name:       "hpa2",
-					Namespace:  "ns1",
+					Generation:        2,
+					Name:              "hpa2",
+					CreationTimestamp: metav1.Time{Time: time.Unix(1500000000, 0)},
+					Namespace:         "ns1",
 					Labels: map[string]string{
 						"app": "foobar",
 					},
@@ -408,6 +415,7 @@ func TestHPAStore(t *testing.T) {
 				kube_horizontalpodautoscaler_status_condition{condition="AbleToScale",horizontalpodautoscaler="hpa2",namespace="ns1",status="unknown"} 0
 				kube_horizontalpodautoscaler_status_current_replicas{horizontalpodautoscaler="hpa2",namespace="ns1"} 2
 				kube_horizontalpodautoscaler_status_desired_replicas{horizontalpodautoscaler="hpa2",namespace="ns1"} 2
+				kube_horizontalpodautoscaler_created{horizontalpodautoscaler="hpa2",namespace="ns1"} 1.5e+09
 			`,
 			MetricNames: []string{
 				"kube_horizontalpodautoscaler_info",
@@ -421,6 +429,7 @@ func TestHPAStore(t *testing.T) {
 				"kube_horizontalpodautoscaler_status_condition",
 				"kube_horizontalpodautoscaler_annotation",
 				"kube_horizontalpodautoscaler_labels",
+				"kube_horizontalpodautoscaler_created",
 			},
 		},
 	}