Add ttl obj to alertmanagercfgs resource

jsonnet/prometheus-operator/alertmanagerconfigs-crd.json

@@ -5921,6 +5921,11 @@
                       }
                     },
                     "type": "object"
+                  },
+                  "ttl": {
+                    "description": "The time to live definition for the alert notification",
+                    "pattern": "^(0|(([0-9]+)y)?(([0-9]+)w)?(([0-9]+)d)?(([0-9]+)h)?(([0-9]+)m)?(([0-9]+)s)?(([0-9]+)ms)?)$",
+                    "type": "string"
                   }
                 },
                 "type": "object"

jsonnet/prometheus-operator/alertmanagerconfigs-v1beta1-crd.libsonnet

@@ -5831,6 +5831,11 @@
                 },
                 type: 'array',
               },
+              ttl: {
+                description: 'The time to live definition for the alert notification',
+                pattern: '^(0|(([0-9]+)y)?(([0-9]+)w)?(([0-9]+)d)?(([0-9]+)h)?(([0-9]+)m)?(([0-9]+)s)?(([0-9]+)ms)?)$',
+                type: 'string',
+              },
             },
             type: 'object',
           },

pkg/alertmanager/amcfg.go

@@ -1609,6 +1609,14 @@ func (c *alertmanagerConfig) sanitize(amVersion semver.Version, logger log.Logge
 		}
 	}
 
+	if c.TTL != nil && amVersion.LT(semver.MustParse("0.27.0")) {
+		level.Warn(logger).Log(
+			"msg", "'ttl' supported in Alertmanager >= 0.27.0 only - dropping field from provided config",
+			"current_version", amVersion.String(),
+		)
+		c.TTL = nil
+	}
+
 	return c.Route.sanitize(amVersion, logger)
 }
 

pkg/alertmanager/amcfg_test.go

@@ -2135,6 +2135,9 @@ func TestSanitizeConfig(t *testing.T) {
 	versionMSTeamsSummaryAllowed := semver.Version{Major: 0, Minor: 27}
 	versionMSTeamsSummaryNotAllowed := semver.Version{Major: 0, Minor: 26}
 
+	versionTTLAllowed := semver.Version{Major: 0, Minor: 27}
+	versionTTLNotAllowed := semver.Version{Major: 0, Minor: 26}
+
 	for _, tc := range []struct {
 		name           string
 		againstVersion semver.Version
@@ -2264,6 +2267,26 @@ func TestSanitizeConfig(t *testing.T) {
 				},
 			},
 		},
+		{
+			name:           "Test TTL configuration is allowed for supported versions",
+			againstVersion: versionTTLAllowed,
+			in: &alertmanagerConfig{
+				TTL: ptr.To(monitoringingv1.Duration("1h")),
+			},
+			expect: alertmanagerConfig{
+				TTL: ptr.To(monitoringingv1.Duration("1h")),
+			},
+		},
+		{
+			name:           "Test TTL configuration is dropped for unsupported versions",
+			againstVersion: versionTTLNotAllowed,
+			in: &alertmanagerConfig{
+				TTL: ptr.To(monitoringingv1.Duration("30s")),
+			},
+			expect: alertmanagerConfig{
+				TTL: nil,
+			},
+		},
 		{
 			name:           "Test inhibit rules error with unsupported syntax",
 			againstVersion: matcherV2SyntaxNotAllowed,

pkg/alertmanager/types.go

@@ -19,6 +19,8 @@ import (
 
 	"github.com/prometheus/alertmanager/config"
 	"github.com/prometheus/common/model"
+
+	v1 "github.com/prometheus-operator/prometheus-operator/pkg/apis/monitoring/v1"
 )
 
 // Customization of Config type from alertmanager repo:
@@ -29,6 +31,7 @@ import (
 // https://github.com/prometheus/alertmanager/issues/1985
 type alertmanagerConfig struct {
 	Global            *globalConfig   `yaml:"global,omitempty" json:"global,omitempty"`
+	TTL               *v1.Duration    `yaml:"ttl,omitempty" json:"ttl,omitempty"`
 	Route             *route          `yaml:"route,omitempty" json:"route,omitempty"`
 	InhibitRules      []*inhibitRule  `yaml:"inhibit_rules,omitempty" json:"inhibit_rules,omitempty"`
 	Receivers         []*receiver     `yaml:"receivers,omitempty" json:"receivers,omitempty"`

pkg/apis/monitoring/v1alpha1/alertmanager_config_types.go

@@ -65,6 +65,9 @@ type AlertmanagerConfigList struct {
 // By definition, the Alertmanager configuration only applies to alerts for which
 // the `namespace` label is equal to the namespace of the AlertmanagerConfig resource.
 type AlertmanagerConfigSpec struct {
+	// The time to live definition for the alert notification
+	// +optional
+	TTL *monitoringv1.Duration `json:"ttl,omitempty"`
 	// The Alertmanager route definition for alerts matching the resource's
 	// namespace. If present, it will be added to the generated Alertmanager
 	// configuration as a first-level route.