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.

# Metrics Pipeline-Prozessoren
<a name="metrics-pipeline-processors"></a>

Prozessoren für die Metrik-Pipeline transformieren metrische Otel-Datenpunkte während der Aufnahme. Eine Metrik-Pipeline kann bis zu 20 Prozessoren haben, die nacheinander in der Reihenfolge angewendet werden, in der sie definiert sind.

Prozessoren verwenden OTTL-Pfadausdrücke, um auf Attribute in unterschiedlichen Bereichen abzuzielen:


**Bereiche des OTTL-Pfads**  

| 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 Prozessor add\_attributes 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. Wann`true`, überschreibt bestehende Werte. Standardeinstellung: `false`. Wenn diese Option auf gesetzt ist`true`, wird dieser Vorgang als destruktiv betrachtet und gilt nicht für kumulative oder verkaufte Metriken.

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

Entfernt bestimmte Attribute aus metrischen Datenpunkten. **Gilt nicht für kumulative 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 zu entfernenden OTTL-Attributpfaden.

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

Benennt Attributschlüssel an metrischen Datenpunkten um. **Gilt nicht für kumulative 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 des Quell-OTTL-Attributs.

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

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

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

Benennt die Namen der Metriken um. **Gilt nicht für kumulative 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 über eine Nachschlagetabelle zu. **Gilt nicht für kumulative 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)  
OTTL-Attributpfad, mit dem abgeglichen werden soll.

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

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

## 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 an Prozessoren  
Eine Metrik-Pipeline kann maximal 20 Prozessoren haben.

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 Kennzahlen oder vergebene Metriken. Diese Metriken werden unverändert weitergegeben.

Schutz für vergebene Messwerte  
Destruktive Prozessoren können Metriken nicht dort ändern, wo sie mit `instrumentation_scope.name` `cloudwatch.aws/` beginnen. Diese Metriken werden unverändert weitergegeben.