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.
# Transformationsprozessoren
Transformationsprozessoren ändern die Struktur von Protokollereignissen, indem sie Felder hinzufügen, kopieren, verschieben oder entfernen.
## Prozessor add\$1entries
Fügt statische Schlüssel-Wert-Paare zu Protokollereignissen hinzu. Einer Pipeline kann höchstens ein `add_entries` Prozessor hinzugefügt werden.
**Konfiguration**
Konfigurieren Sie den Prozessor add\$1entries mit den folgenden Parametern:
```
processor:
- add_entries:
entries:
- key: "environment"
value: "production"
overwrite_if_key_exists: false
```Parameters
`entries` (Erforderlich)
Array von Schlüssel-Wert-Paaren, die zu jedem Protokollereignis hinzugefügt werden sollen.
`entries[].key` (Erforderlich)
Der Feldname, der dem Protokollereignis hinzugefügt werden soll. Unterstützt verschachtelte Felder mit Punktnotation.
`entries[].value` (Erforderlich)
Der statische Wert, der dem Schlüssel zugewiesen werden soll.
`entries[].overwrite_if_key_exists` (optional)
Boolesches Flag, das das Verhalten bestimmt, wenn der Schlüssel bereits vorhanden ist. Standardwert "false".
`when` (optional)
Bedingter Ausdruck auf Prozessorebene. Wenn angegeben, wird der gesamte Prozessor übersprungen, wenn der Ausdruck als falsch ausgewertet wird. Die maximale Länge beträgt 256 Zeichen. Siehe [Ausdruckssyntax für bedingte Verarbeitung](conditional-processing.md).
`entries[].when` (optional)
Bedingter Ausdruck auf Einstiegsebene. Wenn angegeben, wird nur dieser Eintrag übersprungen, wenn der Ausdruck als falsch ausgewertet wird. Die maximale Länge beträgt 256 Zeichen. Siehe [Ausdruckssyntax für bedingte Verarbeitung](conditional-processing.md).
`entries[].when_else` (optional)
Ausweicheintrag, der nur ausgeführt wird, wenn keine der anderen `when` Bedingungen desselben Prozessors zutrifft. Der Ausdruckswert gibt an, welche `when` Bedingungen berücksichtigt werden sollen. Die maximale Länge beträgt 256 Zeichen. Siehe [Ausdruckssyntax für bedingte Verarbeitung](conditional-processing.md).
## Prozessor „copy\$1values“
Kopiert Werte von einem Feld in ein anderes. Einer Pipeline kann höchstens ein `copy_values` Prozessor hinzugefügt werden.
**Konfiguration**
Konfigurieren Sie den Prozessor copy\$1values mit den folgenden Parametern:
```
processor:
- copy_values:
entries:
- from_key: "user_id"
to_key: "backup_user"
overwrite_if_to_key_exists: false
```Parameters
`entries` (Erforderlich)
Array von Kopiervorgängen, die für jedes Protokollereignis ausgeführt werden sollen.
`entries[].from_key` (Erforderlich)
Der Feldname, aus dem der Wert kopiert werden soll. Verwendet die Punktnotation für verschachtelte Felder.
`entries[].to_key` (Erforderlich)
Der Feldname, in den der Wert kopiert werden soll. Erzeugt verschachtelte Strukturen, wenn die Punktnotation verwendet wird.
`entries[].overwrite_if_to_key_exists` (optional)
Boolesche Markierung, die das Verhalten steuert, wenn das Zielfeld bereits existiert. Standardwert "false".
`when` (optional)
Bedingter Ausdruck auf Prozessorebene. Wenn angegeben, wird der gesamte Prozessor übersprungen, wenn der Ausdruck als falsch ausgewertet wird. Die maximale Länge beträgt 256 Zeichen. Siehe [Ausdruckssyntax für bedingte Verarbeitung](conditional-processing.md).
`entries[].when` (optional)
Bedingter Ausdruck auf Einstiegsebene. Wenn angegeben, wird nur dieser Eintrag übersprungen, wenn der Ausdruck als falsch ausgewertet wird. Die maximale Länge beträgt 256 Zeichen. Siehe [Ausdruckssyntax für bedingte Verarbeitung](conditional-processing.md).
`entries[].when_else` (optional)
Ausweicheintrag, der nur ausgeführt wird, wenn keine der anderen `when` Bedingungen desselben Prozessors zutrifft. Der Ausdruckswert gibt an, welche `when` Bedingungen berücksichtigt werden sollen. Die maximale Länge beträgt 256 Zeichen. Siehe [Ausdruckssyntax für bedingte Verarbeitung](conditional-processing.md).
## Prozessor „delete\$1entries“
Entfernt die angegebenen Felder aus den Protokollereignissen.
**Konfiguration**
Konfigurieren Sie den Prozessor delete\$1entries mit den folgenden Parametern:
```
processor:
- delete_entries:
with_keys: ["temp_field", "debug_info"]
```Parameters
`with_keys` (Erforderlich)
Array von Feldnamen, die aus jedem Protokollereignis entfernt werden sollen. Unterstützt das Löschen verschachtelter Felder mithilfe der Punktnotation.
`when` (optional)
Bedingter Ausdruck, der bestimmt, ob dieser Prozessor ausgeführt wird. Die maximale Länge beträgt 256 Zeichen. Siehe [Ausdruckssyntax für bedingte Verarbeitung](conditional-processing.md).
## move\$1keys-Prozessor
Verschiebt Felder von einem Ort an einen anderen.
**Konfiguration**
Konfigurieren Sie den move\$1keys-Prozessor mit den folgenden Parametern:
```
processor:
- move_keys:
entries:
- from_key: "old_field"
to_key: "new_field"
overwrite_if_to_key_exists: true
```Parameters
`entries` (Erforderlich)
Reihe von Verschiebeoperationen. Maximal 5 Einträge.
`entries[].from_key` (Erforderlich)
Name des Quellfeldes. Maximal 128 Zeichen.
`entries[].to_key` (Erforderlich)
Name des Zielfeldes. Maximal 128 Zeichen.
`entries[].overwrite_if_to_key_exists` (optional)
Ob ein vorhandenes Zielfeld überschrieben werden soll.
`when` (optional)
Bedingter Ausdruck auf Prozessorebene. Wenn angegeben, wird der gesamte Prozessor übersprungen, wenn der Ausdruck als falsch ausgewertet wird. Die maximale Länge beträgt 256 Zeichen. Siehe [Ausdruckssyntax für bedingte Verarbeitung](conditional-processing.md).
`entries[].when` (optional)
Bedingter Ausdruck auf Einstiegsebene. Wenn angegeben, wird nur dieser Eintrag übersprungen, wenn der Ausdruck als falsch ausgewertet wird. Die maximale Länge beträgt 256 Zeichen. Siehe [Ausdruckssyntax für bedingte Verarbeitung](conditional-processing.md).
`entries[].when_else` (optional)
Ausweicheintrag, der nur ausgeführt wird, wenn keine der anderen `when` Bedingungen desselben Prozessors zutrifft. Der Ausdruckswert gibt an, welche `when` Bedingungen berücksichtigt werden sollen. Die maximale Länge beträgt 256 Zeichen. Siehe [Ausdruckssyntax für bedingte Verarbeitung](conditional-processing.md).
## Prozessor reduzieren
Macht verschachtelte Objektstrukturen flach.
**Konfiguration**
Konfigurieren Sie den Flatten-Prozessor mit den folgenden Parametern:
```
processor:
- flatten:
source: "metadata"
target: "flattened"
remove_processed_fields: true
exclude_keys: ["sensitive_data"]
```Parameters
`source` (Erforderlich)
Feld, das das verschachtelte Objekt enthält, das reduziert werden soll.
`target` (Erforderlich)
Zielfeldpräfix für abgeflachte Schlüssel.
`remove_processed_fields` (optional)
Ob das ursprüngliche verschachtelte Feld nach dem Reduzieren entfernt werden soll.
`exclude_keys` (optional)
Reihe von Schlüsseln, die von der Reduzierung ausgeschlossen werden sollen. Maximal 20 Schlüssel mit jeweils bis zu 128 Zeichen.
`when` (optional)
Bedingter Ausdruck, der bestimmt, ob dieser Prozessor ausgeführt wird. Die maximale Länge beträgt 256 Zeichen. Siehe [Ausdruckssyntax für bedingte Verarbeitung](conditional-processing.md).