View a markdown version of this page

Implementazione di AWS Distro per raccogliere metriche OpenTelemetry a livello di istanza EC2 sui cluster Amazon ECS - Amazon CloudWatch

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 di AWS Distro per raccogliere metriche OpenTelemetry a livello di istanza EC2 sui cluster Amazon ECS

Segui i passaggi descritti in questa sezione per utilizzare AWS Distro for OpenTelemetry per raccogliere metriche a livello di istanza EC2 su un cluster Amazon ECS. Per ulteriori informazioni su Distro for, consulta Distro for. AWS OpenTelemetry AWS OpenTelemetry

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 a tale scopo, consulta Configurazione di AWS Distro for OpenTelemetry Collector in Amazon Elastic Container Service per le metriche a livello di istanza ECS EC2.

Configurazione rapida utilizzando CloudFormation

Scarica il file CloudFormation modello per installare AWS Distro for OpenTelemetry collector 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 il CloudFormation comando, come mostrato nel comando seguente.

  • Cluster_Name— Il nome del cluster Amazon ECS

  • AWS_Region: la regione in cui verranno inviati i dati

  • PATH_TO_ CloudFormation _TEMPLATE: il percorso in cui hai salvato il file modello. CloudFormation

  • comando — Per consentire a AWS Distro for OpenTelemetry collector di raccogliere le metriche 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

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

È inoltre possibile utilizzare la console CloudWatch Logs per controllare il registro dell'agente. Cerca il gruppo/aws/ecs/containerinsights/ {} /performance log. ClusterName

Configurazione manuale e personalizzata

Segui i passaggi descritti in questa sezione per distribuire manualmente AWS Distro e raccogliere metriche a livello di istanza dai tuoi OpenTelemetry cluster Amazon ECS ospitati 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 Creazione della policy IAM e Creazione del ruolo IAM.

Fase 2: creazione di una definizione dell'attività

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 Crea definizione di attività ECS EC2 per un'istanza EC2 con Otel Collector. AWS

Per utilizzare la console Amazon ECS per creare la definizione dell'attività, segui le istruzioni in Installa AWS OTel Collector creando la definizione dell'attività tramite la AWS console per le metriche delle istanze Amazon ECS EC2.

Fase 3: avvio del servizio daemon

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) utilizzando il servizio daemon.

(Facoltativo) Configurazione avanzata

Facoltativamente, puoi utilizzare SSM per specificare altre opzioni di configurazione per AWS Distro for OpenTelemetry nei tuoi cluster Amazon ECS ospitati su istanze Amazon EC2. 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, consulta AWS Container Insights Receiver.