Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Prozessoren für die Metrikpipeline
<a name="metrics-pipeline-processors"></a>

Prozessoren für die Metrik-Pipeline transformieren OTel-Metrikdatenpunkte während der Erfassung. Eine Metrik-Pipeline kann aus bis zu 20 Prozessoren bestehen, die nacheinander in der Reihenfolge angewendet werden, in der sie definiert sind.

Prozessoren verwenden OTTL-Pfadausdrücke, um auf Attribute mit unterschiedlichen Gültigkeitsbereichen abzuzielen:


| Pfad | Scope | Beispiel | 
| --- | --- | --- | 
| `resource.attributes["key"]` | Resource-level | `resource.attributes["service.name"]` | 
| `instrumentation_scope.attributes["key"]` | Scope-Attribut | `instrumentation_scope.attributes["library"]` | 
| `datapoint.attributes["key"]` | Datapoint-level | `datapoint.attributes["status_code"]` | 
| `attributes["key"]` | Kurzform für Datenpunkt | `attributes["environment"]` | 

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

Fügt Attribute an metrischen Datenpunkten hinzu oder überschreibt sie. Funktioniert mit allen Temporalitätstypen.

**OTTL-Äquivalent: ** `set(attributes["key"], "value")`

**Konfiguration**  
Konfigurieren Sie den add\_attributes-Prozessor mit den folgenden Parametern:

```
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` (Erforderlich)  
Array von Attributobjekten, die hinzugefügt werden sollen.

`attributes[].key` (Erforderlich)  
OTTL-Attributpfad, der angibt, wo das Attribut hinzugefügt werden soll.

`attributes[].value` (Erforderlich)  
Zuzuweisender Zeichenkettenwert.

`attributes[].overwrite_if_key_exists` (optional)  
Boolesch. Wenn`true`, überschreibt vorhandene Werte. Standardeinstellung: `false`. Wenn auf gesetzt`true`, wird dieser Vorgang als destruktiv angesehen und gilt nicht für kumulative Metriken oder verkaufte Metriken.

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

Entfernt bestimmte Attribute aus metrischen Datenpunkten. **Gilt nicht für kumulative Metriken oder verkaufte Metriken. **

**OTTL-Äquivalent: ** `delete_key(attributes, "key")`

**Konfiguration**  
Konfigurieren Sie den Prozessor delete\_attributes mit den folgenden Parametern:

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

`with_keys` (Erforderlich)  
Array von OTTL-Attributpfaden, die entfernt werden sollen.

## Prozessor „rename\_attributes“
<a name="rename-attributes-processor"></a>

Benennt Attributschlüssel für metrische Datenpunkte um. **Gilt nicht für kumulative Metriken oder verkaufte Metriken. **

**OTTL-Äquivalent: ** `set() + delete_key()`

**Konfiguration**  
Konfigurieren Sie den Prozessor rename\_attributes mit den folgenden Parametern:

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

`attributes` (Erforderlich)  
Reihe von Umbenennungsvorgängen.

`attributes[].from_key` (Erforderlich)  
Pfad zum OTTL-Attribut der Quelle.

`attributes[].to_key` (Erforderlich)  
Ziel-OTTL-Attributpfad.

`attributes[].overwrite_if_to_key_exists` (optional)  
Boolesch. Wenn`true`, überschreibt, wenn der Zielschlüssel existiert. Standardeinstellung: `false`.

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

Benennt Metriknamen um. **Gilt nicht für kumulative Metriken oder verkaufte Metriken. **

**OTTL-Äquivalent: ** `set(name, "new.metric.name") where name == "old.metric.name"`

**Konfiguration**  
Konfigurieren Sie den rename\_metrics-Prozessor mit den folgenden Parametern:

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

`metrics` (Erforderlich)  
Reihe von Umbenennungsvorgängen.

`metrics[].from` (Erforderlich)  
Aktueller Metrikname.

`metrics[].to` (Erforderlich)  
Neuer Metrikname.

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

Ordnet Attributwerte mithilfe einer Nachschlagetabelle zu. **Gilt nicht für kumulative Metriken oder verkaufte Metriken. **

**OTTL-Äquivalent: ** `replace_match()`

**Konfiguration**  
Konfigurieren Sie den Prozessor substitute\_attribute\_values mit den folgenden Parametern:

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

`attributes` (Erforderlich)  
Reihe von Substitutionsoperationen.

`attributes[].key` (Erforderlich)  
Pfad des OTTL-Attributs, mit dem verglichen werden soll.

`attributes[].from` (Erforderlich)  
Wert, der abgeglichen werden soll.

`attributes[].to` (Erforderlich)  
Ersatzwert.

## Vollständiges Beispiel
<a name="metrics-processors-full-example"></a>

Im folgenden Beispiel werden alle fünf Prozessoren in einer einzigen Pipeline verwendet:

```
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: {}
```

## Prozessorkompatibilität und Einschränkungen
<a name="metrics-processor-restrictions"></a>

Maximale Anzahl Prozessoren  
Eine Metrik-Pipeline kann aus maximal 20 Prozessoren bestehen.

Destruktive Prozessoren und Temporalität  
Destruktive Prozessoren (`delete_attributes``rename_attributes`, `rename_metrics``substitute_attribute_values`, und `add_attributes` mit`overwrite_if_key_exists: true`) gelten nicht für kumulative Metriken oder veräußerte Metriken. Diese Metriken werden unverändert weitergegeben.

Schutz von Metriken durch Vended  
Destruktive Prozessoren können Metriken nicht ändern, wenn sie mit `instrumentation_scope.name` `cloudwatch.aws/` beginnen. Diese Metriken werden unverändert weitergegeben.