Terapkan menggunakan AWS Cloud Development Kit (AWS CDK)

Buka CloudWatch konsol di https://console.aws.amazon.com/cloudwatch/.

Pada panel navigasi, silakan pilih Layanan.

Pilih Mulai menemukan Layanan Anda.

Pilih kotak centang kemudian pilih Mulai menemukan Layanan.

Menyelesaikan langkah ini untuk pertama kalinya di akun Anda akan membuat peran AWSServiceRoleForCloudWatchApplicationSignalsterkait layanan. Peran ini akan memberi Sinyal Aplikasi izin-izin berikut:

Untuk informasi selengkapnya tentang peran ini, silakan lihat Izin peran terkait layanan untuk Sinyal Aplikasi CloudWatch .

Dalam definisi tugas aplikasi Anda, tentukan bind mount. Ganti MOUNT_VOLUME sesuai dengan bahasa yang digunakan aplikasi Anda. Misalnya digunakan opentelemetry-auto-instrumentation di Jawa. Volume akan digunakan untuk berbagi file di seluruh kontainer pada langkah-langkah selanjutnya. Anda akan menggunakan bind mount ini nanti dalam prosedur ini:

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

Selanjutnya, Anda menambahkan CloudWatch agen. Ada dua metode yang mungkin untuk menggunakan CloudWatch agen tambahan: strategi sespan dan strategi daemon. Untuk informasi tentang pro dan kontra untuk setiap metode, lihat Gunakan pengaturan khusus untuk mengaktifkan Sinyal Aplikasi di Amazon ECS dan pilih metode terbaik untuk lingkungan Anda.

• Strategi Sidecar - Tambahkan wadah baru yang dipanggil ecs-cwagent ke definisi tugas aplikasi Anda. Ganti $IMAGE dengan jalur ke gambar CloudWatch kontainer terbaru di Amazon Elastic Container Registry. Untuk informasi selengkapnya, lihat cloudwatch-agent di Amazon. ECR

  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',
      }),
    }),
  });

• Strategi Daemon — Buat layanan baru yang disebut ecs-cwagent di tumpukan Anda. Ganti $TASK_ROLE_ARN and $EXECUTION_ROLE_ARN dengan IAM peran yang Anda persiapkanLangkah 2: Buat IAM peran. Ganti $IMAGE dengan jalur ke gambar CloudWatch kontainer terbaru di Amazon Elastic Container Registry. Untuk informasi selengkapnya, lihat cloudwatch-agent di Amazon. ECR

  catatan

  Layanan daemon mengekspos dua port pada host, dengan 4316 digunakan sebagai titik akhir untuk menerima metrik dan jejak dan 2000 sebagai titik akhir trace sampler. CloudWatch Pengaturan ini memungkinkan agen untuk mengumpulkan dan mengirimkan data telemetri dari semua tugas aplikasi yang berjalan di host. Pastikan port ini tidak digunakan oleh layanan lain di host untuk menghindari konflik.

  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,
  });

Tambahkan init container baru ke definisi tugas aplikasi Anda. Ganti $IMAGE dengan gambar terbaru dari repositori ECR gambar AWS Distro untuk OpenTelemetry Amazon. Ganti MOUNT_CONTAINER_PATH and INIT_CONTAINER_COMMAND sesuai dengan bahasa yang digunakan aplikasi Anda.

Misalnya, dalam penggunaan 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
});

Tambahkan variabel lingkungan ENVIRONMENT_VARIABLES ke wadah aplikasi Anda sesuai dengan bahasa yang digunakan aplikasi Anda. Dan pasang volumenya MOUNT_VOLUME dalam wadah aplikasi.

Berikut adalah contohnya:

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

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

Instal dependensi yang relevan ke aplikasi Node.js Anda untuk autoinstrumentasi:

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

Pada langkah 4 pada prosedur sebelumnya, lepaskan pemasangan volume:

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

Dan atur variabel lingkungan NODE_OPTIONS menjadi --import @aws/aws-distro-opentelemetry-node-autoinstrumentation/register --experimental-loader=@opentelemetry/instrumentation/hook.mjs