New Relic の ECS 統合は、Amazon ECS 環境からのパフォーマンス データをレポートおよび表示します。
インストールの概要
を インストールする前に、次の 2 つの起動タイプに対してインフラストラクチャ エージェント (newrelic-infra
) がどのようにデプロイされるかを概要を理解するのに役立ちます。
- EC2 および外部 (ECS Anywhere) 起動タイプ: エージェントは、デーモン スケジューリング戦略を使用してサービスとして ECS クラスターにデプロイされます (こちらの AWS ドキュメントで説明されています)。これにより、クラスターのすべての EC2 インスタンスにエージェントがインストールされ、ECS と Docker コンテナが監視されます。
- AWS Fargate 起動タイプ: 監視するすべてのタスクで、エージェントはサイドカーとしてデプロイされます。オプション: AWS がサイドカーを定義する方法について詳しく学びます。
インストールオプション
必要なインストールを選択します。
CloudFormationによるインストール
AWS CloudFormation を使用したインストールを支援するために、EC2、EXTERNAL (ECS Anywhere)、および AWS Fargate 起動タイプの AWS アカウントに ECS 統合をインストールするいくつかの CloudFormation テンプレートが提供されています。
CloudFormation を使用してインストールするには:
ECS 統合タスクを登録するには、 このスタックをデプロイします。スタックを目的のリージョンにデプロイしていることを確認してください。このスタックは次のリソースを作成します。
ニューレリックを保存する秘密
。
ライセンスキーにアクセスするためのポリシーです。
ECSタスク
ExecutionRole
として使用されるインスタンスロールで、ライセンスキーにアクセスできます。EC2 および外部 (ECS Anywhere) の起動タイプ: New Relic インフラストラクチャ ECS 統合タスクを登録します。
お客様のローンチタイプに応じた追加の指示に従ってください。
完了したら、 「次のステップ」を参照してください。
自動スクリプトによるインストール
インストールオプション の一つは、当社のインストールスクリプトを使用することです。自動インストールスクリプトを使用するには
ECSインテグレーションのインストーラーをダウンロードする。
curl -O https://download.newrelic.com/infrastructure_agent/integrations/ecs/newrelic-infra-ecs-installer.shインストーラーに実行権限を追加する。
chmod +x newrelic-infra-ecs-installer.sh-h
で実行して、ドキュメントと要件を確認します。./newrelic-infra-ecs-installer.sh -hAWSプロファイルがECSクラスターが作成されたのと同じリージョンを指していることを確認します。
$ aws configure get regionus-east-1$ aws ecs list-clustersYOUR_CLUSTER_ARNSarn:aws:ecs:us-east-1:YOUR_AWS_ACCOUNT:cluster/YOUR_CLUSTERを指定して、インストーラーを実行します。 およびクラスター名。
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
ツールを使用してこれを行う方法を説明します。
AWSプロファイルがECSクラスターが作成されたのと同じリージョンを指していることを確認します。
$ aws configure get regionus-east-1$ aws ecs list-clustersYOUR_CLUSTER_ARNSarn:aws:ecs:us-east-1:YOUR_AWS_ACCOUNT:cluster/YOUR_CLUSTERあなたの保存 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"ライセンスキーパラメーターにアクセスするための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"タスク実行ロールとして使用する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"ポリシー
NewRelicSSMLicenseKeyReadAccess
とAmazonECSTaskExecutionRolePolicy
をロールに添付します。aws iam attach-role-policy \--role-name "NewRelicECSTaskExecutionRole" \--policy-arn "POLICY_ARN"詳細については、ローンチタイプを選択してください。
完了したら、 「次のステップ」を参照してください。
このドキュメントはインストールで役立ちましたか。
インストール後の手順
この統合をインストールした後:
- 数分待ってから、 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
を作成します。
- デーモンスケジューリング戦略とEC2起動タイプを使用して、登録されたタスクのサービス
EXTERNAL (ECS Anywhere) 起動タイプ の場合も同様に行います。
- デーモンスケジューリング戦略とEXTERNAL(ECS Anywhere)起動タイプを使用して、登録されたタスクのサービス
newrelic-infra-external
を作成します。
- デーモンスケジューリング戦略とEXTERNAL(ECS Anywhere)起動タイプを使用して、登録されたタスクのサービス