7.7. Création de règles d’alerte pour les projets définis par l’utilisateur

Procédure

1. Créez un fichier YAML pour les règles d’alerte. Dans cet exemple, il est appelé example-app-alerting-rule.yaml.

2. Ajoutez une configuration de règle d’alerte au fichier YAML. L’exemple suivant crée une nouvelle règle d’alerte nommée exemple-alerte. La règle d’alerte déclenche une alerte lorsque la métrique de version exposée par le service d’échantillon devient 0:

   apiVersion: monitoring.coreos.com/v1
   kind: PrometheusRule
   metadata:
     name: example-alert
     namespace: ns1
   spec:
     groups:
     - name: example
       rules:
       - alert: VersionAlert 

   1

   
         for: 1m 

   2

   
         expr: version{job="prometheus-example-app"} == 0 

   3

   
         labels:
           severity: warning 

   4

   
         annotations:
           message: This is an example alert. 

   5

   Copy to Clipboard Toggle word wrap

   1

   Le nom de la règle d’alerte que vous souhaitez créer.

   2

   La durée pour laquelle la condition doit être vraie avant qu’une alerte ne soit déclenchée.

   3

   L’expression de requête PromQL qui définit la nouvelle règle.

   4

   La sévérité que la règle d’alerte attribue à l’alerte.

   5

   Le message associé à l’alerte.

3. Appliquer le fichier de configuration au cluster:

   $ oc apply -f example-app-alerting-rule.yaml

   Copy to Clipboard Toggle word wrap

Procédure

1. Éditez la carte de configuration de la configuration de l’utilisateur-workload-monitoring dans le projet openshift-user-workload-monitoring:

   $ oc -n openshift-user-workload-monitoring edit configmap user-workload-monitoring-config

   Copy to Clipboard Toggle word wrap

2. Configurez des projets dans lesquels vous souhaitez créer des règles d’alerte qui ne sont pas liées à un projet spécifique:

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: user-workload-monitoring-config
     namespace: openshift-user-workload-monitoring
   data:
     config.yaml: |
       namespacesWithoutLabelEnforcement: [ <namespace> ] 

   1

   
       # ...

   Copy to Clipboard Toggle word wrap

   1

   Indiquez un ou plusieurs projets dans lesquels vous souhaitez créer des règles d’alerte croisée. Les règles Prometheus et Thanos pour la surveillance définie par l’utilisateur n’appliquent pas l’étiquette de l’espace de noms dans les objets PrometheusRule créés dans ces projets.

3. Créez un fichier YAML pour les règles d’alerte. Dans cet exemple, il est appelé exemple-cross-project-alerting-rule.yaml.

4. Ajoutez une configuration de règle d’alerte au fichier YAML. L’exemple suivant crée une nouvelle règle d’alerte croisée appelée exemple-sécurité. La règle d’alerte s’allume lorsqu’un projet utilisateur n’applique pas la politique de sécurité des pods restreints:

   Exemple de règle d’alerte croisée de projet

   apiVersion: monitoring.coreos.com/v1
   kind: PrometheusRule
   metadata:
     name: example-security
     namespace: ns1 

   1

   
   spec:
     groups:
       - name: pod-security-policy
         rules:
           - alert: "ProjectNotEnforcingRestrictedPolicy" 

   2

   
             for: 5m 

   3

   
             expr: kube_namespace_labels{namespace!~"(openshift|kube).*|default",label_pod_security_kubernetes_io_enforce!="restricted"} 

   4

   
             annotations:
               message: "Restricted policy not enforced. Project {{ $labels.namespace }} does not enforce the restricted pod security policy." 

   5

   
             labels:
               severity: warning 

   6

   Copy to Clipboard Toggle word wrap

   1

   Assurez-vous de spécifier le projet que vous avez défini dans le champ namespaces WithoutLabelEnforcement.

   2

   Le nom de la règle d’alerte que vous souhaitez créer.

   3

   La durée pour laquelle la condition doit être vraie avant qu’une alerte ne soit déclenchée.

   4

   L’expression de requête PromQL qui définit la nouvelle règle.

   5

   Le message associé à l’alerte.

   6

   La sévérité que la règle d’alerte attribue à l’alerte.

   Important

   Assurez-vous de créer une règle d’alerte croisée spécifique dans un seul des projets que vous avez spécifiés dans le champ namespaces WithoutLabelEnforcement. Lorsque vous créez la même règle d’alerte croisée dans plusieurs projets, cela se traduit par des alertes répétées.

5. Appliquer le fichier de configuration au cluster:

   $ oc apply -f example-cross-project-alerting-rule.yaml

   Copy to Clipboard Toggle word wrap