add

Author: IgorIgnatevBolt

docs/metrics/workload/deployment-metrics.md

@@ -17,3 +17,4 @@
 | kube_deployment_metadata_generation                         | Gauge       |                                                                                                                           | `deployment`=&lt;deployment-name&gt; <br> `namespace`=&lt;deployment-namespace&gt;                                                                                          | STABLE       |
 | kube_deployment_labels                                      | Gauge       | Kubernetes labels converted to Prometheus labels controlled via [--metric-labels-allowlist](../../developer/cli-arguments.md)           | `deployment`=&lt;deployment-name&gt; <br> `namespace`=&lt;deployment-namespace&gt; <br> `label_DEPLOYMENT_LABEL`=&lt;DEPLOYMENT_LABEL&gt;                                   | STABLE       |
 | kube_deployment_created                                     | Gauge       |                                                                                                                           | `deployment`=&lt;deployment-name&gt; <br> `namespace`=&lt;deployment-namespace&gt;                                                                                          | STABLE       |
+| kube_deployment_deletion_timestamp                          | Gauge       |                                                                                                                           | `deployment`=&lt;deployment-name&gt; <br> `namespace`=&lt;deployment-namespace&gt;                                                                                          | EXPIREMENTAL|

internal/store/deployment.go

@@ -283,6 +283,26 @@ func deploymentMetricFamilies(allowAnnotationsList, allowLabelsList []string) []
 				}
 			}),
 		),
+		*generator.NewFamilyGeneratorWithStability(
+			"kube_deployment_deletion_timestamp",
+			"Unix deletion timestamp.",
+			metric.Gauge,
+			basemetrics.ALPHA,
+			"",
+			wrapDeploymentFunc(func(d *v1.Deployment) *metric.Family {
+				ms := []*metric.Metric{}
+
+				if !d.DeletionTimestamp.IsZero() {
+					ms = append(ms, &metric.Metric{
+						Value: float64(d.DeletionTimestamp.Unix()),
+					})
+				}
+
+				return &metric.Family{
+					Metrics: ms,
+				}
+			}),
+		),
 		*generator.NewFamilyGeneratorWithStability(
 			descDeploymentAnnotationsName,
 			descDeploymentAnnotationsHelp,

internal/store/deployment_test.go

@@ -31,6 +31,7 @@ import (
 var (
 	depl1Replicas int32 = 200
 	depl2Replicas int32 = 5
+	depl3Replicas int32 = 10
 
 	depl1MaxUnavailable = intstr.FromInt(10)
 	depl2MaxUnavailable = intstr.FromString("25%")
@@ -73,6 +74,8 @@ func TestDeploymentStore(t *testing.T) {
 		# TYPE kube_deployment_spec_strategy_rollingupdate_max_surge gauge
 		# HELP kube_deployment_labels [STABLE] Kubernetes labels converted to Prometheus labels.
 		# TYPE kube_deployment_labels gauge
+		# HELP kube_deployment_deletion_timestamp Unix deletion timestamp.
+		# TYPE kube_deployment_deletion_timestamp gauge
 	`
 	cases := []generateMetricsTestCase{
 		{
@@ -191,8 +194,30 @@ func TestDeploymentStore(t *testing.T) {
         kube_deployment_status_condition{deployment="depl2",namespace="ns2",condition="ReplicaFailure",status="unknown"} 0
 `,
 		},
+		{
+			Obj: &v1.Deployment{
+				ObjectMeta: metav1.ObjectMeta{
+					Name:              "deployment-terminating",
+					Namespace:         "ns3",
+					CreationTimestamp: metav1.Time{Time: time.Unix(1600000000, 0)},
+					DeletionTimestamp: &metav1.Time{Time: time.Unix(1800000000, 0)},
+					Labels: map[string]string{
+						"app": "example3",
+					},
+					Generation: 22,
+				},
+				Spec: v1.DeploymentSpec{
+					Paused:   true,
+					Replicas: &depl3Replicas,
+				},
+			},
+			Want: `
+			    # HELP kube_deployment_deletion_timestamp Unix deletion timestamp.
+			    # TYPE kube_deployment_deletion_timestamp gauge
+					kube_deployment_deletion_timestamp{deployment="deployment-terminating",namespace="ns3"} 1.8e+09`,
+			MetricNames: []string{"kube_deployment_deletion_timestamp"},
+		},
 	}
-
 	for i, c := range cases {
 		c.Func = generator.ComposeMetricGenFuncs(deploymentMetricFamilies(c.AllowAnnotationsList, nil))
 		c.Headers = generator.ExtractMetricFamilyHeaders(deploymentMetricFamilies(c.AllowAnnotationsList, nil))