AWS Cloud Development Kit (AWS CDK)를 사용하여 배포

https://console.aws.amazon.com/cloudwatch/에서 CloudWatch 콘솔을 엽니다.

탐색 창에서 서비스를 선택합니다.

서비스 검색 시작을 선택합니다.

확인란을 선택하고 서비스 검색 시작을 선택합니다.

계정에서 처음으로 이 단계를 완료하면 AWSServiceRoleForCloudWatchApplicationSignals 서비스 역할이 생성됩니다. 이 역할은 Application Signals에 다음 권한을 부여합니다.

이에 대한 자세한 내용은 CloudWatch Application Signals에 대한 서비스 연결 역할 권한 섹션을 참조하세요.

애플리케이션 태스크 정의에서 바인드 탑재를 지정합니다. 애플리케이션이 사용하는 언어에 따라 MOUNT_VOLUME을 바꿉니다. 예를 들어, Java의 경우 opentelemetry-auto-instrumentation을 사용합니다. 다음 단계에서 이 볼륨은 컨테이너 간에 파일을 공유하는 데 사용됩니다. 이 바인드 탑재는 이 절차의 뒷부분에서 사용합니다.

const taskDefinition = new ecs.FargateTaskDefinition(this, 'MyTaskDefinition', {
  ...
  volumes: [{
    name: MOUNT_VOLUME,
  }]
 );

다음으로 CloudWatch 에이전트를 추가합니다. CloudWatch 에이전트 추가를 사용하는 방법은 사이드카 전략과 대몬 전략의 두 가지가 있습니다. 각 방법의 장단점에 대한 자세한 내용은 사용자 지정 설정을 사용하여 Amazon ECS에서 Application Signals를 활성화합니다. 섹션을 참조하고 환경에 가장 적합한 방법을 선택하세요.

• 사이트카 전략 – 애플리케이션의 태스크 정의에 ecs-cwagent라는 새 컨테이너를 추가합니다. $IMAGE를 Amazon Elastic Container Registry의 최신 CloudWatch 컨테이너 이미지 경로로 바꿉니다. 자세한 내용은 Amazon ECR의 cloudwatch-agent를 참조하세요.

  const cwAgentContainer = taskDefinition.addContainer('ecs-cwagent', {
    image: ecs.ContainerImage.fromRegistry("$IMAGE"),
    environment: {
      CW_CONFIG_CONTENT: '{"agent": {"debug": true}, "traces": {"traces_collected": {"application_signals": {"enabled": true}}}, "logs": {"metrics_collected": {"application_signals": {"enabled": true}}}}',
    },
    logging: new ecs.AwsLogDriver({
      streamPrefix: 'ecs',
      logGroup: new logs.LogGroup(this, 'CwAgentLogGroup', {
        logGroupName: '/ecs/ecs-cwagent',
      }),
    }),
  });

• 대몬 전략 - 스택에서 ecs-cwagent라는 새 서비스를 생성합니다. $TASK_ROLE_ARN 및 $EXECUTION_ROLE_ARN을 2단계 - IAM 역할 생성에서 준비한 IAM 역할로 바꿉니다. $IMAGE를 Amazon Elastic Container Registry의 최신 CloudWatch 컨테이너 이미지 경로로 바꿉니다. 자세한 내용은 Amazon ECR의 cloudwatch-agent를 참조하세요.

  참고

  대몬 서비스는 호스트에 2개의 포트를 노출합니다. 포트 4316은 지표 및 트레이스를 수신하는 엔드포인트로 사용되고 2000은 CloudWatch 트레이스 샘플러 엔드포인트로 사용됩니다. 이 설정을 사용하면 에이전트가 호스트에서 실행되는 모든 애플리케이션 태스크에서 원격 측정 데이터를 수집하고 전송할 수 있습니다. 충돌을 방지하기 위해 호스트의 다른 서비스에서 이러한 포트를 사용하지 않도록 합니다.

  const cwAgentTaskDefinition = new ecs.Ec2TaskDefinition(this, 'CwAgentDaemonTaskDef', {
      taskRole: "$TASK_ROLE_ARN",
      executionRole: "$EXECUTION_ROLE_ARN",
  });
  
  // Add the CloudWatch agent container
  const cwAgentContainer = cwAgentTaskDefinition.addContainer('ecs-cwagent', {
      image: ecs.ContainerImage.fromRegistry("$IMAGE"),
      cpu: 128,
      memoryLimitMiB: 64,
      portMappings: [
          {
              containerPort: 4316,
              hostPort: 4316,
          },
          {
              containerPort: 2000,
              hostPort: 2000,
          },
      ],
      logging: new ecs.AwsLogDriver({
          streamPrefix: 'ecs',
          logGroup: new logs.LogGroup(this, 'CwAgentLogGroup', {
              logGroupName: '/ecs/ecs-cwagent-daemon',
          }),
      }),
      environment: {
          CW_CONFIG_CONTENT: '{"agent": {"debug": true}, "traces": {"traces_collected": {"application_signals": {"enabled": true}}}, "logs": {"metrics_collected": {"application_signals": {"enabled": true}}}}',
      },
  });
  
  // Add the CloudWatch agent service running as a daemon
  const cwAgentService = new ecs.Ec2Service(this, 'CwAgentDaemonService', {
      cluster,
      taskDefinition: cwAgentTaskDefinition,
      daemon: true,
  });

애플리케이션의 태스크 정의에 새 컨테이너를 추가합니다. $IMAGE를 AWS Distro for OpenTelemetry Amazon ECR 이미지 리포지토리의 최신 이미지로 바꿉니다. 애플리케이션이 사용하는 언어에 따라 MOUNT_CONTAINER_PATH 및 INIT_CONTAINER_COMMAND를 바꿉니다.

예를 들어, Java의 경우 INIT_CONTAINER_COMMAND=["cp", "/javaagent.jar", "/otel-auto-instrumentation/javaagent.jar"], MOUNT_CONTAINER_PATH='/otel-auto-instrumentation'을 사용합니다.

const initContainer = taskDefinition.addContainer('init', {
    image: ecs.ContainerImage.fromRegistry("$IMAGE"),
    essential: false,
    command: INIT_CONTAINER_COMMAND
});

initContainer.addMountPoints({
    sourceVolume: MOUNT_VOLUME,
    containerPath: MOUNT_CONTAINER_PATH,
    readOnly: false
});

애플리케이션이 사용하는 언어에 따라 환경 변수 ENVIRONMENT_VARIABLES를 애플리케이션 컨테이너에 추가합니다. 그리고 볼륨 MOUNT_VOLUME을 애플리케이션 컨테이너에 탑재합니다.

다음은 그 예제입니다.

const appContainer = taskDefinition.addContainer('my-app', {
    ...
    environment: {
        ...
        ENVIRONMENT_VARIABLES
    },
});

appContainer.addMountPoints({
    sourceVolume: MOUNT_VOLUME,
    containerPath: MOUNT_CONTAINER_PATH,
    readOnly: false
});

관련 종속성을 자동 계측용 Node.js 애플리케이션에 설치합니다.

npm install @aws/aws-distro-opentelemetry-node-autoinstrumentation
npm install @opentelemetry/instrumentation@0.54.0

이전 절차의 4단계에서 볼륨 의 탑재를 제거합니다.

appContainer.addMountPoints({
    sourceVolume: MOUNT_VOLUME,
    containerPath: MOUNT_CONTAINER_PATH,
    readOnly: false
});

환경 변수 NODE_OPTIONS을(를) --import @aws/aws-distro-opentelemetry-node-autoinstrumentation/register --experimental-loader=@opentelemetry/instrumentation/hook.mjs(으)로 설정합니다.