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](https://aws.amazon.com/otel/)
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](https://aws-otel.github.io/docs/setup/ecs#3-setup-the-aws-otel-collector-for-ecs-ec2-instance-metrics).
**Topics**
+ [Schnelle Einrichtung mit CloudFormation](#container-insights-ECS-OTEL-quicksetup)
+ [Manuelle und benutzerdefinierte Einrichtung](#container-insights-ECS-OTEL-custom)
## 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\$1TO\$1CloudFormation\$1TEMPLATE* 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** – Name des Amazon-ECS-Clusters
+ **AWS\$1RRegion** — Die Region, in die die Daten gesendet werden
+ **PATH\$1TO\$1 CloudFormation \$1TEMPLATE — Der Pfad, in dem Sie die Vorlagendatei** gespeichert haben. CloudFormation
+ **command** — Damit AWS Distro for OpenTelemetry Collector die Metriken auf Instance-Ebene für Amazon ECS auf Amazon EC2 sammeln kann, müssen Sie für diesen Parameter Folgendes angeben`--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}
```
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/\$1ClusterName\$1/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](https://aws-otel.github.io/docs/setup/ecs/create-iam-policy) und [IAM-Rolle erstellen](https://aws-otel.github.io/docs/setup/ecs/create-iam-role).
### 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](https://aws-otel.github.io/docs/setup/ecs/task-definition-for-ecs-ec2-instance). 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](https://aws-otel.github.io/docs/setup/ecs/create-task-definition-instance-console).
### 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](https://aws-otel.github.io/docs/setup/ecs/run-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 ](https://aws-otel.github.io/docs/setup/ecs#5-custom-opentelemetry-configuration) Weitere Informationen zu den Optionen, die Sie in der Konfigurationsdatei verwenden können, finden Sie unter [AWS Container Insights Receiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/awscontainerinsightreceiver/README.md).