2.11. Ajout d'étiquettes d'identification des clusters aux métriques

Procédure

1. Modifiez l'objet cluster-monitoring-config ConfigMap dans le projet openshift-monitoring:

   $ oc -n openshift-monitoring edit configmap cluster-monitoring-config

   Copy to Clipboard Toggle word wrap
   Note

   Si vous configurez des étiquettes d'ID de cluster pour les mesures de l'instance Prometheus qui surveille les projets définis par l'utilisateur, modifiez la carte de configuration user-workload-monitoring-config dans l'espace de noms openshift-user-workload-monitoring. Notez que le composant Prometheus est appelé prometheus dans cette carte de configuration et non prometheusK8s, qui est le nom utilisé dans la carte de configuration cluster-monitoring-config.

2. Dans la section writeRelabelConfigs:, sous data/config.yaml/prometheusK8s/remoteWrite, ajoutez les valeurs de configuration de l'identifiant de cluster (cluster ID) :

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: cluster-monitoring-config
     namespace: openshift-monitoring
   data:
     config.yaml: |
       prometheusK8s:
         remoteWrite:
         - url: "https://remote-write-endpoint.example.com"
           <endpoint_authentication_credentials>
           writeRelabelConfigs: 

   1

   
             - <relabel_config> 

   2

   Copy to Clipboard Toggle word wrap

   1

   Ajoutez une liste de configurations d'étiquetage en écriture pour les mesures que vous souhaitez envoyer au point de terminaison distant.

   2

   Remplacer la configuration de l'étiquette par les métriques envoyées au point final d'écriture à distance.

   L'exemple suivant montre comment transmettre une métrique avec l'étiquette d'ID de cluster cluster_id dans la surveillance de la plate-forme par défaut :

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: cluster-monitoring-config
     namespace: openshift-monitoring
   data:
     config.yaml: |
       prometheusK8s:
         remoteWrite:
         - url: "https://remote-write-endpoint.example.com"
           writeRelabelConfigs:
           - sourceLabels:
             - __tmp_openshift_cluster_id__ 

   1

   
             targetLabel: cluster_id 

   2

   
             action: replace 

   3

   Copy to Clipboard Toggle word wrap

   1

   Le système applique initialement une étiquette source d'ID de cluster temporaire nommée __tmp_openshift_cluster_id__. Cette étiquette temporaire est remplacée par le nom de l'étiquette d'ID de cluster que vous spécifiez.

   2

   Indiquez le nom de l'étiquette d'identification du cluster pour les mesures envoyées au stockage en écriture à distance. Si vous utilisez un nom d'étiquette qui existe déjà pour une mesure, cette valeur est remplacée par le nom de cette étiquette d'ID de cluster. N'utilisez pas __tmp_openshift_cluster_id__ pour le nom de l'étiquette. L'étape finale de réétiquetage supprime les étiquettes qui utilisent ce nom.

   3

   L'action replace write relabel remplace l'étiquette temporaire par l'étiquette cible pour les métriques sortantes. Cette action est la valeur par défaut et est appliquée si aucune action n'est spécifiée.

3. Enregistrez le fichier pour appliquer les modifications à l'objet ConfigMap. Les pods concernés par la configuration mise à jour redémarrent automatiquement.

   Avertissement

   L'enregistrement des modifications apportées à un objet de surveillance ConfigMap peut entraîner le redéploiement des pods et d'autres ressources dans le projet concerné. L'enregistrement des modifications peut également redémarrer les processus de surveillance en cours dans ce projet.