Implementación mediante AWS Cloud Development Kit (AWS CDK)

Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.

En el panel de navegación, elija Servicios.

Elija Comenzar a detectar sus servicios.

Seleccione la casilla de verificación y elija Empezar a detectar servicios.

Al completar este paso por primera vez en la cuenta, se crea el rol vinculado al servicio AWSServiceRoleForCloudWatchApplicationSignals. Este rol otorga a Application Signals los siguientes permisos:

Para obtener más información acerca de este rol, consulte Permisos de roles vinculados a un servicio para CloudWatch Application Signals.

En la definición de tarea de la aplicación, especifique un montaje de unión. Sustituya MOUNT_VOLUME según el lenguaje que utilice la aplicación. Por ejemplo, utilice opentelemetry-auto-instrumentation en Java. El volumen se utilizará para compartir archivos entre contenedores en los siguientes pasos. Empleará este montaje de unión más adelante en este procedimiento:

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

A continuación, agregue el agente de CloudWatch. Existen dos métodos posibles para agregar el agente de CloudWatch: la estrategia de sidecar y la estrategia de daemon. Para obtener información sobre las ventajas y desventajas de cada método, consulte Use una configuración personalizada para habilitar Application Signals en Amazon ECS y seleccione el mejor método para su entorno.

• Estrategia de sidecar: agregue un nuevo contenedor denominado ecs-cwagent a la definición de tarea de la aplicación. Sustituya $IMAGE por la ruta a la imagen más reciente del contenedor de CloudWatch en Amazon Elastic Container Registry. Para obtener más información, consulte cloudwatch-agent en 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',
      }),
    }),
  });

• Estrategia de daemon: cree un nuevo servicio denominado ecs-cwagent en su pila. Sustituya $TASK_ROLE_ARN y $EXECUTION_ROLE_ARN por los roles de IAM que preparó en Paso 2: crear roles de IAM. Sustituya $IMAGE por la ruta a la imagen más reciente del contenedor de CloudWatch en Amazon Elastic Container Registry. Para obtener más información, consulte cloudwatch-agent en Amazon ECR.

  nota

  El servicio de daemon expone dos puertos del host: el 4316 se utiliza como punto de conexión para recibir métricas y seguimientos, mientras que el 2000 es el punto de conexión del muestreador de seguimientos de CloudWatch. Esta configuración permite al agente recopilar y transmitir datos de telemetría de todas las tareas de aplicación que se ejecuten en el host. Asegúrese de que otros servicios del host no utilicen estos puertos para evitar conflictos.

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

Agregue un nuevo inicio de contenedor a la definición de tareas de la aplicación. Sustituya $IMAGE por la imagen más reciente del repositorio de imágenes AWS Distro para OpenTelemetry de Amazon ECR. Sustituya MOUNT_CONTAINER_PATH e INIT_CONTAINER_COMMAND según el lenguaje que utilice la aplicación.

Por ejemplo, utilice INIT_CONTAINER_COMMAND=["cp", "/javaagent.jar", "/otel-auto-instrumentation/javaagent.jar"], MOUNT_CONTAINER_PATH='/otel-auto-instrumentation' en Java.

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

Agregue las variables de entorno ENVIRONMENT_VARIABLES al contenedor de la aplicación según el lenguaje que utilice la aplicación. Y monte el volumen MOUNT_VOLUME en el contenedor de la aplicación.

A continuación, se muestra un ejemplo:

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

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

appContainer.addContainerDependencies({
    container: initContainer,
    condition: ecs.ContainerDependencyCondition.SUCCESS
});

Instale en su aplicación Node.js las dependencias pertinentes para la autoinstrumentación:

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

En el paso 4 del procedimiento anterior, retire el montaje del volumen.

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

Y ajuste la variable de entorno NODE_OPTIONS a --import @aws/aws-distro-opentelemetry-node-autoinstrumentation/register --experimental-loader=@opentelemetry/instrumentation/hook.mjs