ECSインテグレーションのインストール

New Relic の ECS 統合は、Amazon ECS 環境からのパフォーマンス データをレポートおよび表示します。

インストールの概要

を インストールする前に、次の 2 つの起動タイプに対してインフラストラクチャ エージェント (newrelic-infra) がどのようにデプロイされるかを概要を理解するのに役立ちます。

• EC2 および外部 (ECS Anywhere) 起動タイプ: エージェントは、デーモン スケジューリング戦略を使用してサービスとして ECS クラスターにデプロイされます (こちらの AWS ドキュメントで説明されています)。これにより、クラスターのすべての EC2 インスタンスにエージェントがインストールされ、ECS と Docker コンテナが監視されます。
• AWS Fargate 起動タイプ: 監視するすべてのタスクで、エージェントはサイドカーとしてデプロイされます。オプション: AWS がサイドカーを定義する方法について詳しく学びます。

インストールオプション

必要なインストールを選択します。

• AWS CloudFormationによるインストール
• 自動スクリプトによるインストール
• 手動インストール

CloudFormationによるインストール

AWS CloudFormation を使用したインストールを支援するために、EC2、EXTERNAL (ECS Anywhere)、および AWS Fargate 起動タイプの AWS アカウントに ECS 統合をインストールするいくつかの CloudFormation テンプレートが提供されています。

CloudFormation を使用してインストールするには:

1. ECS 統合タスクを登録するには、 このスタックをデプロイします。スタックを目的のリージョンにデプロイしていることを確認してください。このスタックは次のリソースを作成します。

   • ニューレリックを保存する秘密

     アカウントのライセンスキー

     。

   • ライセンスキーにアクセスするためのポリシーです。

   • ECSタスクExecutionRoleとして使用されるインスタンスロールで、ライセンスキーにアクセスできます。

   • EC2 および外部 (ECS Anywhere) の起動タイプ: New Relic インフラストラクチャ ECS 統合タスクを登録します。

2. お客様のローンチタイプに応じた追加の指示に従ってください。

   EC2起動タイプ

   すべてのEC2コンテナ・インスタンスでタスクを実行するサービスを作成するには、 このスタックをデプロイします.

   EC2起動タイプを選択します。次に、 newrelic-infraという名前のサービスがクラスターに作成されます。

   外部(ECS Anywhere)起動タイプ

   すべての外部コンテナ・インスタンスでタスクを実行するサービスを作成するには、 このスタック をデプロイします。

   EXTERNALLaunchtypeを選択します。次に、 newrelic-infra-externalという名前のサービスがクラスターに作成されます。

   AWS Fargate打ち上げタイプ

   1. デプロイするサイドカー・コンテナを含むタスク定義例をダウンロードします。

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

      コピー

      ヒント

      Gravitonの場合、 "cpuArchitecture": "X86_64"を"cpuArchitecture": "ARM64"に置き換えます。

   2. このタスク定義のnewrelic-infraコンテナを、監視するタスク定義のサイドカーとして追加します。このタスク例では、アプリケーションのコンテナーがプレースホルダーbusyboxコンテナーを置き換えます。

完了したら、 「次のステップ」を参照してください。

自動スクリプトによるインストール

インストールオプション の一つは、当社のインストールスクリプトを使用することです。自動インストールスクリプトを使用するには

1. ECSインテグレーションのインストーラーをダウンロードする。

   curl -O https://download.newrelic.com/infrastructure_agent/integrations/ecs/newrelic-infra-ecs-installer.sh

   コピー

2. インストーラーに実行権限を追加する。

   chmod +x newrelic-infra-ecs-installer.sh

   コピー

3. -hで実行して、ドキュメントと要件を確認します。

   ./newrelic-infra-ecs-installer.sh -h

   コピー

4. AWSプロファイルが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. を指定して、インストーラーを実行します。 アカウントのライセンスキーおよびクラスター名。

   EC2起動タイプ

   ./newrelic-infra-ecs-installer.sh -c YOUR_CLUSTER_NAME -l YOUR_LICENSE_KEY

   コピー

   外部(ECS Anywhere)起動タイプ

   ./newrelic-infra-ecs-installer.sh -c YOUR_CLUSTER_NAME -l YOUR_LICENSE_KEY -e

   コピー

   AWS Fargate打ち上げタイプ

   ./newrelic-infra-ecs-installer.sh -f -c YOUR_CLUSTER_NAME -l YOUR_LICENSE_KEY

   コピー

6. Fargate 起動タイプ (EC2 起動タイプではない) の追加手順:

   • デプロイするサイドカー・コンテナを含むタスク定義例をダウンロードします。

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

     コピー

     ヒント

     Gravitonの場合、 "cpuArchitecture": "X86_64"を"cpuArchitecture": "ARM64"に置き換えます。

     作成したばかりのNewRelicECSTaskExecutionRoleをタスク実行ロールとして使用する必要があることに注意してください。ロールに関連付けられているポリシー（すべての起動タイプ）：

     • NewRelicSSMLicenseKeyReadAccessは、ライセンスキーを使用してSSMパラメーターにアクセスできるようにします。
     • AmazonECSTaskExecutionRolePolicy

   • 次に、監視するコンテナをサイドカーとして追加できます。

