Métriques des libellés

Les étiquettes vous permettent de différencier les caractéristiques d'une métrique. En plus de collecter des métriques, la ressource personnalisée MonitoringTarget vous permet d'étiqueter les métriques pour les fonctionnalités d'observabilité facultatives :

Pour en savoir plus sur le réétiquetage des métriques, consultez https://grafana.com/blog/2022/03/21/how-relabeling-in-prometheus-works/.

Avant de commencer

Pour gérer les ressources personnalisées MonitoringTarget, vous devez disposer des autorisations nécessaires.

Demander des rôles IAM au niveau de l'organisation

Contactez l'administrateur de l'organisation IAM pour demander les rôles suivants :

  • Créateur de PA MonitoringTarget (monitoringtarget-pa-creator) : crée des ressources personnalisées MonitoringTarget.
  • Éditeur PA MonitoringTarget (monitoringtarget-pa-editor) : modifiez les ressources personnalisées MonitoringTarget.
  • Lecteur MonitoringTarget PA (monitoringtarget-pa-viewer~): view) : ressources personnalisées MonitoringTarget.

Demander des rôles IAM au niveau du projet

Contactez l'administrateur de projet IAM pour demander les rôles suivants :

  • Éditeur MonitoringTarget (monitoringtarget-editor) : permet de modifier les ressources personnalisées MonitoringTarget dans l'espace de noms du projet.
  • Lecteur MonitoringTarget (monitoringtarget-viewer) : permet d'afficher les ressources personnalisées MonitoringTarget dans l'espace de noms du projet.

Envoyer des métriques à un autre projet

Les auteurs de conteneurs peuvent coder des métriques spécifiques à envoyer à un autre projet, même à des projets dont ils ne sont pas propriétaires. Pour envoyer une métrique à un projet spécifique, ajoutez l'étiquette _gdch_project à la métrique dans votre code, en définissant sa valeur sur le nom du projet de destination.

Vous pouvez également utiliser la ressource personnalisée MonitoringTarget pour envoyer toutes les données de métriques collectées à un autre projet. Définissez l'étiquette _gdch_project comme étiquette cible dans le champ metricsRelabelings, avec le nouveau nom du projet comme valeur de remplacement.

L'exemple de code suivant montre comment définir l'étiquette cible _gdch_project dans la ressource personnalisée MonitoringTarget pour envoyer des métriques au projet nommé another-project-name :

apiVersion: monitoring.gdc.goog/v1
kind: MonitoringTarget
metadata:
  # Choose the same namespace as the workload pods.
  namespace: PROJECT_NAMESPACE
  name: MONITORING_TARGET_NAME
spec:
  [...]
  podMetricsEndpoints:
    [...]
    metricsRelabelings:
      - action: replace
        targetLabel: _gdch_project
        replacement: another-project-name
      [...]

Remplacez les éléments suivants :

  • PROJECT_NAMESPACE : l'espace de noms de votre projet.
  • MONITORING_TARGET_NAME : nom du fichier de définition MonitoringTarget.

Ajouter des étiquettes aux métriques

Les étiquettes facilitent l'observabilité et la surveillance en identifiant les caractéristiques des métriques. Vous pouvez ajouter des étiquettes que les conteneurs récupérés n'exposent pas initialement. Dans la ressource personnalisée MonitoringTarget, définissez la nouvelle étiquette comme cible et fournissez une valeur de remplacement. Cette paire clé-valeur est ajoutée à toutes les métriques collectées par la ressource.

L'exemple de code suivant montre comment définir l'étiquette cible my_new_label et configurer sa valeur sur my_label_value dans la ressource personnalisée MonitoringTarget :

apiVersion: monitoring.gdc.goog/v1
kind: MonitoringTarget
metadata:
  # Choose the same namespace as the workload pods.
  namespace: PROJECT_NAMESPACE
  name: MONITORING_TARGET_NAME
spec:
  [...]
  podMetricsEndpoints:
    [...]
    metricsRelabelings:
      - action: replace
        targetLabel: my_new_label
        replacement: my_label_value
      [...]

Remplacez les éléments suivants :

  • PROJECT_NAMESPACE : l'espace de noms de votre projet.
  • MONITORING_TARGET_NAME : nom du fichier de définition MonitoringTarget.

Renommer une métrique

Vous pouvez renommer la métrique d'un conteneur à l'aide de la ressource MonitoringTarget. Définissez le nom de la métrique d'origine et son remplacement dans le champ metricsRelabelings. Le nom d'origine est traité comme une expression régulière (regex) et est remplacé par le nouveau nom.

L'exemple de code suivant montre comment remplacer le nom de la métrique cpu_usage (expression régulière) par cpu_usage_new_name dans la ressource personnalisée MonitoringTarget :

apiVersion: monitoring.gdc.goog/v1
kind: MonitoringTarget
metadata:
  # Choose the same namespace as the workload pods.
  namespace: PROJECT_NAMESPACE
  name: MONITORING_TARGET_NAME
spec:
  [...]
  podMetricsEndpoints:
    [...]
    metricsRelabelings:
      - action: replace
        regex: cpu_usage
        replacement: cpu_usage_new_name
        sourceLabels: [__name__]
        targetLabel: __name__
      [...]

Remplacez les éléments suivants :

  • PROJECT_NAMESPACE : l'espace de noms de votre projet.
  • MONITORING_TARGET_NAME : nom du fichier de définition MonitoringTarget.