Implementazione di AWS Distro per raccogliere parametri OpenTelemetry a livello di EC2 istanza sui cluster Amazon ECS

Segui la procedura descritta in questa sezione per utilizzare AWS Distro per raccogliere parametri OpenTelemetry a EC2 livello di istanza su un cluster Amazon. ECS Per ulteriori informazioni su AWS Distro per OpenTelemetry, vedi AWS Distro per. OpenTelemetry

Questi passaggi presuppongono che tu disponga già di un cluster su cui è in esecuzione AmazonECS. Questo cluster deve essere distribuito con il tipo di EC2 avvio. Per ulteriori informazioni sull'utilizzo AWS Distro for Open Telemetry with ECS Amazon e configurazione di un cluster ECS Amazon per questo scopo, vedi Configurazione AWS Distro for OpenTelemetry Collector in Amazon Elastic Container Service, ECS EC2 ad esempio metriche a livello.

Configurazione rapida utilizzando AWS CloudFormation

Scarica il AWS CloudFormation file modello per l'installazione di AWS Distro per OpenTelemetry collezionisti per 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_TO_CloudFormation_TEMPLATE con il percorso in cui hai salvato il file modello. Quindi esporta i seguenti parametri ed esegui AWS CloudFormation comando, come illustrato nel comando seguente.

• Cluster_Name — Il nome del cluster Amazon ECS

• AWS_RRegione: la regione in cui verranno inviati i dati

• PATH_TO_ CloudFormation _ TEMPLATE — Il percorso in cui hai salvato il AWS CloudFormation file modello.

• comando — Per abilitare il AWS Distro for OpenTelemetry collector Per raccogliere i parametri a livello di istanza per Amazon ECS su EC2 Amazon, 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, usa la ECS console Amazon per vedere se l'attività è in esecuzione.

Risoluzione dei problemi relativi alla configurazione rapida

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

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 usare la console CloudWatch Logs per controllare il registro dell'agente. Cerca il gruppo di log /aws/ecs/containerinsights/ {} /performance. ClusterName

Configurazione manuale e personalizzata

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

Fase 1: ruoli e policy necessari

Sono richiesti due ruoli IAM. Se non esistono già è necessario crearli. Per ulteriori informazioni su questi ruoli, consulta Create policy e Create role. IAM IAM

Fase 2: creazione di una definizione dell'attività

Crea una definizione di attività e usala per avviare il AWS Distro OpenTelemetry come servizio demone.

Per utilizzare il modello di definizione dell'attività per creare la definizione dell'attività, segui le istruzioni in Create ECS EC2 Task Definition, ad esempio con EC2 AWS OTelCollezionista.

Per utilizzare la ECS console Amazon per creare la definizione dell'attività, segui le istruzioni in Installa AWS OTelCollector creando Task Definition tramite AWS console per i parametri delle ECS EC2 istanze Amazon.

Fase 3: avvio del servizio daemon

Per avviare il AWS Distribuzione OpenTelemetry come servizio daemon, segui le istruzioni in Esegui la tua attività su Amazon Elastic Container Service (AmazonECS) usando il servizio daemon.

(Facoltativo) Configurazione avanzata

Facoltativamente, puoi utilizzare per specificare altre opzioni SSM di configurazione per AWS Distribuzione per OpenTelemetry i tuoi ECS cluster Amazon ospitati su istanze AmazonEC2. Per ulteriori informazioni sulla creazione di un file di configurazione, consulta Configurazione personalizzata. OpenTelemetry Per ulteriori informazioni sulle opzioni che è possibile utilizzare nel file di configurazione, vedere AWS Ricevitore Container Insights.