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 parser di log personalizzato per Amazon ECS utilizzando un router di log Firelens
<a name="create-a-custom-log-parser-for-amazon-ecs-using-a-firelens-log-router"></a>

*Varun Sharma, Amazon Web Services*

## Riepilogo
<a name="create-a-custom-log-parser-for-amazon-ecs-using-a-firelens-log-router-summary"></a>

Firelens è un router di log per Amazon Elastic Container Service (Amazon ECS) e AWS Fargate. [Puoi utilizzare Firelens per instradare i log dei container da Amazon ECS ad CloudWatch Amazon e ad altre destinazioni (ad esempio[,](https://www.splunk.com/) Splunk o Sumo Logic).](https://www.sumologic.com/) Firelens funziona con [Fluentd o Fluent](https://www.fluentd.org/) [Bit](https://fluentbit.io/) come agente di registrazione, il che significa che puoi utilizzare i parametri di definizione delle attività di [Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html) per instradare i log.

Scegliendo di analizzare i log a livello di origine, puoi analizzare i dati di registrazione ed eseguire query per rispondere in modo più efficiente ed efficace ai problemi operativi. Poiché applicazioni diverse hanno modelli di registrazione diversi, è necessario utilizzare un parser personalizzato che struttura i log e faciliti la ricerca nella destinazione finale.

Questo modello utilizza un router di log Firelens con un parser personalizzato a cui inviare i log CloudWatch da un'applicazione Spring Boot di esempio in esecuzione su Amazon ECS. Puoi quindi utilizzare Amazon CloudWatch Logs Insights per filtrare i log in base a campi personalizzati generati dal parser personalizzato. 

## Prerequisiti e limitazioni
<a name="create-a-custom-log-parser-for-amazon-ecs-using-a-firelens-log-router-prereqs"></a>

**Prerequisiti**
+ Un account Amazon Web Services (AWS) attivo.
+ AWS Command Line Interface (AWS CLI), installata e configurata sul computer locale.
+ Docker, installato e configurato sul tuo computer locale.
+ Un'applicazione containerizzata esistente basata su Spring Boot su Amazon Elastic Container Registry (Amazon ECR). 

## Architecture
<a name="create-a-custom-log-parser-for-amazon-ecs-using-a-firelens-log-router-architecture"></a>

![\[Utilizzo di un router di log Firelens per inviare i log CloudWatch da un'applicazione in esecuzione su Amazon ECS.\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/images/pattern-img/e82b4992-c4e0-4af5-b87e-cb0b1c1ed8c9/images/ef60e087-965a-40e9-9f80-35edbda2befe.png)


**Stack tecnologico**
+ CloudWatch
+ Amazon ECR
+ Amazon ECS
+ Fargate
+ Docker
+ Fluent Bit

## Tools (Strumenti)
<a name="create-a-custom-log-parser-for-amazon-ecs-using-a-firelens-log-router-tools"></a>
+ [Amazon ECR](https://docs.aws.amazon.com/AmazonECR/latest/userguide/what-is-ecr.html) — Amazon Elastic Container Registry (Amazon ECR) è un servizio di registro di immagini di container gestito da AWS sicuro, scalabile e affidabile.
+ [Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html) — Amazon Elastic Container Service (Amazon ECS) è un servizio di gestione dei container veloce e altamente scalabile che semplifica l'esecuzione, l'arresto e la gestione dei container su un cluster.
+ [AWS Identity and Access Management (IAM)](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html): IAM è un servizio Web per controllare in modo sicuro l'accesso ai servizi AWS.
+ [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) — AWS Command Line Interface (AWS CLI) è uno strumento open source che consente di interagire con i servizi AWS utilizzando i comandi nella shell della riga di comando.
+ [Docker: Docker](https://www.docker.com/) è una piattaforma aperta per lo sviluppo, la spedizione e l'esecuzione di applicazioni.

**Codice**

I seguenti file sono allegati a questo modello:
+ `customFluentBit.zip`— Contiene i file per aggiungere l'analisi e le configurazioni personalizzate.
+ `firelens_policy.json`— Contiene il documento di policy per creare una policy IAM.
+ `Task.json`— Contiene una definizione di attività di esempio per Amazon ECS.

## Epiche
<a name="create-a-custom-log-parser-for-amazon-ecs-using-a-firelens-log-router-epics"></a>

### Crea un'immagine Fluent Bit personalizzata
<a name="create-a-custom-fluent-bit-image"></a>


| Operazione | Description | Competenze richieste | 
| --- | --- | --- | 
| Crea un repository Amazon ECR. | Accedi alla Console di gestione AWS, apri la console Amazon ECR e crea un repository chiamato. `fluentbit_custom`Per ulteriori informazioni su questo argomento, consulta [Creazione di un repository](https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-create.html) nella documentazione di Amazon ECR. | Amministratore di sistema, sviluppatore | 
| Decomprimi il customFluentBit pacchetto.zip. |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/create-a-custom-log-parser-for-amazon-ecs-using-a-firelens-log-router.html) |  | 
| Crea l'immagine Docker personalizzata. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/create-a-custom-log-parser-for-amazon-ecs-using-a-firelens-log-router.html)Per ulteriori informazioni su questo argomento, consulta [Pushing a Docker image](https://docs.aws.amazon.com/AmazonECR/latest/userguide/docker-push-ecr-image.html) nella documentazione di Amazon ECR.  | Amministratore di sistema, sviluppatore | 

### Configura il cluster Amazon ECS
<a name="set-up-the-amazon-ecs-cluster"></a>


| Operazione | Description | Competenze richieste | 
| --- | --- | --- | 
| Crea un cluster Amazon ECS. | Crea un cluster Amazon ECS seguendo le istruzioni dalla sezione *Modello solo per reti di rete* di [Creazione di un cluster](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create_cluster.html) nella documentazione di Amazon ECS.Assicurati di scegliere **Create VPC per creare** un nuovo cloud privato virtuale (VPC) per il tuo cluster Amazon ECS. | Amministratore di sistema, sviluppatore | 

### Configurare l'attività Amazon ECS
<a name="set-up-the-amazon-ecs-task"></a>


| Operazione | Description | Competenze richieste | 
| --- | --- | --- | 
|  Configura il ruolo IAM di esecuzione delle attività di Amazon ECS. | Crea un ruolo IAM per l'esecuzione delle attività di Amazon ECS utilizzando la policy `AmazonECSTaskExecutionRolePolicy` gestita. Per ulteriori informazioni su questo argomento, consulta il [ruolo IAM di esecuzione delle attività di Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_execution_IAM_role.html) nella documentazione di Amazon ECS.Assicurati di registrare l'Amazon Resource Name (ARN) del ruolo IAM. | Amministratore di sistema, sviluppatore | 
|  Collega la policy IAM al ruolo IAM di esecuzione delle attività di Amazon ECS. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/create-a-custom-log-parser-for-amazon-ecs-using-a-firelens-log-router.html) | Amministratore di sistema, sviluppatore | 
| Imposta la definizione del task di Amazon ECS. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/create-a-custom-log-parser-for-amazon-ecs-using-a-firelens-log-router.html)Per ulteriori informazioni su questo argomento, consulta [Creazione di una definizione di attività](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-task-definition.html) nella documentazione di Amazon ECS. | Amministratore di sistema, sviluppatore | 

### Esegui l'attività Amazon ECS
<a name="run-the-amazon-ecs-task"></a>


| Operazione | Description | Competenze richieste | 
| --- | --- | --- | 
| Esegui l'attività Amazon ECS.  | Sulla console Amazon ECS, scegli **Clusters**, scegli il cluster che hai creato in precedenza, quindi esegui l'attività autonoma.Per ulteriori informazioni su questo argomento, consulta [Esegui un'attività autonoma](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_run_task.html) nella documentazione di Amazon ECS. | Amministratore di sistema, sviluppatore | 

### Verifica i CloudWatch registri
<a name="verify-the-cloudwatch-logs"></a>


| Operazione | Description | Competenze richieste | 
| --- | --- | --- | 
| Verifica i registri.  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/create-a-custom-log-parser-for-amazon-ecs-using-a-firelens-log-router.html) | Amministratore di sistema, sviluppatore | 

## Risorse correlate
<a name="create-a-custom-log-parser-for-amazon-ecs-using-a-firelens-log-router-resources"></a>
+ [Nozioni di base su Docker per Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/docker-basics.html) 
+ [Amazon ECS su AWS Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/AWS_Fargate.html) 
+ [Configurazione dei parametri di base del servizio](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/basic-service-params.html) 

## Allegati
<a name="attachments-e82b4992-c4e0-4af5-b87e-cb0b1c1ed8c9"></a>

[Per accedere al contenuto aggiuntivo associato a questo documento, decomprimi il seguente file: attachment.zip](samples/p-attach/e82b4992-c4e0-4af5-b87e-cb0b1c1ed8c9/attachments/attachment.zip)