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

# Implementazione della AWS distribuzione per raccogliere parametri OpenTelemetry a livello di istanza EC2 sui cluster Amazon ECS
<a name="deploy-container-insights-ECS-OTEL"></a>

Utilizza i passaggi di questa sezione per utilizzare AWS Distro per raccogliere parametri OpenTelemetry a livello di istanza EC2 su un cluster Amazon ECS. [Per ulteriori informazioni su Distro for, consulta Distro for. AWS OpenTelemetry AWS OpenTelemetry](https://aws.amazon.com/otel/)

In queste fasi si presuppone che tu disponga già di un cluster su Amazon ECS. Questo cluster deve essere implementato con il tipo di avvio EC2. Per ulteriori informazioni sull'utilizzo di AWS Distro for Open Telemetry con Amazon ECS e sulla configurazione di un cluster Amazon ECS per questo scopo, [consulta Configurazione di AWS Distro for OpenTelemetry Collector nei parametri a livello di istanza di Amazon Elastic Container Service for](https://aws-otel.github.io/docs/setup/ecs#3-setup-the-aws-otel-collector-for-ecs-ec2-instance-metrics) ECS EC2. 

**Topics**
+ [Configurazione rapida utilizzando CloudFormation](#container-insights-ECS-OTEL-quicksetup)
+ [Configurazione manuale e personalizzata](#container-insights-ECS-OTEL-custom)

## Configurazione rapida utilizzando CloudFormation
<a name="container-insights-ECS-OTEL-quicksetup"></a>

Scarica il file CloudFormation modello per l'installazione di AWS Distro for OpenTelemetry collector for Amazon ECS su EC2. Esegui il seguente comando curl.

```
curl -O https://raw.githubusercontent.com/aws-observability/aws-otel-collector/main/deployment-template/ecs/aws-otel-ec2-instance-metrics-daemon-deployment-cfn.yaml
```

Dopo aver scaricato il file modello, aprilo e sostituiscilo *PATH\$1TO\$1CloudFormation\$1TEMPLATE* con il percorso in cui hai salvato il file modello. Quindi esportate i seguenti parametri ed eseguite il CloudFormation comando, come illustrato nel comando seguente.
+ **Cluster\$1Name**: il nome del cluster Amazon ECS
+ **AWS\$1RRegione**: la regione in cui verranno inviati i dati
+ **PATH\$1TO\$1 CloudFormation \$1TEMPLATE** — Il percorso in cui è stato salvato il file modello. CloudFormation 
+ **comando**: per consentire a AWS Distro for OpenTelemetry collector di raccogliere i parametri a livello di istanza per Amazon ECS su Amazon EC2, devi specificare questo parametro. `--config=/etc/ecs/otel-instance-metrics-config.yaml`

```
ClusterName=Cluster_Name
Region=AWS_Region
command=--config=/etc/ecs/otel-instance-metrics-config.yaml
aws cloudformation create-stack --stack-name AOCECS-${ClusterName}-${Region} \
--template-body file://PATH_TO_CloudFormation_TEMPLATE \
--parameters ParameterKey=ClusterName,ParameterValue=${ClusterName} \
ParameterKey=CreateIAMRoles,ParameterValue=True \
ParameterKey=command,ParameterValue=${command} \
--capabilities CAPABILITY_NAMED_IAM \
--region ${Region}
```

Dopo aver eseguito questo comando, utilizza la console Amazon ECS per verificare se l'attività è in esecuzione.

### Risoluzione dei problemi relativi alla configurazione rapida
<a name="container-insights-ECS-OTEL-quicksetup-troubleshooting"></a>

Per verificare lo stato dello stack, inserisci il seguente comando. CloudFormation 

```
ClusterName=cluster-name
Region=cluster-region
aws cloudformation describe-stack --stack-name AOCECS-$ClusterName-$Region --region $Region
```

Se il valore di `StackStatus` è diverso da `CREATE_COMPLETE` o `CREATE_IN_PROGRESS`, controlla gli eventi di stack per trovare l'errore. Inserire il seguente comando.

```
ClusterName=cluster-name
Region=cluster-region
aws cloudformation describe-stack-events --stack-name AOCECS-$ClusterName-$Region --region $Region
```

Per verificare lo stato del servizio daemon `AOCECS`, immetti il seguente comando. Nell'output, deve essere mostrato che `runningCount` è uguale a `desiredCount` nella sezione di implementazione. In caso contrario, controlla la sezione degli errori nell'output.

```
ClusterName=cluster-name
Region=cluster-region
aws ecs describe-services --services AOCECS-daemon-service --cluster $ClusterName --region $Region
```

Puoi anche utilizzare la console CloudWatch Logs per controllare il registro dell'agente. Cerca il gruppo**/aws/ecs/containerinsights/\$1ClusterName\$1/performance**log.

## Configurazione manuale e personalizzata
<a name="container-insights-ECS-OTEL-custom"></a>

Segui i passaggi in questa sezione per distribuire manualmente la AWS Distro e raccogliere parametri OpenTelemetry a livello di istanza dai cluster Amazon ECS ospitati su istanze Amazon EC2.

### Fase 1: ruoli e policy necessari
<a name="container-insights-ECS-OTEL-custom-iam"></a>

Sono richiesti due ruoli IAM. Se non esistono già è necessario crearli. Per ulteriori informazioni su questi ruoli, consulta [Creazione della policy IAM](https://aws-otel.github.io/docs/setup/ecs/create-iam-policy) e [Creazione del ruolo IAM](https://aws-otel.github.io/docs/setup/ecs/create-iam-role).

### Fase 2: creazione di una definizione dell'attività
<a name="container-insights-ECS-OTEL-custom-task"></a>

Crea una definizione di attività e usala per avviare Distro for as a daemon service. AWS OpenTelemetry

Per utilizzare il modello di definizione dell'attività per creare la definizione dell'attività, segui le istruzioni in [Creare una definizione di attività ECS EC2 per un'istanza EC2 con Collector](https://aws-otel.github.io/docs/setup/ecs/task-definition-for-ecs-ec2-instance). AWS OTel

Per utilizzare la console Amazon ECS per creare la definizione dell'attività, segui le istruzioni in [Install AWS OTel Collector creando la definizione delle attività tramite AWS console per i parametri delle istanze Amazon ECS EC2.](https://aws-otel.github.io/docs/setup/ecs/create-task-definition-instance-console)

### Fase 3: avvio del servizio daemon
<a name="container-insights-ECS-OTEL-custom-launch"></a>

Per avviare AWS Distro for OpenTelemetry as a daemon service, segui le istruzioni in Esegui la [tua attività su Amazon Elastic Container Service (Amazon ECS) usando il servizio daemon](https://aws-otel.github.io/docs/setup/ecs/run-daemon-service).

### (Facoltativo) Configurazione avanzata
<a name="container-insights-ECS-OTEL-custom-advancdeconfig"></a>

Facoltativamente, puoi utilizzare SSM per specificare altre opzioni di configurazione per la AWS Distro per i OpenTelemetry tuoi cluster Amazon ECS ospitati su istanze Amazon EC2. [Per ulteriori informazioni sulla creazione di un file di configurazione, consulta Configurazione personalizzata. OpenTelemetry ](https://aws-otel.github.io/docs/setup/ecs#5-custom-opentelemetry-configuration) Per ulteriori informazioni sulle opzioni che è possibile utilizzare nel file di configurazione, consulta [AWS Container Insights Receiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/awscontainerinsightreceiver/README.md).