3.9. Ajout d’étiquettes de cluster ID aux métriques


Lorsque vous gérez plusieurs clusters dédiés OpenShift et utilisez la fonction d’écriture à distance pour envoyer des données métriques de ces clusters à un emplacement de stockage externe, vous pouvez ajouter des étiquettes ID de cluster pour identifier les données métriques provenant de différents clusters. Ensuite, vous pouvez interroger ces étiquettes pour identifier le cluster source d’une métrique et distinguer ces données des données de mesures similaires envoyées par d’autres clusters.

De cette façon, si vous gérez de nombreux clusters pour plusieurs clients et envoyez des données métriques à un seul système de stockage centralisé, vous pouvez utiliser des étiquettes d’identification de cluster pour interroger des métriques pour un cluster ou un client particulier.

La création et l’utilisation d’étiquettes de cluster ID comporte trois étapes générales:

  • Configuration des paramètres de relabel d’écriture pour le stockage d’écriture à distance.
  • Ajout d’étiquettes de cluster ID aux métriques.
  • Interroger ces étiquettes pour identifier le cluster source ou le client pour une métrique.

Il est possible de créer des étiquettes ID de cluster pour les métriques en ajoutant les paramètres write_relabel pour le stockage d’écriture à distance dans la carte de configuration de configuration de la charge de travail de l’utilisateur dans l’espace de noms openshift-user-workload-monitoring.

Conditions préalables

  • En tant qu’utilisateur, vous avez accès au cluster avec le rôle d’administrateur dédié.
  • L’objet ConfigMap existe. Cet objet est créé par défaut lorsque le cluster est créé.
  • L’OpenShift CLI (oc) a été installé.
  • Le stockage d’écriture à distance a été configuré.

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. Dans la section writeRelabelConfigs: sous data/config.yaml/prometheus/remoteWrite, ajoutez les valeurs de configuration du cluster ID:

    apiVersion: v1
    kind: ConfigMap
    metadata:
      name: user-workload-monitoring-config
      namespace: openshift-user-workload-monitoring
    data:
      config.yaml: |
        prometheus:
          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 de relabel d’écriture pour les métriques que vous souhaitez envoyer au point de terminaison distant.
    2
    De substituer la configuration de l’étiquette aux métriques envoyées au point de terminaison de l’écriture distante.

    L’échantillon suivant montre comment transférer une métrique avec le cluster ID cluster_id:

    apiVersion: v1
    kind: ConfigMap
    metadata:
      name: user-workload-monitoring-config
      namespace: openshift-user-workload-monitoring
    data:
      config.yaml: |
        prometheus:
          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 de cluster temporaire nommée __tmp_openshift_cluster_id__. Cette étiquette temporaire est remplacée par le nom de l’étiquette d’identification du cluster que vous spécifiez.
    2
    Indiquez le nom de l’étiquette de cluster ID pour les métriques envoyées au stockage d’écriture à distance. Lorsque vous utilisez un nom d’étiquette qui existe déjà pour une métrique, cette valeur est écrasée avec le nom de cette étiquette ID de cluster. Dans le cas du nom de l’étiquette, n’utilisez pas __tmp_openshift_cluster_id__. La dernière étape de relabeling supprime les étiquettes qui utilisent ce nom.
    3
    L’action de relabel d’écriture remplace l’étiquette temporaire par l’étiquette cible pour les mesures 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. La nouvelle configuration est appliquée automatiquement.
Retour au début
Red Hat logoGithubredditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance. Découvrez nos récentes mises à jour.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez le Blog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

Theme

© 2025 Red Hat