Sammeln von Anwendungs-Nachverfolgungsdaten

Amazon ECS lässt sich integrieren mitAWSDistribution für OpenTelemetry um Trace-Daten aus Ihrer Anwendung zu sammeln. Amazon ECS verwendet eineAWSDistribution für OpenTelemetry Beiwagencontainer zum Sammeln und Weiterleiten von Trace-Daten anAWS X-Ray. Weitere Informationen finden Sie unterEinrichtenAWSDistribution für OpenTelemetry Collector in Amazon ECS.

Für dieAWSDistro für OpenTelemetry Collector, an den Trace-Daten gesendet werden sollenAWS X-Ray, Ihre Anwendung muss so konfiguriert sein, dass sie die Trace-Daten erstellt. Weitere Informationen finden Sie unter Instrumentieren Ihrer Anwendung für AWS X-Ray im Entwicklerhandbuch zu AWS X-Ray.

Erforderliche IAM-Berechtigungen fürAWSDistribution für OpenTelemetryIntegration mitAWS X-Ray

Die Amazon ECS-Integration mitAWSDistribution für OpenTelemetry erfordert, dass Sie eine Aufgaben-IAM-Rolle erstellen und die Rolle in Ihrer Aufgabendefinition angeben. Wir empfehlen, dassAWSDistribution für OpenTelemetry Sidecar kann auch so konfiguriert werden, dass Container-Logs an CloudWatch Protokolle, für die eine IAM-Rolle zur Aufgabenausführung erforderlich ist, müssen ebenfalls erstellt und in Ihrer Aufgabendefinition angegeben werden. Die neue Amazon-ECS-Konsolenerfahrung kümmert sich in Ihrem Namen um die IAM-Aufgabenausführungsrolle, die Aufgaben-IAM-Rolle muss jedoch manuell erstellt werden. Weitere Informationen zum Erstellen der IAM-Aufgabenausführungsrolle finden Sie unter IAM-Rolle für die Amazon-ECS-Aufgabenausführung.

Wichtig

Wenn Sie auch Anwendungsmetriken mit dem sammelnAWSDistribution für OpenTelemetryIntegration, stellen Sie sicher, dass Ihre Aufgaben-IAM-Rolle auch die für diese Integration erforderlichen Berechtigungen enthält. Weitere Informationen finden Sie unter Erfassen von Anwendungsmetriken.

Um eine IAM-Rolle für Aufgaben zu erstellenAWSDistribution für OpenTelemetry Integration

1. Öffnen Sie die IAM-Konsole unter https://console.aws.amazon.com/iam/.

2. Wählen Sie im Navigationsbereich Policies und Create policy aus.

3. Wechseln Sie auf der Seite Create policy (Richtlinie erstellen) zur Registerkarte JSON, kopieren Sie die folgende IAM-Richtlinien-JSON und fügen Sie sie in das Feld ein. Wählen Sie dann Next: Tags (Weiter: Tags).

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "xray:PutTraceSegments",
                   "xray:PutTelemetryRecords",
                   "xray:GetSamplingRules",
                   "xray:GetSamplingTargets",
                   "xray:GetSamplingStatisticSummaries"
               ],
               "Resource": "*"
           }
       ]
   }

4. (Optional) Fügen Sie einen oder mehrere Tags zu der Richtlinie hinzu und wählen Sie dann Next: Review (Weiter: Prüfen) aus.

5. Geben Sie für Name AWSDistroOpenTelemetryPolicyForXray an.

6. Geben Sie für Description (Beschreibung) eine optionale Beschreibung an und wählen Sie dann Create policy (Richtlinie erstellen).

7. Wählen Sie im Navigationsbereich Roles (Rollen) und Create Role (Rolle erstellen) aus.

8. Wählen Sie im Abschnitt Select type of trusted entity (Typ der vertrauenswürdigen juristischen Stelle auswählen) AWS-Service und Elastic Container Service aus.

9. Wählen Sie für Select your use case (Anwendungsfall auswählen) die Option Elastic Container Service Task (Elastic Container Service-Aufgabe) aus und klicken Sie dann auf Next: Permissions (Weiter: Berechtigungen).

10. In derBerechtigungsrichtlinie anhängenAbschnitt, suche nachAWSDistroOpenTelemetryPolicyForXray, wählen Sie die Richtlinie aus, und wählen Sie dannWeiter: Schlagworte.

11. Geben Sie für Tags hinzufügen (optional) alle benutzerdefinierten Tags an, die mit der Richtlinie verknüpft werden sollen, und wählen SieWeiter: Prüfen.

12. Geben Sie unter Role name (Rollenname) den Namen AmazonECS_OpenTelemetryXrayRole an und wählen Sie Create role (Rolle erstellen).

Spezifizierung derAWSDistribution für OpenTelemetryBeiwagen fürAWS X-RayIntegration in Ihre Aufgabendefinition

Die neue Amazon ECS-Konsole vereinfacht die Erstellung vonAWSDistribution für OpenTelemetry Beiwagencontainer mit demVerwenden Sie die Trace-ErfassungWahl. Weitere Informationen finden Sie unter Erstellen einer Aufgabendefinition mit der Konsole.

Wenn Sie die Amazon ECS-Konsole nicht verwenden, können Sie die hinzufügenAWSDistribution für OpenTelemetry Sidecar-Container zu Ihrer Aufgabendefinition. Der folgende Ausschnitt aus der Aufgabendefinition zeigt die Containerdefinition für das Hinzufügen vonAWSDistribution für OpenTelemetry Beiwagen fürAWS X-RayIntegration.

{
	"family": "otel-using-xray",
	"taskRoleArn": "arn:aws:iam::111122223333:role/AmazonECS_OpenTelemetryXrayRole",
	"executionRoleArn": "arn:aws:iam::111122223333:role/ecsTaskExecutionRole",
	"containerDefinitions": [{
			"name": "aws-otel-emitter",
			"image": "application-image",
			"logConfiguration": {
				"logDriver": "awslogs",
				"options": {
					"awslogs-create-group": "true",
					"awslogs-group": "/ecs/aws-otel-emitter",
					"awslogs-region": "us-east-1",
					"awslogs-stream-prefix": "ecs"
				}
			},
			"dependsOn": [{
				"containerName": "aws-otel-collector",
				"condition": "START"
			}]
		},
		{
			"name": "aws-otel-collector",
			"image": "public.ecr.aws/aws-observability/aws-otel-collector:v0.30.0",
			"essential": true,
			"command": [
				"--config=/etc/ecs/otel-instance-metrics-config.yaml"
			],
			"logConfiguration": {
				"logDriver": "awslogs",
				"options": {
					"awslogs-create-group": "True",
					"awslogs-group": "/ecs/ecs-aws-otel-sidecar-collector",
					"awslogs-region": "us-east-1",
					"awslogs-stream-prefix": "ecs"
				}
			}
		}
	],
	"networkMode": "awsvpc",
	"requiresCompatibilities": [
		"FARGATE"
	],
	"cpu": "1024",
	"memory": "3072"
}