• EnglishEspañol日本語한국어Português
  • ログイン今すぐ開始

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

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

インストールの概要

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

インストールオプション

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

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

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

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

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

    • New Relic

      を保存するシークレット

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

    • ライセンスキーへのアクセス権を持つ、ECSタスクExecutionRoleとして使用されるインスタンスロール

    • EC2および外部(ECS Anywhere)の起動タイプ:New Relic Infrastructure ECSインテグレーションタスクを登録する

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

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

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

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

  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. とクラスタ名を指定してインストーラーを実行します。

  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. ポリシーNewRelicSSMLicenseKeyReadAccessAmazonECSTaskExecutionRolePolicyをロールにアタッチします

    aws iam attach-role-policy \
    --role-name "NewRelicECSTaskExecutionRole" \
    --policy-arn "POLICY_ARN"
  6. 詳細な手順については、以下の起動タイプを選択してください

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

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

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

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

作成された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起動タイプの場合、以下も行われます

  • EXTERNAL(ECS Anywhere)起動タイプの場合、以下も行われます

    • デーモンスケジューリング戦略とEXTERNAL(ECS Anywhere)起動タイプを使用して、登録されたタスクのサービスnewrelic-infra-externalを作成します
Copyright © 2024 New Relic株式会社。

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