Creazione di un file di configurazione di alert manager

Per utilizzare la gestione degli avvisi e la creazione di modelli nel servizio gestito da Amazon per Prometheus, devi creare un file YAML di configurazione di alert manager. Un file di alert manager del servizio gestito da Amazon per Prometheus è composto da due sezioni principali:

• template_files: contiene i modelli utilizzati per i messaggi inviati dai destinatari. Per ulteriori informazioni, vedere Modello di riferimento ed Esempi di modello nella documentazione di Prometheus.

• alertmanager_config: contiene la configurazione di alert manager. Questo utilizza la stessa struttura di un file di configurazione di alert manager in Prometheus autonomo. Per ulteriori informazioni, consulta Configurazione nella documentazione di Alertmanager.

  Nota

  La repeat_interval configurazione descritta nella documentazione di Prometheus sopra riportata presenta un'ulteriore limitazione nel servizio gestito da Amazon per Prometheus. Il valore massimo consentito è cinque giorni. Se lo imposti per un periodo superiore a cinque giorni, verrà considerato come un periodo di cinque giorni e le notifiche verranno inviate nuovamente dopo la scadenza del periodo di cinque giorni.

Nota

Puoi anche modificare il file di configurazione direttamente nella console Amazon Managed Service for Prometheus, ma deve comunque seguire il formato specificato qui. Per ulteriori informazioni sul caricamento o la modifica di un file di configurazione, consulta. Caricamento del file di configurazione di alert manager per il servizio gestito da Amazon per Prometheus

Nel servizio gestito da Amazon per Prometheus, il file di configurazione di alert manager deve avere tutto il contenuto di configurazione di alert manager all'interno di alertmanager_config una chiave nella radice del file YAML.

Di seguito è riportato un esempio di file di configurazione di alert manager di base:

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

L'unico ricevitore attualmente supportato è Amazon Simple Notification Service (Amazon SNS). Se nella configurazione sono elencati altri tipi di ricevitori, questi verranno rifiutati.

Ecco un altro esempio di file di configurazione di alert manager che utilizza sia il blocco template_files sia il blocco 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

Blocco modello Amazon SNS predefinito

La configurazione predefinita di Amazon SNS utilizza il seguente modello, a meno che tu non lo sostituisca esplicitamente.

{{ 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 }}