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à.

# Crea un trasformatore di log-group-level log partendo da zero
<a name="CloudWatch-Logs-Transformation-CreateNew"></a>

Usa questi passaggi per creare un log-group-level trasformatore da zero.

**Per utilizzare la console per creare un trasformatore di log per un gruppo di log**

1. Apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Nel pannello di navigazione a sinistra, scegli **Log**, **Gruppi di log**.

1. Scegli il gruppo di log per cui vuoi creare il trasformatore.

1. Scegli la scheda **Transformer**. Potrebbe essere necessario scorrere l'elenco delle schede verso destra per visualizzarlo.

1. Scegli **Crea trasformatore**.

1. Nella casella **Scegli un parser**, seleziona un parser da includere nel tuo trasformatore.

   Se si tratta di un parser preconfigurato per un tipo di AWS registro fornito, non è necessario specificare alcuna configurazione.

   Se si tratta di un parser diverso, è necessario specificarne la configurazione. Per ulteriori informazioni, consulta le informazioni relative al processore in[Processori configurabili di tipo parser](CloudWatch-Logs-Transformation-Configurable.md).

1. Per aggiungere un altro processore, scegli **\+ Aggiungi processore**. Quindi seleziona il processore che desideri nella casella **Scegli processori** e inserisci i parametri di configurazione. 

   Ricordate che i processori operano sugli eventi di registro nell'ordine in cui li aggiungete al trasformatore.

1. (Facoltativo) In qualsiasi momento, potete testare il trasformatore che avete creato finora sulla base di un evento di registro di esempio. Per far ciò, completa le seguenti operazioni:

   1. Nella sezione **Anteprima della trasformazione**, scegliete **Carica registro di esempio** per caricare un evento di registro di esempio dal gruppo di log a cui è destinato questo trasformatore, oppure incollate un evento di registro nella casella di testo.

     Scegliete **Test transformer**. Viene visualizzata la versione trasformata del registro 

1. Quando hai finito di aggiungere processori e sei soddisfatto dei test sui log di esempio, scegli **Salva**.

**Per utilizzarlo AWS CLI per creare un trasformatore di log partendo da zero**
+ Utilizza il comando `aws logs put-transformer`. Quando si utilizza `parseJSON` come primo processore, è necessario analizzare l'intero evento di registro utilizzandolo `@message` come campo sorgente. Dopo l'analisi JSON iniziale, è possibile manipolare campi specifici nei processori successivi. Di seguito è riportato un esempio che crea un trasformatore che include i processori and: `parseJSON` `addKeys`

  ```
   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
  ```