11.8. Application d'une configuration personnalisée de l'Alertmanager
Vous pouvez écraser la configuration par défaut d'Alertmanager en modifiant le secret alertmanager-main
dans l'espace de noms openshift-monitoring
pour l'instance de plateforme d'Alertmanager.
Conditions préalables
-
Vous avez accès au cluster en tant qu'utilisateur ayant le rôle
cluster-admin
.
Procédure
Pour modifier la configuration de l'Alertmanager à partir du CLI :
Imprimer la configuration active de l'Alertmanager dans le fichier
alertmanager.yaml
:$ oc -n openshift-monitoring get secret alertmanager-main --template='{{ index .data "alertmanager.yaml" }}' | base64 --decode > alertmanager.yaml
Modifiez la configuration sur
alertmanager.yaml
:global: resolve_timeout: 5m route: group_wait: 30s group_interval: 5m repeat_interval: 12h receiver: default routes: - matchers: - "alertname=Watchdog" repeat_interval: 5m receiver: watchdog - matchers: - "service=<your_service>" 1 routes: - matchers: - <your_matching_rules> 2 receiver: <receiver> 3 receivers: - name: default - name: watchdog - name: <receiver> # <receiver_configuration>
NoteUtilisez le nom de clé
matchers
pour indiquer les critères de correspondance qu'une alerte doit remplir pour correspondre au nœud. N'utilisez pas les noms de clésmatch
oumatch_re
, qui sont tous deux obsolètes et dont la suppression est prévue dans une prochaine version.En outre, si vous définissez des règles d'inhibition, utilisez le nom de clé
target_matchers
pour indiquer les correspondants cibles et le nom de clésource_matchers
pour indiquer les correspondants sources. N'utilisez pas les noms de cléstarget_match
,target_match_re
,source_match
ousource_match_re
, qui sont obsolètes et dont la suppression est prévue dans une prochaine version.L'exemple de configuration suivant de l'Alertmanager configure PagerDuty en tant que récepteur d'alertes :
global: resolve_timeout: 5m route: group_wait: 30s group_interval: 5m repeat_interval: 12h receiver: default routes: - matchers: - "alertname=Watchdog" repeat_interval: 5m receiver: watchdog - matchers: - "service=example-app" routes: - matchers: - "severity=critical" receiver: team-frontend-page receivers: - name: default - name: watchdog - name: team-frontend-page pagerduty_configs: - service_key: "your-key"
Avec cette configuration, les alertes de gravité
critical
déclenchées par le serviceexample-app
sont envoyées à l'aide du récepteurteam-frontend-page
. En règle générale, ces types d'alertes sont envoyés à une personne ou à une équipe d'intervention critique.Appliquer la nouvelle configuration dans le fichier :
$ oc -n openshift-monitoring create secret generic alertmanager-main --from-file=alertmanager.yaml --dry-run=client -o=yaml | oc -n openshift-monitoring replace secret --filename=-
Pour modifier la configuration de l'Alertmanager à partir de la console web d'OpenShift Container Platform :
-
Naviguez jusqu'à la page Administration
Cluster Settings Configuration Alertmanager YAML de la console web. - Modifier le fichier de configuration YAML.
- Sélectionnez Save.