完了したら、 「次のステップ」を参照してください。

マニュアルインストール

インストールオプションの1つは、自動インストーラスクリプトによって実行される手順を手動で実行することです。 awscliツールを使用してこれを行う方法を説明します。

1. AWSプロファイルが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. あなたの保存 アカウントのライセンスキー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. ライセンスキーパラメーターにアクセスするためのIAMポリシーを作成します。

   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. タスク実行ロールとして使用するIAMロールを作成します。

   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. ポリシーNewRelicSSMLicenseKeyReadAccessとAmazonECSTaskExecutionRolePolicyをロールに添付します。

   aws iam attach-role-policy \
       --role-name "NewRelicECSTaskExecutionRole" \
       --policy-arn "POLICY_ARN"

   コピー

6. 詳細については、ローンチタイプを選択してください。

   EC2とEXTERNAL（ECS Anywhere）の起動タイプ

   EC2起動タイプの追加手順

   1. New Relic ECS統合タスク定義テンプレートファイルをダウンロードします。

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

      コピー

   2. テンプレートファイルのタスク実行ロールを、新しく作成したロールで置き換えます。

      "executionRoleArn": "NewRelicECSTaskExecutionRole",

      コピー

   3. secretのvalueFrom属性をSystemsManagerパラメーターの名前に置き換えます。

      secrets": [
        {
          "valueFrom": "/newrelic-infra/ecs/license-key",
          "name": "NRIA_LICENSE_KEY"
        }
      ],

      コピー

   4. タスク定義ファイルを登録します。

      aws ecs register-task-definition --cli-input-json file://newrelic-infra-ecs-ec2-latest.json

      コピー

   5. 登録したタスクに対して、 デーモンのスケジューリング 戦略でサービスを作成します。

      EC2起動タイプの場合

      aws ecs create-service --cluster "YOUR_CLUSTER_NAME" --service-name "newrelic-infra" --task-definition "newrelic-infra" --scheduling-strategy DAEMON --launch-type EC2

      コピー

      EXTERNAL（ECS Anywhere）の起動タイプの場合。

      aws ecs create-service --cluster "YOUR_CLUSTER_NAME" --service-name "newrelic-infra-external" --task-definition "newrelic-infra" --scheduling-strategy DAEMON --launch-type EXTERNAL

      コピー

   AWS Fargate打ち上げタイプ

   AWS Fargateのローンチタイプの追加手順です。

   1. デプロイするサイドカー・コンテナを含むタスク定義例をダウンロードします。

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

      コピー

      ヒント

      Gravitonの場合、 "cpuArchitecture": "X86_64"を"cpuArchitecture": "ARM64"に置き換えます。

   2. このタスク定義のnewrelic-infraコンテナを、監視するタスク定義のサイドカーとして追加します。このタスク例では、アプリケーションのコンテナーがプレースホルダーbusyboxコンテナーを置き換えます。

完了したら、 「次のステップ」を参照してください。

インストール後の手順

この統合をインストールした後:

• 数分待ってから、 UIでデータを探してみてください 。
• 推奨します。ECS クラウド・インテグレーション をインストールすると、クラスターやサービスに関する情報など、その他の ECS データを取得できます。
• 推奨される警告条件 を参照してください。
• このプロセスで作成される AWS リソース を理解する。

作成されたAWSリソース

デフォルト/推奨値を使用してECSインテグレーションをインストールすると、AWSで次のようになります。

• Systems Manager (SSM) パラメータ/newrelic-infra/ecs/license-keyを作成します。このシステム パラメータには、New Relic が含まれています。

  アカウントのライセンスキー

  .

• IAMポリシーNewRelicSSMLicenseKeyReadAccessを作成します。これにより、ライセンスキーを使用してSSMパラメータにアクセスできるようになります。

• タスク実行ロールとして使用されるIAMロールNewRelicECSTaskExecutionRoleを作成します。役割に関連付けられているポリシー：

  • NewRelicSSMLicenseKeyReadAccess （インストーラーによって作成されます）。
  • AmazonECSTaskExecutionRolePolicy

• EC2および外部（ECS Anywhere）起動タイプのnewrelic-infra ECSタスク定義を登録します。

• EC2 launch type の場合も同様に行われます。

  • デーモンスケジューリング戦略とEC2起動タイプを使用して、登録されたタスクのサービスnewrelic-infraを作成します。

• EXTERNAL (ECS Anywhere) 起動タイプ の場合も同様に行います。

  • デーモンスケジューリング戦略とEXTERNAL（ECS Anywhere）起動タイプを使用して、登録されたタスクのサービスnewrelic-infra-externalを作成します。