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 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 :


**Étendue des chemins OTTL**  

| 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 du point de données | `attributes["environment"]` | 

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

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

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

`attributes[].key` (obligatoire)  
Chemin d'attribut OTTL spécifiant 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 ou aux métriques distribuées.

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

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

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

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

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

`attributes[].overwrite_if_to_key_exists` (facultatif)  
Booléen. Quand`true`, remplace 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 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"
```Parameters

`metrics` (obligatoire)  
Tableau d'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 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"
```Parameters

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

`attributes[].key` (obligatoire)  
Chemin de l'attribut OTTL à comparer.

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

Nombre maximum 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` with`overwrite_if_key_exists: true`) ne s'appliquent pas aux métriques cumulatives ou aux métriques distribuées. Ces indicateurs sont transmis tels quels.

Protection des métriques Vended  
Les processeurs destructeurs ne peuvent pas modifier les métriques au `instrumentation_scope.name` point de départ`cloudwatch.aws/`. Ces indicateurs sont transmis tels quels.