Bereitstellung der AWS Distribution für die Erfassung von Metriken OpenTelemetry auf EC2 Instanzebene auf Amazon-Clustern ECS

Gehen Sie wie in diesem Abschnitt beschrieben vor, um mit AWS Distro for Metriken auf EC2 Instance-Ebene in einem Amazon-Cluster OpenTelemetry zu sammeln. ECS Weitere Informationen zur Distribution für finden Sie unter AWS Distro for OpenTelemetry.AWS OpenTelemetry

Bei diesen Schritten wird davon ausgegangen, dass Sie bereits über einen Cluster verfügen, auf dem Amazon ausgeführt wirdECS. Dieser Cluster muss mit dem EC2 Starttyp bereitgestellt werden. Weitere Informationen zur Verwendung von AWS Distro for Open Telemetry mit Amazon ECS und zur Einrichtung eines ECS Amazon-Clusters für diesen Zweck finden Sie unter Setting up AWS Distro for OpenTelemetry Collector in Amazon Elastic Container Service für Metriken auf ECS EC2 Instance-Ebene.

Schnelle Einrichtung mit AWS CloudFormation

Laden Sie die AWS CloudFormation Vorlagendatei für die Installation von AWS Distro for OpenTelemetry Collector für Amazon ECS auf EC2 herunter. Führen Sie den folgenden Curl-Befehl aus.

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

Nachdem Sie die Vorlagendatei heruntergeladen haben, öffnen Sie sie und ersetzen Sie sie PATH_TO_CloudFormation_TEMPLATE mit dem Pfad, in dem Sie die Vorlagendatei gespeichert haben. Exportieren Sie dann die folgenden Parameter und führen Sie den AWS CloudFormation Befehl aus, wie im folgenden Befehl gezeigt.

• Cluster_Name — Der Amazon-Clustername ECS

• AWS_Region — Die Region, in die die Daten gesendet werden

• PATH_TO_ CloudFormation _ TEMPLATE — Der Pfad, in dem Sie die Vorlagendatei gespeichert haben. AWS CloudFormation

• command — Damit der AWS Distro for OpenTelemetry Collector die Metriken ECS auf Instance-Ebene für Amazon bei Amazon sammeln kannEC2, müssen Sie --config=/etc/ecs/otel-instance-metrics-config.yaml für diesen Parameter Folgendes angeben.

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}

Nachdem Sie diesen Befehl ausgeführt haben, überprüfen Sie in der ECS Amazon-Konsole, ob die Aufgabe ausgeführt wird.

Fehlerbehebung bei der Schnelleinrichtung

Geben Sie den folgenden Befehl ein, um den Status des AWS CloudFormation Stacks zu überprüfen.

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

Wenn der Wert von StackStatus nicht CREATE_COMPLETE oder CREATE_IN_PROGRESS ist, überprüfen Sie die Stack-Ereignisse, um den Fehler zu finden. Geben Sie den folgenden Befehl ein.

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

Um den Status des AOCECS-Daemon-Services zu überprüfen, geben Sie den folgenden Befehl ein. In der Ausgabe sollten Sie sehen, dass die runningCount gleich der desiredCount im Abschnitt Bereitstellung ist. Wenn sie nicht gleich ist, überprüfen Sie den Abschnitt Verletzungen in der Ausgabe.

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

Sie können auch die CloudWatch Logs-Konsole verwenden, um das Agent-Log zu überprüfen. Suchen Sie nach der Protokollgruppe /aws/ecs/containerinsights/ {} /performance. ClusterName

Manuelle und benutzerdefinierte Einrichtung

Folgen Sie den Schritten in diesem Abschnitt, um die AWS Distribution manuell bereitzustellen, um Metriken auf Instance-Ebene aus Ihren ECS Amazon-Clustern OpenTelemetry zu sammeln, die auf Amazon-Instances gehostet werden. EC2

Schritt 1: Erforderliche Rollen und Richtlinien

Zwei IAM-Rollen sind erforderlich. Sie müssen sie erstellen, wenn sie noch nicht vorhanden sind. Weitere Informationen zu diesen Rollen finden Sie unter IAMRichtlinie erstellen und Rolle erstellen. IAM

Schritt 2: Erstellen einer Aufgabendefinition

Erstellen Sie eine Aufgabendefinition und verwenden Sie sie, um die AWS Distribution OpenTelemetry als Daemon-Dienst zu starten.

Um die Aufgabendefinitionsvorlage zum Erstellen der Aufgabendefinition zu verwenden, folgen Sie den Anweisungen unter ECSEC2Aufgabendefinition erstellen, zum EC2 Beispiel mit AWS OTel Collector.

Um die ECS Amazon-Konsole zum Erstellen der Aufgabendefinition zu verwenden, folgen Sie den Anweisungen in Install AWS OTel Collector, indem Sie die Aufgabendefinition über die AWS Konsole für ECS EC2 Amazon-Instance-Metriken erstellen.

Schritt 3: Starten des Daemon-Services

Um die AWS Distribution for OpenTelemetry als Daemon-Service zu starten, folgen Sie den Anweisungen unter Führen Sie Ihre Aufgabe auf dem Amazon Elastic Container Service (AmazonECS) mithilfe des Daemon-Service aus.

(Optional) Erweiterte Konfiguration

Optional können SSM Sie andere Konfigurationsoptionen für die AWS Distribution für OpenTelemetry Ihre ECS Amazon-Cluster angeben, die auf EC2 Amazon-Instances gehostet werden. Weitere Informationen zum Erstellen einer Konfigurationsdatei finden Sie unter Benutzerdefinierte OpenTelemetry Konfiguration. Weitere Informationen zu den Optionen, die Sie in der Konfigurationsdatei verwenden können, finden Sie unter AWS Container Insights Receiver.