Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Processeurs Metrics Pipeline

Les processeurs du pipeline de métriques transforment les points de données métriques OTel lors de l'ingestion. Un pipeline de métriques peut comporter jusqu'à 20 processeurs, appliqués de manière séquentielle dans l'ordre dans lequel ils ont été définis.

Les processeurs utilisent des expressions de chemin OTTL pour cibler des attributs à différentes étendues :

processeur add_attributes

Ajoute ou remplace des attributs sur des points de données métriques. Fonctionne avec tous les types de temporalité.

Équivalent OTTL : set(attributes["key"], "value")

Configuration

Configurez le processeur add_attributes avec les paramètres suivants :

processor:
  - add_attributes:
      attributes:
        - key: resource.attributes["team"]
          value: "payments"
        - key: attributes["environment"]
          value: "production"
        - key: instrumentation_scope.attributes["version"]
          value: "1.0"
          overwrite_if_key_exists: true

processeur delete_attributes

Supprime des attributs spécifiques des points de données des métriques. Ne s'applique pas aux métriques cumulées ni aux métriques distribuées.

Équivalent OTTL : delete_key(attributes, "key")

Configuration

Configurez le processeur delete_attributes avec les paramètres suivants :

processor:
  - delete_attributes:
      with_keys:
        - resource.attributes["obsolete"]
        - attributes["temp"]
        - datapoint.attributes["debug"]

processeur rename_attributes

Renomme les clés d'attribut sur les points de données métriques. Ne s'applique pas aux métriques cumulées ni aux métriques distribuées.

Équivalent OTTL : set() + delete_key()

Configuration

Configurez le processeur rename_attributes avec les paramètres suivants :

processor:
  - rename_attributes:
      attributes:
        - from_key: resource.attributes["old_key"]
          to_key: resource.attributes["new_key"]
          overwrite_if_to_key_exists: true

processeur rename_metrics

Renomme les noms des métriques. Ne s'applique pas aux métriques cumulées ni aux métriques distribuées.

Équivalent OTTL : set(name, "new.metric.name") where name == "old.metric.name"

Configuration

Configurez le processeur rename_metrics avec les paramètres suivants :

processor:
  - rename_metrics:
      metrics:
        - from: "old.metric.name"
          to: "new.metric.name"

processeur substitute_attribute_values

Mappe les valeurs des attributs à l'aide d'une table de recherche. Ne s'applique pas aux métriques cumulées ni aux métriques distribuées.

Équivalent OTTL : replace_match()

Configuration

Configurez le processeur substitute_attribute_values avec les paramètres suivants :

processor:
  - substitute_attribute_values:
      attributes:
        - key: resource.attributes["region"]
          from: "us-east-1a"
          to: "us-east-1"

Exemple complet

L'exemple suivant utilise les cinq processeurs dans un seul pipeline :

pipeline:
  source:
    cloudwatch_metrics:
      format: otlp
      selection_criteria:
        - match_all:
            - 'resource.attributes["service.name"] == "my-service"'
            - 'metric.name == "CPUUtilization"'
  processor:
    - add_attributes:
        attributes:
          - key: resource.attributes["env"]
            value: "prod"
            overwrite_if_key_exists: true
    - delete_attributes:
        with_keys:
          - resource.attributes["internal.trace"]
    - rename_attributes:
        attributes:
          - from_key: resource.attributes["old_key"]
            to_key: resource.attributes["new_key"]
    - rename_metrics:
        metrics:
          - from: "CPUUtilization"
            to: "system.cpu.utilization"
    - substitute_attribute_values:
        attributes:
          - key: resource.attributes["environment"]
            from: "dev"
            to: "development"
  sink:
    - cloudwatch_metrics: {}

Compatibilité et restrictions des processeurs