• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Instale a integração do ECS

A integração do ECS da New Relic relata e exibe dados de desempenho do seu ambiente Amazon ECS.

Visão geral da instalação

Antes de instalar, pode ser útil entender em alto nível como nosso agente de infraestrutura (newrelic-infra) é implantado para estes dois tipos de lançamento:

Opções de instalação

Escolha a instalação desejada:

Instalar usando CloudFormation

Para ajudá-lo a instalar usando AWS CloudFormation, fornecemos alguns modelos do CloudFormation que instalam a integração do ECS em sua conta AWS para os tipos de lançamento EC2, EXTERNAL (ECS Anywhere) e AWS Fargate.

Para instalar usando CloudFormation:

  1. Para cadastrar a tarefa de integração do ECS, implante esta stack. Certifique-se de implantar a stack na(s) região(ões) desejada(s). Essa stack cria os seguintes recursos:

    • Um segredo que armazena a New Relic

      .

    • Uma política para acessar a chave de licença.

    • Uma função de instância a ser usada como uma tarefa ECS ExecutionRole, com acesso à chave de licença.

    • Para tipo de lançamento EC2 e Externo (ECS Anywhere): Registra a tarefa de integração do New Relic Infrastructure ECS.

  2. Siga as instruções adicionais para o seu tipo de lançamento:

Quando terminar, consulte Próximas etapas.

Instalar com script automático

Uma opção de instalação é usar nosso script de instalação. Para usar o script de instalação automática:

  1. Baixe o instalador de integração do ECS:

    curl -O https://download.newrelic.com/infrastructure_agent/integrations/ecs/newrelic-infra-ecs-installer.sh
  2. Adicione permissões de execução ao instalador:

    chmod +x newrelic-infra-ecs-installer.sh
  3. Execute-o com -h para ver a documentação e os requisitos:

    ./newrelic-infra-ecs-installer.sh -h
  4. Verifique se o seu perfil da AWS aponta para a mesma região onde o cluster do ECS foi criado:

    $ 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. Execute o instalador, especificando seu e o nome do cluster.

  6. Etapas adicionais para o tipo de lançamento Fargate (não para o tipo de lançamento EC2):

    • Baixe o exemplo de definição de tarefa com o contêiner sidecar a ser implantado:

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

      Dica

      Para Graviton, substitua "cpuArchitecture": "X86_64" por "cpuArchitecture": "ARM64".

      Observe que o NewRelicECSTaskExecutionRole recém-criado precisa ser usado como função de execução da tarefa. Políticas anexadas à função (todos os tipos de lançamento):

      • NewRelicSSMLicenseKeyReadAccess que permite acesso ao parâmetro SSM com a chave de licença.
      • AmazonECSTaskExecutionRolePolicy
    • Depois, você pode adicionar o contêiner que deseja monitor como sidecar.

Quando terminar, consulte Próximas etapas.

Instalação manual

Uma opção de instalação é executar manualmente as etapas executadas pelo script do instalador automático. Descreveremos como isso é feito usando a ferramenta awscli :

  1. Verifique se o seu perfil da AWS aponta para a mesma região onde o cluster do ECS foi criado:

    $ 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. Salve seu como um parâmetro do 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. Crie uma política IAM para acessar o parâmetro da chave de licença:

    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. Crie uma função do IAM para ser usada como função de execução de tarefas:

    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. Anexe as políticas NewRelicSSMLicenseKeyReadAccess e AmazonECSTaskExecutionRolePolicy à função:

    aws iam attach-role-policy \
    --role-name "NewRelicECSTaskExecutionRole" \
    --policy-arn "POLICY_ARN"
  6. Escolha seu tipo de lançamento para obter mais instruções:

Quando terminar, consulte Próximas etapas.

Este documento ajudou você na instalação?

Próximas etapas após a instalação

Depois de instalar esta integração:

Recursos AWS criados

Quando você instala a integração do ECS usando valores padrão/recomendados, ela faz o seguinte na AWS:

  • Cria o parâmetro /newrelic-infra/ecs/license-key do Systems Manager (SSM). Este parâmetro do sistema contém a New Relic

    .

  • Cria a política IAM NewRelicSSMLicenseKeyReadAccess, que permite acesso ao parâmetro SSM com a chave de licença.

  • Cria a função IAM NewRelicECSTaskExecutionRole usada como função de execução de tarefas. Políticas associadas à função:

    • NewRelicSSMLicenseKeyReadAccess (criado pelo instalador).
    • AmazonECSTaskExecutionRolePolicy
  • Registra a definição de tarefa newrelic-infra do ECS para os tipos de lançamento EC2 e externo (ECS Anywhere).

  • Para o tipo de lançamento EC2, isso também é feito:

    • Cria o serviço newrelic-infra para a tarefa registrada usando uma estratégia de agendamentodaemon e um tipo de lançamento do EC2.
  • Para o tipo de lançamento EXTERNO (ECS Anywhere), isso também é feito:

    • Cria o serviço newrelic-infra-external para a tarefa registrada usando uma estratégia de agendamento daemon e tipo de lançamento EXTERNO (ECS Anywhere).
Copyright © 2024 New Relic Inc.

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