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

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

インストールの概要

インストールする前に、次の2つの起動タイプに対してinfrastructureエージェント（newrelic-infra）がどのようにデプロイされるかの概要を理解しておくとよいでしょう。

EC2 and EXTERNAL (ECS Anywhere) launch type: デーモンスケジューリング戦略を使用して、エージェントをサービスとしてECSクラスタにデプロイします（AWSドキュメントでの説明はこちら）。これにより、クラスタのすべてのEC2インスタンスにエージェントがインストールされ、ECSとDockerコンテナが監視されます。
AWS Fargate launch type: 監視するすべてのタスクで、エージェントをサイドカーとしてデプロイします。必要に応じて、AWSでサイドカーを定義する方法の詳細をご覧ください。

インストールオプション

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

AWS CloudFormationを使用してインストールする
自動スクリプトを使用してインストールする
手動でインストールする

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

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

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

ECSインテグレーションタスクを登録するには、このスタックをデプロイします。スタックを1つ以上の目的のリージョンにデプロイしていることを確認してください。このスタックは次のリソースを作成します。
- New Relic を保存するシークレット
- ライセンスキーにアクセスするためのポリシー
- ライセンスキーへのアクセス権を持つ、ECSタスクExecutionRoleとして使用されるインスタンスロール
- EC2およびEXTERNAL（ECS Anywhere）起動タイプ向けの、New Relic InfrastructureのECSインテグレーションタスクの登録。

起動タイプに応じて追加の手順に従ってください。

デプロイするサイドカーコンテナを含むタスク定義の例をダウンロードします。
bash
```
$curl -O https://download.newrelic.com/infrastructure_agent/integrations/ecs/newrelic-infra-ecs-fargate-example-latest.json
```
ヒント
Gravitonの場合は、"cpuArchitecture": "X86_64"を"cpuArchitecture": "ARM64"に置き換えます。
このタスク定義のnewrelic-infraコンテナを、監視するタスク定義にサイドカーとして追加します。このタスク例では、アプリケーションのコンテナがプレースホルダーbusyboxコンテナを置き換えます。
Fargate向けinfrastructureエージェントの転送モードを設定する
Fargate環境でNew Relic Infrastructureエージェントをサイドカーとしてデプロイする場合、エージェントの転送モードを設定する必要があります。Fargateはサーバーレスのコンピューティングサービスであり、基盤となるインフラストラクチャはAWSが管理するため、エージェントにホストレベルのメトリクスを報告させたり、ホストエンティティを作成させたりすべきではありません。
推奨：NRIA_IS_FORWARD_ONLY
原則として、Fargateのデプロイでは、NRIA_IS_FORWARD_ONLYをtrueに設定します。
```
{
  "name": "NRIA_IS_FORWARD_ONLY",
  "value": "true"
}
```
この設定がFargateで推奨される理由は以下のとおりです。

不要なホストエンティティの作成を防止：Fargateはサーバーレスであり、基盤となるコンピューティングリソースをAWSが管理するため、infrastructureエージェントはNew Relicにホストエンティティを作成しません。
請求額の不一致を回避：エンティティベースの従量課金では、監視対象のエンティティ数に基づいて料金が算定されます。ホストエンティティが誤って作成されると、予期しない請求が発生します。
適切なAPMとコンテナのリンクを有効化：APMアプリケーションが、実体のないホストエンティティではなく、コンテナエンティティに正しくリンクされます。

インテグレーションデータに重点：エージェントは、ホストメトリクスを報告せず、インテグレーションデータ（データベース、Webサーバー、メッセージキューなど）を収集・転送します。

代替設定：NRIA_IS_SECURE_FORWARD_ONLY

代替の転送モードとして、NRIA_IS_SECURE_FORWARD_ONLYがあります。New Relic UIでホストエンティティを表示する必要がある場合は、これをtrueに設定します。

{
  "name": "NRIA_IS_SECURE_FORWARD_ONLY",
  "value": "true"
}

