Création d’un fichier de configuration de gestionnaire d’alertes

Pour utiliser le gestionnaire d’alertes et le système de modélisation dans Amazon Managed Service for Prometheus, vous devez créer un fichier YAML de configuration de gestionnaire d’alertes. Un fichier de gestionnaire d’alertes Amazon Managed Service for Prometheus comporte deux sections principales :

• template_files: contient les modèles utilisés pour les messages envoyés par les destinataires. Pour plus d’informations, consultez les sections Référence de modèles et Exemples de modèles de la documentation Prometheus.

• alertmanager_config: contient la configuration du gestionnaire d’alertes. Il utilise la même structure qu’un fichier de configuration de gestionnaire d’alertes dans Prometheus autonome. Pour plus d’informations, consultez Configuration dans la documentation du gestionnaire d’alertes.

  Note

  La configuration repeat_interval décrite dans la documentation Prometheus ci-dessus comporte une limitation supplémentaire dans Amazon Managed Service for Prometheus. La valeur maximale autorisée est de cinq jours. Si vous définissez une durée supérieure à cinq jours, elle sera traitée comme cinq jours et les notifications seront à nouveau envoyées une fois la période de cinq jours écoulée.

Note

Vous pouvez également modifier le fichier de configuration directement dans la console Amazon Managed Service for Prometheus, mais il doit toujours respecter le format spécifié ici. Pour plus d'informations sur le téléchargement ou la modification d'un fichier de configuration, consultezTéléchargement du fichier de configuration de votre gestionnaire d’alertes sur Amazon Managed Service for Prometheus.

Dans Amazon Managed Service for Prometheus, le fichier de configuration de votre gestionnaire d’alertes doit contenir l’ensemble de la configuration dans une clé alertmanager_config située à la racine du fichier YAML.

Voici un exemple de fichier de configuration de gestionnaire d’alertes :

alertmanager_config: |
  route:
    receiver: 'default'
  receivers:
    - name: 'default'
      sns_configs:
      - topic_arn: arn:aws:sns:us-east-2:123456789012:My-Topic
        sigv4:
          region: us-east-2
        attributes:
          key: key1
          value: value1

Le seul récepteur actuellement pris en charge est Amazon Simple Notification Service (Amazon SNS). Si d’autres types de récepteurs sont répertoriés dans la configuration, ils seront rejetés.

Voici un autre exemple de fichier de configuration de gestionnaire d’alertes qui utilise à la fois le bloc template_files et le bloc alertmanager_config.

template_files:
  default_template: |
    {{ define "sns.default.subject" }}[{{ .Status | toUpper }}{{ if eq .Status "firing" }}:{{ .Alerts.Firing | len }}{{ end }}]{{ end }}
    {{ define "__alertmanager" }}AlertManager{{ end }}
    {{ define "__alertmanagerURL" }}{{ .ExternalURL }}/#/alerts?receiver={{ .Receiver | urlquery }}{{ end }}
alertmanager_config: |
  global:
  templates:
    - 'default_template'
  route:
    receiver: default
  receivers:
    - name: 'default'
      sns_configs:
      - topic_arn: arn:aws:sns:us-east-2:accountid:My-Topic
        sigv4:
          region: us-east-2
        attributes:
          key: severity
          value: SEV2

Bloc de modèle Amazon SNS par défaut

La configuration Amazon SNS par défaut utilise le modèle suivant, sauf si vous le remplacez explicitement.

{{ define "sns.default.message" }}{{ .CommonAnnotations.SortedPairs.Values | join " " }}
  {{ if gt (len .Alerts.Firing) 0 -}}
  Alerts Firing:
    {{ template "__text_alert_list" .Alerts.Firing }}
  {{- end }} 
  {{ if gt (len .Alerts.Resolved) 0 -}} 
  Alerts Resolved:
    {{ template "__text_alert_list" .Alerts.Resolved }}
  {{- end }}
{{- end }}