AWS Elastic Beanstalk上でのインフラストラクチャエージェントの設定

Amazon Web Services (AWS) Elastic Beanstalk は、アプリケーションの簡単なデプロイメントとスケーラビリティを可能にするダイナミックなサービスです。以下の手順で、インフラストラクチャエージェントを、AWS Elastic Beanstalkアプリケーションで起動したインスタンスにデプロイします。

インフラストラクチャエージェントのデプロイに加えて、New RelicとAWSを統合し、Elastic Beanstalkの監視情報をNew Relicに取り込むこともできます。まだ行っていない場合は、 Amazon インテグレーションとインフラストラクチャ モニタリング の指示に従ってください。

要件

サポートされているアマゾン ウェブ サービス アカウントがあることを確認してください。 さらに、 New Relicインストレーションには、ライセンスキー が必要です。 これは、アカウントにサインアップするときに New Relic が提供する 40 文字の 16 進文字列です。

インフラストラクチャエージェントをインストールします

AWS Elastic Beanstalkで起動したインスタンスにインフラストラクチャエージェントをインストールするには、以下の手順に従います。

1. Elastic BeanStalkアプリケーション内の.ebextensionsフォルダーに、 newrelic.configという名前の新しいファイルを作成します。

2. オペレーティング システムに基づいて、次の内容をファイルに追加します。

   • YOUR_LICENSE_KEYを New Relic ライセンスキーに置き換えます。

   • ARM (Graviton) で実行する場合は、 x86_64 を aarch64 に置き換えます。

     Amazon Linux 2

     files:
       "/etc/newrelic-infra.yml":
         mode: "000644"
         owner: root
         group: root
         content: |
           license_key: YOUR_LICENSE_KEY
     
     commands:
       # Create the agent’s yum repository
       "01-agent-repository":
         command: sudo curl -o /etc/yum.repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/yum/amazonlinux/2/x86_64/newrelic-infra.repo
       #
       # Update your yum cache
       "02-update-yum-cache":
         command: yum -q makecache -y --disablerepo='*' --enablerepo='newrelic-infra'
       #
       # Run the installation script
       "03-run-installation-script":
         command: sudo yum install newrelic-infra -y

     コピー

     Amazon Linux 2023

     files:
       "/etc/newrelic-infra.yml":
         mode: "000644"
         owner: root
         group: root
         content: |
           license_key: YOUR_LICENSE_KEY
     
     commands:
       # Create the agent’s yum repository
       "01-agent-repository":
         command: sudo curl -o /etc/yum.repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/yum/amazonlinux/2023/x86_64/newrelic-infra.repo
       #
       # Update your yum cache
       "02-update-yum-cache":
         command: yum -q makecache -y --disablerepo='*' --enablerepo='newrelic-infra'
       #
       # Run the installation script
       "03-run-installation-script":
         command: sudo yum install newrelic-infra -y

     コピー

     ウィンドウズ

     packages:
       msi:
         infrastructure: https://download.newrelic.com/infrastructure_agent/windows/newrelic-infra.msi
     files:
       "C:\\Program Files\\New Relic\\newrelic-infra\\newrelic-infra.yml":
         content: |
           license_key: YOUR_LICENSE_KEY
     commands:
       01_stop-newrelic-infra:
         command: net stop newrelic-infra
         ignoreErrors: true
       02_start-newrelic-infra:
         command: net start newrelic-infra
         ignoreErrors: true

     コピー

3. 作成したアプリをElastic BeanStalkにプッシュします。

   • 通常、 eb deployを使用します。
   • まだEbCLI2.6を使用している場合は、必要に応じてgit aws.pushを使用してください。
   • オプションです。AWS コンソール UI を使用します。

セットアップが成功した後、New Relic にメトリクスが表示され始めるまでに最大 15 分かかる場合があります。 ホストのインフラストラクチャ ページをone.newrelic.comで表示します。

インフラストラクチャエージェントを構成する

インフラストラクチャ エージェントを構成するには、エージェント構成ファイルを調整するか、環境変数を使用して要件に基づいてエージェント設定を決定します。設定は、以下のいずれかの方法を使用して適用できます。

• ファイル内の設定: 追加のエージェント設定を使用して、 .ebextensionsフォルダー内のnewrelic.configファイルを編集します。設定は、 newrelic-infra.ymlファイルの内容に含まれている必要があります。
• 環境変数の設定: Elastic Beanstalk UI、API、または CLI を介して必要なNRIA_*環境変数を定義します。newrelic.configファイルのoption_settingsを使用してそれらを定義することもできます。詳細については、 AWS Beanstalk のドキュメントを参照してください。

インフラストラクチャ・エージェントのアンインストール

エージェントをアンインストールするには、次の構成で.ebextensions からnewrelic.configを更新してから、デプロイメントを更新します。

commands:
  # Remove agent configuration file
  "04-agent-remove-config":
    command: sudo rm /etc/newrelic-infra.yml
  #
  # Uninstall infra agent
  "05-agent-uninstall":
    command: sudo yum remove newrelic-infra -y

commands:
  03_uninstall-newrelic-infra:
    command: wmic product where name="New Relic Infrastructure Agent" call uninstall
    ignoreErrors: true