転送モード間の違いは以下のとおりです。

機能	NRIA_IS_FORWARD_ONLY	NRIA_IS_SECURE_FORWARD_ONLY
NR1でのホストエンティティの表示	いいえ	はい
インフラストラクチャUIでのホストインベントリの表示	いいえ	はい
インテグレーションインベントリ	いいえ	はい
インテグレーションイベントの転送	はい	はい
インテグレーションエンティティ（例：Redisサーバー）	いいえ	はい
ホストメトリクス（CPU、メモリ、ディスク）	いいえ	いいえ
コンテナメタデータの付加	いいえ	はい
インテグレーションイベントのエンティティメタデータ	いいえ	一部

各モードの使用に適した場面は以下のとおりです。

次の場合は、NRIA_IS_FORWARD_ONLY=true（推奨）を使用します。
- エンティティ数と請求額への影響を最小限に抑えたい場合
- コンテナとインテグレーションのみを監視したい場合
- New Relic UIでホストインベントリを表示する必要がない場合
次の場合は、NRIA_IS_SECURE_FORWARD_ONLY=trueを使用します。
- New Relic UIでホストメタデータとインベントリ情報を確認する必要がある場合
- インフラストラクチャUIでインテグレーションエンティティを確認したい場合
- エンティティ数を考慮する必要がない場合
必須のFargate設定を含むタスク定義の例：
```
{
  "family": "newrelic-infra-fargate",
  "networkMode": "awsvpc",
  "requiresCompatibilities": ["FARGATE"],
  "cpu": "256",
  "memory": "512",
  "containerDefinitions": [
    {
      "name": "newrelic-infra",
      "image": "newrelic/nri-ecs:latest",
      "essential": false,
      "environment": [
        {
          "name": "NRIA_IS_FORWARD_ONLY",
          "value": "true"
        },
        {
          "name": "NRIA_LICENSE_KEY",
          "value": "your-license-key"
        },
        {
          "name": "NRIA_PASSTHROUGH_ENVIRONMENT",
          "value": "ECS_CONTAINER_METADATA_URI,ECS_CONTAINER_METADATA_URI_V4,FARGATE"
        },
        {
          "name": "FARGATE",
          "value": "true"
        }
      ]
    },
    {
      "name": "your-application",
      "image": "your-app-image:latest",
      "essential": true
    }
  ]
}
```
重要
Fargateデプロイメントでは、NRIA_IS_FORWARD_ONLY=true環境変数は必須です。この設定を省略すると、次のような問題が発生する可能性があります。
- ホストエンティティの誤作成
- APMとコンテナの関連付け失敗
- 予期しないエンティティ数による請求額の不一致
  タスク定義のサンプルをダウンロードする場合は、この環境変数が含まれており、trueに設定されていることを確認してください。

タスク定義を登録します：

bash

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

このタスク定義を使用して、サービスを作成するか、タスクを実行します。

完了したら、次の手順を参照してください。

自動スクリプトでインストールする

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

ECSインテグレーションインストーラをダウンロードします

bash

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

インストーラに実行権限を追加します
bash
```
$chmod +x newrelic-infra-ecs-installer.sh
```
-hで実行してドキュメントと要件を確認します
bash
```
$./newrelic-infra-ecs-installer.sh -h
```

AWSプロファイルが ECSクラスタが作成されたのと同じリージョンを指していることを確認します

bash

$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

とクラスタ名を指定してインストーラーを実行します。

Fargate起動タイプ（EC2起動タイプではない）の追加手順：
- デプロイするサイドカーコンテナを含むタスク定義の例をダウンロードします。
  bash
