Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Processori di pipeline Metrics
<a name="metrics-pipeline-processors"></a>

I processori di pipeline Metrics trasformano i punti dati delle metriche Otel durante l'inserimento. Una pipeline di metriche può avere fino a 20 processori, applicati in sequenza nell'ordine in cui sono definiti.

I processori utilizzano espressioni di percorso OTTL per indirizzare gli attributi a diversi ambiti:


| Path | Scope | Esempio | 
| --- | --- | --- | 
| `resource.attributes["key"]` | Resource-level | `resource.attributes["service.name"]` | 
| `instrumentation_scope.attributes["key"]` | Attributo scope | `instrumentation_scope.attributes["library"]` | 
| `datapoint.attributes["key"]` | Datapoint-level | `datapoint.attributes["status_code"]` | 
| `attributes["key"]` | Forma abbreviata di datapoint | `attributes["environment"]` | 

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

Aggiunge o sovrascrive gli attributi sui punti dati delle metriche. Funziona con tutti i tipi di temporalità.

**Equivalente a OTTL: ** `set(attributes["key"], "value")`

**Configurazione**  
Configura il processore add\_attributes con i seguenti parametri:

```
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`(obbligatorio)  
Matrice di oggetti attributo da aggiungere.

`attributes[].key`(obbligatorio)  
Percorso dell'attributo OTTL che specifica dove aggiungere l'attributo.

`attributes[].value`(obbligatorio)  
Valore stringa da assegnare.

`attributes[].overwrite_if_key_exists` (facoltativo)  
booleano. Quando`true`, sovrascrive i valori esistenti. L’impostazione predefinita è `false`. Se impostata su`true`, questa operazione è considerata distruttiva e non si applica alle metriche cumulative o alle metriche vendute.

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

Rimuove attributi specifici dai punti dati delle metriche. **Non si applica alle metriche cumulative o alle metriche vendute. **

**Equivalente a OTTL: ** `delete_key(attributes, "key")`

**Configurazione**  
Configura il processore delete\_attributes con i seguenti parametri:

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

`with_keys`(obbligatorio)  
Matrice di percorsi di attributi OTTL da rimuovere.

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

Rinomina le chiavi degli attributi sui punti dati metrici. **Non si applica alle metriche cumulative o alle metriche vendute. **

**Equivalente a OTTL: ** `set() + delete_key()`

**Configurazione**  
Configura il processore rename\_attributes con i seguenti parametri:

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

`attributes`(obbligatorio)  
Matrice di operazioni di ridenominazione.

`attributes[].from_key`(obbligatorio)  
Percorso dell'attributo OTTL di origine.

`attributes[].to_key`(obbligatorio)  
Percorso dell'attributo OTTL di destinazione.

`attributes[].overwrite_if_to_key_exists` (facoltativo)  
booleano. Quando`true`, sovrascrive se esiste la chiave di destinazione. L’impostazione predefinita è `false`.

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

Rinomina i nomi delle metriche. **Non si applica alle metriche cumulative o alle metriche vendute. **

**Equivalente a OTTL: ** `set(name, "new.metric.name") where name == "old.metric.name"`

**Configurazione**  
Configura il processore rename\_metrics con i seguenti parametri:

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

`metrics`(obbligatorio)  
Matrice di operazioni di ridenominazione.

`metrics[].from`(obbligatorio)  
Nome della metrica corrente.

`metrics[].to`(obbligatorio)  
Nuovo nome della metrica.

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

Mappa i valori degli attributi utilizzando una tabella di ricerca. **Non si applica alle metriche cumulative o alle metriche vendute. **

**Equivalente a OTTL: ** `replace_match()`

**Configurazione**  
Configura il processore substitute\_attribute\_values con i seguenti parametri:

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

`attributes`(obbligatorio)  
Serie di operazioni di sostituzione.

`attributes[].key`(obbligatorio)  
Percorso dell'attributo OTTL con cui confrontare.

`attributes[].from`(obbligatorio)  
Valore da abbinare.

`attributes[].to`(obbligatorio)  
Valore sostitutivo.

## Esempio completo
<a name="metrics-processors-full-example"></a>

L'esempio seguente utilizza tutti e cinque i processori in un'unica 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à e restrizioni dei processori
<a name="metrics-processor-restrictions"></a>

Numero massimo di processori  
Una pipeline di metriche può avere al massimo 20 processori.

Processori distruttivi e temporalità  
I processori distruttivi (`delete_attributes`,, `rename_attributes` `rename_metrics``substitute_attribute_values`, e `add_attributes` con`overwrite_if_key_exists: true`) non si applicano alle metriche cumulative o alle metriche vendute. Queste metriche vengono trasmesse invariate.

Protezione delle metriche vendute  
I processori distruttivi non possono modificare le metriche sin dall'inizio. `instrumentation_scope.name` `cloudwatch.aws/` Queste metriche vengono trasmesse invariate.