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 de 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 séquentiellement dans l'ordre dans lequel ils sont définis.

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

processeur add_attributes

Ajoute ou remplace des attributs sur les 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 métriques. Ne s'applique pas aux mesures cumulatives ou aux mesures 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 mesures cumulatives ou aux mesures 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 mesures cumulatives ou aux mesures 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 via une table de recherche. Ne s'applique pas aux mesures cumulatives ou aux mesures 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 du processeur