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.

# Erstellen Sie einen log-group-level Log-Transformer von Grund auf
<a name="CloudWatch-Logs-Transformation-CreateNew"></a>

Gehen Sie wie folgt vor, um einen log-group-level Transformator von Grund auf neu zu erstellen.

**So verwenden Sie die Konsole, um einen Protokolltransformator für eine Protokollgruppe zu erstellen**

1. Öffnen Sie die CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Wählen Sie im Navigationsbereich **Logs (Protokolle)**, **Log groups (Protokollgruppen)** aus.

1. Wählen Sie die Protokollgruppe aus, für die Sie den Transformer erstellen möchten.

1. Wählen Sie die Registerkarte **Transformer**. Möglicherweise müssen Sie in der Tab-Liste nach rechts scrollen, um sie zu sehen.

1. Wählen Sie **Create Transformer**.

1. **Wählen Sie im Feld Wählen Sie einen Parser** aus, der in Ihren Transformer aufgenommen werden soll.

   Wenn es sich um einen vorkonfigurierten Parser für einen Typ von AWS verkauftem Protokoll handelt, müssen Sie dafür keine Konfiguration angeben.

   Wenn es sich um einen anderen Parser handelt, müssen Sie dessen Konfiguration angeben. Weitere Informationen finden Sie in den Informationen zu diesem Prozessor unter[Konfigurierbare Prozessoren vom Typ Parser](CloudWatch-Logs-Transformation-Configurable.md).

1. Um einen weiteren Prozessor hinzuzufügen, wählen Sie **\+ Prozessor hinzufügen**. Wählen Sie dann im Feld **Prozessoren auswählen** den gewünschten Prozessor aus und geben Sie die Konfigurationsparameter ein. 

   Denken Sie daran, dass Prozessoren die Protokollereignisse in der Reihenfolge verarbeiten, in der Sie sie dem Transformator hinzufügen.

1. (Optional) Sie können den Transformator, den Sie bisher erstellt haben, jederzeit anhand eines Beispielprotokollereignisses testen. Gehen Sie dazu wie folgt vor:

   1. Wählen Sie im Abschnitt **Transformationsvorschau** entweder **Beispielprotokoll laden** aus, um ein Beispielprotokollereignis aus der Protokollgruppe zu laden, für die dieser Transformator bestimmt ist, oder fügen Sie ein Protokollereignis in das Textfeld ein.

     Wählen Sie **Transformator testen** aus. Die transformierte Version des Protokolls wird angezeigt 

1. Wenn Sie mit dem Hinzufügen von Prozessoren fertig sind und mit den Tests der Beispielprotokolle zufrieden sind, wählen Sie **Speichern**.

**Um den zu verwenden AWS CLI , um einen Log-Transformator von Grund auf neu zu erstellen**
+ Verwenden Sie den Befehl `aws logs put-transformer`. Wenn Sie `parseJSON` es als ersten Prozessor verwenden, müssen Sie das gesamte Protokollereignis `@message` als Quellfeld analysieren. Nach der ersten JSON-Analyse können Sie dann bestimmte Felder in nachfolgenden Prozessoren bearbeiten. Im Folgenden finden Sie ein Beispiel, das einen Transformator erstellt, der die `addKeys` Prozessoren `parseJSON` und enthält:

  ```
   aws logs put-transformer \
    --transformer-config '[{"parseJSON":{"source":"@message"}},{"addKeys":{"entries":[{"key":"metadata.transformed_in","value":"CloudWatchLogs"},{"key":"feature","value":"Transformation"}]}},{"trimString":{"withKeys":["status"]}}]' \
    --log-group-identifier my-log-group-name
  ```