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
<a name="metrics-pipeline-processors"></a>

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 :


| Chemin | Scope | Exemple | 
| --- | --- | --- | 
| `resource.attributes["key"]` | Resource-level | `resource.attributes["service.name"]` | 
| `instrumentation_scope.attributes["key"]` | Attribut Scope | `instrumentation_scope.attributes["library"]` | 
| `datapoint.attributes["key"]` | Datapoint-level | `datapoint.attributes["status_code"]` | 
| `attributes["key"]` | Forme abrégée de point de données | `attributes["environment"]` | 

## processeur add\_attributes
<a name="add-attributes-processor"></a>

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
```Parameters

`attributes` (obligatoire)  
Tableau d'objets attributaires à ajouter.

`attributes[].key` (obligatoire)  
Chemin d'attribut OTTL indiquant où ajouter l'attribut.

`attributes[].value` (obligatoire)  
Valeur de chaîne à attribuer.

`attributes[].overwrite_if_key_exists` (facultatif)  
Booléen. Quand`true`, remplace les valeurs existantes. La valeur par défaut est `false` . Lorsqu'elle est définie sur`true`, cette opération est considérée comme destructrice et ne s'applique pas aux métriques cumulées ni aux métriques distribuées.

## processeur delete\_attributes
<a name="delete-attributes-processor"></a>

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"]
```Parameters

`with_keys` (obligatoire)  
Tableau de chemins d'attributs OTTL à supprimer.

## processeur rename\_attributes
<a name="rename-attributes-processor"></a>

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
```Parameters

`attributes` (obligatoire)  
Tableau des opérations de renommage.

`attributes[].from_key` (obligatoire)  
Chemin de l'attribut OTTL source.

`attributes[].to_key` (obligatoire)  
Chemin d'attribut OTTL cible.

`attributes[].overwrite_if_to_key_exists` (facultatif)  
Booléen. Quand`true`, écrase si la clé cible existe. La valeur par défaut est `false` .

## processeur rename\_metrics
<a name="rename-metrics-processor"></a>

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"
```Parameters

`metrics` (obligatoire)  
Tableau des opérations de renommage.

`metrics[].from` (obligatoire)  
Nom de la métrique actuelle.

`metrics[].to` (obligatoire)  
Nouveau nom de métrique.

## processeur substitute\_attribute\_values
<a name="substitute-attribute-values-processor"></a>

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"
```Parameters

`attributes` (obligatoire)  
Tableau d'opérations de substitution.

`attributes[].key` (obligatoire)  
Chemin d'attribut OTTL auquel faire correspondre.

`attributes[].from` (obligatoire)  
Valeur à égaler.

`attributes[].to` (obligatoire)  
Valeur de remplacement.

## Exemple complet
<a name="metrics-processors-full-example"></a>

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
<a name="metrics-processor-restrictions"></a>

Nombre maximal de processeurs  
Un pipeline de métriques peut comporter au maximum 20 processeurs.

Processeurs destructeurs et temporalité  
Les processeurs destructifs (`delete_attributes``rename_attributes`, `rename_metrics``substitute_attribute_values`, et `add_attributes` avec`overwrite_if_key_exists: true`) ne s'appliquent pas aux métriques cumulées ni aux métriques distribuées. Ces métriques sont transmises sans modification.

Protection des métriques distribuées  
Les processeurs destructeurs ne peuvent pas modifier les métriques où `instrumentation_scope.name` commence par`cloudwatch.aws/`. Ces métriques sont transmises sans modification.