• /
  • EnglishEspañol日本語한국어Português
  • Inicia sesiónComenzar ahora

Te ofrecemos esta traducción automática para facilitar la lectura.

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

Instalar la integración ECS

La integración ECS de New Relic informa y muestra datos de rendimiento de su entorno Amazon ECS.

Descripción general de la instalación

Antes de instalar, puede ayudarle a comprender en un alto nivel cómo nuestro agente de infraestructura (newrelic-infra) se implementa para estos dos tipos de lanzamiento:

Opciones de instalación

Elija la instalación que desee:

Instalar usando CloudFormation

Para ayudarle a realizar la instalación mediante AWS CloudFormation, proporcionamos algunas plantillas de CloudFormation que instalan la integración de ECS en su cuenta de AWS para los tipos de lanzamiento EC2, EXTERNO (ECS Anywhere) y AWS Fargate.

Para instalar usando CloudFormation:

  1. Para registrar la tarea de integración de ECS, despliegue esta stack. Asegúrese de desplegar la stack en las regiones deseadas. Esta stack crea los siguientes recursos:

    • Un secreto que almacena la New Relic

      .

    • Una política para acceder a la clave de licencia.

    • Un rol de instancia que se utilizará como tarea de ECS ExecutionRole, con acceso a la clave de licencia.

    • Para tipo de lanzamiento EC2 y externo (ECS Anywhere): registra la tarea de integración ECS New Relic Infrastructure .

  2. Siga las instrucciones adicionales para su tipo de lanzamiento:

Cuando haya terminado, consulte Próximos pasos.

Instalar con script automático

Una opción de instalación es utilizar nuestro script de instalación. Para utilizar el script de instalación automática:

  1. Descargue el instalador de integración de ECS:

    curl -O https://download.newrelic.com/infrastructure_agent/integrations/ecs/newrelic-infra-ecs-installer.sh
  2. Agregue permisos de ejecución al instalador:

    chmod +x newrelic-infra-ecs-installer.sh
  3. Ejecútelo con -h para ver la documentación y requisitos:

    ./newrelic-infra-ecs-installer.sh -h
  4. Verifique que su perfil de AWS apunte a la misma región donde se creó su clúster ECS:

    $ aws configure get region
    us-east-1
    $ aws ecs list-clusters
    YOUR_CLUSTER_ARNS
    arn:aws:ecs:us-east-1:YOUR_AWS_ACCOUNT:cluster/YOUR_CLUSTER
  5. Ejecute el instalador, especificando su y el nombre del clúster.

  6. Pasos adicionales para el tipo de lanzamiento Fargate (no el tipo de lanzamiento EC2):

    • Descargue el ejemplo de definición de tarea con el contenedor sidecar a desplegar:

      curl -O https://download.newrelic.com/infrastructure_agent/integrations/ecs/newrelic-infra-ecs-fargate-example-latest.json

      Sugerencia

      Para Graviton, reemplace "cpuArchitecture": "X86_64" con "cpuArchitecture": "ARM64".

      Tenga en cuenta que el NewRelicECSTaskExecutionRole recién creado debe usarse como función de ejecución de la tarea. Políticas adjuntas al rol (Todos los tipos de lanzamiento):

      • NewRelicSSMLicenseKeyReadAccess que permite acceder al parámetro SSM con la clave de licencia.
      • AmazonECSTaskExecutionRolePolicy
    • Luego, puede agregar el contenedor que desea monitor como sidecar.

Cuando haya terminado, consulte Próximos pasos.

Manual de instalación

Una opción de instalación es realizar manualmente los pasos que realiza el script del instalador automático. Describiremos cómo se hace esto usando la herramienta awscli :

  1. Verifique que su perfil de AWS apunte a la misma región donde se creó su clúster ECS:

    $ aws configure get region
    us-east-1
    $ aws ecs list-clusters
    YOUR_CLUSTER_ARNS
    arn:aws:ecs:us-east-1:YOUR_AWS_ACCOUNT:cluster/YOUR_CLUSTER
  2. Guarde su como parámetro de Systems Manager (SSM):

    aws ssm put-parameter \
    --name "/newrelic-infra/ecs/license-key" \
    --type SecureString \
    --description 'New Relic license key for ECS monitoring' \
    --value "NEW_RELIC_LICENSE_KEY"
  3. Cree una política de IAM para acceder al parámetro de clave de licencia:

    aws iam create-policy \
    --policy-name "NewRelicSSMLicenseKeyReadAccess" \
    --policy-document "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"ssm:GetParameters\"],\"Resource\":[\"ARN_OF_LICENSE_KEY_PARAMETER\"]}]}" \
    --description "Provides read access to the New Relic SSM license key parameter"
  4. Cree una función de IAM para utilizarla como función de ejecución de tareas:

    aws iam create-role \
    --role-name "NewRelicECSTaskExecutionRole" \
    --assume-role-policy-document '{"Version":"2008-10-17","Statement":[{"Sid":"","Effect":"Allow","Principal":{"Service":"ecs-tasks.amazonaws.com"},"Action":"sts:AssumeRole"}]}' \
    --description "ECS task execution role for New Relic infrastructure"
  5. Adjunte las políticas NewRelicSSMLicenseKeyReadAccess y AmazonECSTaskExecutionRolePolicy al rol:

    aws iam attach-role-policy \
    --role-name "NewRelicECSTaskExecutionRole" \
    --policy-arn "POLICY_ARN"
  6. Elija su tipo de lanzamiento para obtener más instrucciones:

Cuando haya terminado, consulte Próximos pasos.

¿Te ha ayudado este documento con la instalación?

Siguientes pasos después de la instalación

Después de haber instalado esta integración:

Recursos de AWS creados

Cuando instala la integración de ECS utilizando valores predeterminados/recomendados, hace lo siguiente en AWS:

  • Crea el parámetro /newrelic-infra/ecs/license-key del Administrador de sistemas (SSM). Este parámetro del sistema contiene la New Relic

    .

  • Crea la política de IAM NewRelicSSMLicenseKeyReadAccess, que permite el acceso al parámetro SSM con la clave de licencia.

  • Crea el rol de IAM NewRelicECSTaskExecutionRole utilizado como rol de ejecución de tareas. Políticas adjuntas al rol:

    • NewRelicSSMLicenseKeyReadAccess (creado por el instalador).
    • AmazonECSTaskExecutionRolePolicy
  • Registra la newrelic-infra definición de tarea ECS para los tipos de lanzamiento EC2 y externo (ECS Anywhere).

  • Para el tipo de lanzamiento EC2, esto también se hace:

    • Crea el servicio newrelic-infra para la tarea registrada utilizando una estrategia de programacióndaemon y un tipo de lanzamiento EC2.
  • Para el tipo de lanzamiento EXTERNO (ECS Anywhere), esto también se hace:

    • Crea el servicio newrelic-infra-external para la tarea registrada utilizando una estrategia de programación daemon y un tipo de lanzamiento EXTERNO (ECS Anywhere).
Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.