本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

將應用程式指標匯出至 Amazon CloudWatch

Amazon ECS on Fargate 支援將您的自訂應用程式指標匯出至 Amazon CloudWatch 作為自訂指標。方法是將 OpenTelemetry Sidecar AWS 容器的 Distro 新增至您的任務定義。Amazon ECS主控台會在建立新的任務定義時新增使用指標集合選項，以簡化此程序。如需詳細資訊，請參閱使用主控台建立 Amazon ECS任務定義。

應用程式指標會匯出至具有 CloudWatch 日誌群組名稱的日誌，/aws/ecs/application/metrics並且可以在ECS/AWSOTel/Application命名空間中檢視指標。您的應用程式必須使用 進行測試 OpenTelemetry SDK。如需詳細資訊，請參閱 AWS Distro 中的 Distro for 簡介 OpenTelemetry文件 OpenTelemetry 。 AWS

考量事項

使用 Amazon ECS on Fargate 與 AWS Distro for 整合 OpenTelemetry ，將應用程式指標傳送至 Amazon 時，應考慮下列事項 CloudWatch。

AWS Distro 與 Amazon OpenTelemetry 整合所需的IAM許可 CloudWatch

Amazon 與 AWS Distro for 的ECS整合 OpenTelemetry 需要您建立任務IAM角色，並在任務定義中指定角色。建議您也設定 AWS Distro for OpenTelemetry sidecar，將容器日誌路由至 Logs，該 CloudWatch 日誌也需要在您的任務定義中建立和指定任務執行IAM角色。Amazon ECS主控台會代表您處理任務執行IAM角色，但任務IAM角色必須手動建立並新增至您的任務定義。如需任務執行IAM角色的詳細資訊，請參閱 Amazon ECS任務執行IAM角色。

在任務定義中指定 OpenTelemetry Sidecar AWS 的 Distro

Amazon ECS主控台使用使用指標收集選項，簡化為 OpenTelemetry Sidecar 容器建立 AWS Distro 的體驗。如需詳細資訊，請參閱使用主控台建立 Amazon ECS任務定義。

如果您不使用 Amazon ECS主控台，則可以手動將 Distro for OpenTelemetry Sidecar AWS 容器新增至任務定義。下列任務定義範例顯示為 Amazon CloudWatch 整合新增 OpenTelemetry 旁路 AWS 專用 Distro 的容器定義。

{
	"family": "otel-using-cloudwatch",
	"taskRoleArn": "arn:aws:iam::111122223333:role/AmazonECS_OpenTelemetryCloudWatchRole",
	"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/ecs-cloudwatch.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"
}