Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

Gehen Sie wie in diesem Abschnitt beschrieben vor, um mit AWS Distro for EC2-Metriken auf Instanzebene auf einem Amazon ECS-Cluster OpenTelemetry zu sammeln. 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 ECS ausgeführt wird. 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 Amazon ECS-Clusters für diesen Zweck finden Sie unter Setting up AWS Distro for OpenTelemetry Collector in Amazon Elastic Container Service for EC2-Instance-Level-Metriken.

Schnelle Einrichtung mit CloudFormation

Laden Sie die 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 PATH_TO_CloudFormation_TEMPLATE ersetzen Sie sie durch den Pfad, in dem Sie die Vorlagendatei gespeichert haben. Exportieren Sie dann die folgenden Parameter und führen Sie den CloudFormation Befehl aus, wie im folgenden Befehl gezeigt.

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, verwenden Sie die Amazon-ECS-Konsole, um festzustellen, ob die Aufgabe ausgeführt wird.

Fehlerbehebung bei der Schnelleinrichtung

Geben Sie den folgenden Befehl ein, um den Status des 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 aws/ecs/containerinsights/{ClusterName}/performance Protokollgruppe/.

Manuelle und benutzerdefinierte Einrichtung

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

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 IAM-Richtlinie erstellen und IAM-Rolle erstellen.

Schritt 2: Erstellen einer Aufgabendefinition

Erstellen Sie eine Aufgabendefinition und verwenden Sie sie, um AWS Distro for OpenTelemetry als Daemon-Service zu starten.

Um die Aufgabendefinitionsvorlage zum Erstellen der Aufgabendefinition zu verwenden, folgen Sie den Anweisungen unter ECS EC2-Aufgabendefinition für EC2-Instance mit Collector erstellen. AWS OTel

Um die Amazon ECS-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 Amazon ECS EC2-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 (Amazon ECS) mithilfe des Daemon-Service aus.

(Optional) Erweiterte Konfiguration

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