```
$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
- 監視するコンテナをサイドカーとして追加します。
重要
AWS Fargateを使用する場合は、タスク定義内でサイドカーコンテナの環境変数NRIA_IS_FORWARD_ONLYがtrueに設定されていることも確認してください。設定方法の詳細と、この環境変数の設定が重要である理由については、CloudFormationのFargateセットアップ手順を参照してください。

完了したら、次の手順を参照してください。

手動インストール

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

AWSプロファイルが ECSクラスタが作成されたのと同じリージョンを指していることを確認します
bash
```
$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
```

をSystems Manager（SSM）パラメーターとして保存します。

bash

$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"

ライセンスキーパラメーターにアクセスするためのIAMポリシーを作成します

bash

$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"

タスク実行ロールとして使用するIAMロールを作成します

bash

$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"

NewRelicSSMLicenseKeyReadAccessポリシーとAmazonECSTaskExecutionRolePolicyをロールにアタッチします。
bash
```
$aws iam attach-role-policy \
>  --role-name "NewRelicECSTaskExecutionRole" \
>  --policy-arn "POLICY_ARN"
```
詳細な手順については、以下の起動タイプを選択してください
EC2起動タイプの追加手順：
New Relic ECSインテグレーションのタスク定義テンプレートファイルをダウンロードします。
bash
$curl -O https://download.newrelic.com/infrastructure_agent/integrations/ecs/newrelic-infra-ecs-ec2-latest.json
テンプレートファイル内のタスク実行ロールを、新しく作成したロールに置き換えます。
"executionRoleArn": "NewRelicECSTaskExecutionRole",
secretのvalueFrom属性をSystems Managerパラメーターの名前に置き換えます。
"secrets": [ { "valueFrom": "/newrelic-infra/ecs/license-key", "name": "NRIA_LICENSE_KEY" } ],
タスク定義ファイルを登録します。
bash
$aws ecs register-task-definition --cli-input-json file://newrelic-infra-ecs-ec2-latest.json
登録されたタスクのデーモンスケジューリング戦略を使用してサービスを作成します。
EC2起動タイプの場合：
bash
$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）起動タイプの場合：
bash
$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起動タイプの追加手順：
デプロイするサイドカーコンテナを含むタスク定義の例をダウンロードします。
bash
$curl -O https://download.newrelic.com/infrastructure_agent/integrations/ecs/newrelic-infra-ecs-fargate-example-latest.json
ヒント
Gravitonの場合は、"cpuArchitecture": "X86_64"を"cpuArchitecture": "ARM64"に置き換えます。
このタスク定義のnewrelic-infraコンテナを、監視するタスク定義にサイドカーとして追加します。このタスク例では、アプリケーションのコンテナがプレースホルダーbusyboxコンテナを置き換えます。
重要
手動で編集したタスク定義のサイドカーコンテナ設定で、環境変数NRIA_IS_FORWARD_ONLYがtrueに設定されていることを確認してください。詳細な手順と完全なJSONの例については、CloudFormation Fargateセクションを参照してください。

完了したら、次の手順を参照してください。

このドキュメントはインストールの役に立ちましたか？

インストール後の次の手順

このインテグレーションをインストールした後：

数分待ってから、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起動タイプ向けに次を作成します。
- デーモンスケジューリング戦略とEC2起動タイプを使用して、登録されたタスクのサービスnewrelic-infraを作成します。
EXTERNAL（ECS Anywhere）起動タイプ向けに次を作成します。
- デーモンスケジューリング戦略とEXTERNAL（ECS Anywhere）起動タイプを使用して、登録されたタスクのサービスnewrelic-infra-externalを作成します。

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

インストールの概要 .css-21sua1{background:none;border:none;width:0;padding:0;}

インストールオプション

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

外部（ECS Anywhere）起動タイプ

AWS Fargate起動タイプ

自動スクリプトでインストールする

EC2起動タイプ

外部（ECS Anywhere）起動タイプ

AWS Fargate起動タイプ

ヒント

重要

手動インストール

EC2およびEXTERNAL（ECS Anywhere）起動タイプ

AWS Fargate起動タイプ

このドキュメントはインストールの役に立ちましたか？

インストール後の次の手順

作成されたAWSリソース

インストールの概要