Amazon ECS上で動作するサービスの監視

Amazon ECS の Docker コンテナ上で実行され、 サポートされているサービスがある場合は、ECS 統合を通じてそれらの統合を有効にすることができます。これにより、監視対象サービス、ホスト、コンテナーからのデータがレポートされます。

要件

ECS上で動作しているサービスをモニターするには、以下の要件を満たす必要があります。

• 要件を満たす ECS 上で実行されるサポート対象サービス。サポートされているサービスは次のとおりです。

  • Apache
  • カサンドラ
  • Couchbase
  • Elasticsearch
  • HAProxy
  • HashiCorp領事
  • JMX
  • カフカ
  • Memcached
  • MongoDB
  • MySQL
  • NGINX
  • PostgreSQL
  • RabbitMQ
  • Redis

• インフラストラクチャ エージェントの互換性と要件 を満たす、Amazon Linux、CentOS、または RHEL を実行する 自動スケーリング ECS クラスター。

• ECSタスクでは、 ネットワークモードをnoneまたはbridgeに設定する必要があります（ awsvpcおよびhostはサポートされていません）。

制限事項:

• このインストール方法では、RabbitMQ と Apache の統合はインベントリ データを報告しません。
• AWSファーゲートはサポートされていません。

有効にする方法

ECSで動作しているサービスのモニタリングを有効にする方法を説明する前に、その概要を説明します。

1. Amazon EC2を有効にする ECSクラスターに当社のインフラストラクチャエージェントをインストールします。
2. サービス固有の設定ファイルを使用して、サービス の監視を可能にします。

ステップ1： EC2にインフラストラクチャ・エージェントをインストールできるようにする

まず、Amazon EC2がECSクラスターに当社のインフラストラクチャ・エージェントをインストールできるようにする必要があります。これを行うには、まず起動時にインフラストラクチャ・エージェントをインストールするために、ユーザー・データを更新する必要があります。

以下は、EC2の起動設定を変更するための手順です（Amazon EC2ドキュメント から引用）。

2. Amazon EC2 コンソールを開く.

3. ナビゲーション ペインのAuto scalingの下で、 Launch configurationsを選択します。

4. 次のページでは、アップデートしたいローンチ構成を選択します。

5. 右クリックしてCopy launch configurationを選択します。

6. Launch configuration detailsタブで、 Edit detailsをクリックします。

7. ユーザーデータを以下のいずれかのスニペットに置き換える。

   CentOS 6、RHEL 6、Amazon Linux 1の場合

   ハイライトされたフィールドを適切な値に置き換えてください。

   Content-Type: multipart/mixed; boundary="MIMEBOUNDARY"
   MIME-Version: 1.0
   
   --MIMEBOUNDARY
   Content-Disposition: attachment; filename="init.cfg"
   Content-Transfer-Encoding: 7bit
   Content-Type: text/cloud-config
   Mime-Version: 1.0
   
   yum_repos:
       newrelic-infra:
           baseurl: https://download.newrelic.com/infrastructure_agent/linux/yum/el/6/x86_64
           gpgkey: https://download.newrelic.com/infrastructure_agent/gpg/newrelic-infra.gpg
           gpgcheck: 1
           repo_gpgcheck: 1
           enabled: true
           name: New Relic Infrastructure
   write_files:
   -   content: |
           ---
           # New Relic config file
           license_key: YOUR_LICENSE_KEY
       path: /etc/newrelic-infra.yml
   packages:
     - newrelic-infra
     - nri-*
   runcmd:
     - [ yum, install, newrelic-infra, -y ]
     - [ systemctl, daemon-reload ]
     - [ systemctl, enable, newrelic-infra.service ]
     - [ systemctl, start, --no-block, newrelic-infra.service ]
   
   --MIMEBOUNDARY
   Content-Transfer-Encoding: 7bit
   Content-Type: text/x-shellscript
   Mime-Version: 1.0
   
   #!/bin/bash
   
   # ECS config
   {
     echo "ECS_CLUSTER=YOUR_CLUSTER_NAME"
   } >> /etc/ecs/ecs.config
   
   start ecs
   
   echo "Done"
   --MIMEBOUNDARY--

   コピー

   CentOS 7、RHEL 7

   ハイライトされたフィールドを適切な値に置き換えてください。

   Content-Type: multipart/mixed; boundary="MIMEBOUNDARY"
   MIME-Version: 1.0
   
   --MIMEBOUNDARY
   Content-Disposition: attachment; filename="init.cfg"
   Content-Transfer-Encoding: 7bit
   Content-Type: text/cloud-config
   Mime-Version: 1.0
   
   yum_repos:
       newrelic-infra:
           baseurl: https://download.newrelic.com/infrastructure_agent/linux/yum/el/7/x86_64
           gpgkey: https://download.newrelic.com/infrastructure_agent/gpg/newrelic-infra.gpg
           gpgcheck: 1
           repo_gpgcheck: 1
           enabled: true
           name: New Relic Infrastructure
   write_files:
   -   content: |
           ---
           # New Relic config file
           license_key: YOUR_LICENSE_KEY
       path: /etc/newrelic-infra.yml
   packages:
     - newrelic-infra
     - nri-*
   runcmd:
     - [ yum, install, newrelic-infra, -y ]
     - [ systemctl, daemon-reload ]
     - [ systemctl, enable, newrelic-infra.service ]
     - [ systemctl, start, --no-block, newrelic-infra.service ]
   
   --MIMEBOUNDARY
   Content-Transfer-Encoding: 7bit
   Content-Type: text/x-shellscript
   Mime-Version: 1.0
   
   #!/bin/bash
   
   # ECS config
   {
     echo "ECS_CLUSTER=YOUR_ECS_CLUSTER_NAME"
   } >> /etc/ecs/ecs.config
   
   start ecs
   
   echo "Done"
   --MIMEBOUNDARY--

   コピー

   Amazon Linux 2

   ハイライトされたフィールドを適切な値に置き換えてください。

   Content-Type: multipart/mixed; boundary="MIMEBOUNDARY"
   MIME-Version: 1.0
   
   --MIMEBOUNDARY
   Content-Disposition: attachment; filename="init.cfg"
   Content-Transfer-Encoding: 7bit
   Content-Type: text/cloud-config
   Mime-Version: 1.0
   
   yum_repos:
       newrelic-infra:
           baseurl: https://download.newrelic.com/infrastructure_agent/linux/yum/amazonlinux/2/x86_64
           gpgkey: https://download.newrelic.com/infrastructure_agent/gpg/newrelic-infra.gpg
           gpgcheck: 1
           repo_gpgcheck: 1
           enabled: true
           name: New Relic Infrastructure
   write_files:
   -   content: |
           ---
           # New Relic config file
           license_key: YOUR_LICENSE_KEY
       path: /etc/newrelic-infra.yml
   packages:
     - newrelic-infra
     - nri-*
   runcmd:
     - [ yum, install, newrelic-infra, -y ]
     - [ systemctl, daemon-reload ]
     - [ systemctl, enable, newrelic-infra.service ]
     - [ systemctl, start, --no-block, newrelic-infra.service ]
   
   --MIMEBOUNDARY
   Content-Transfer-Encoding: 7bit
   Content-Type: text/x-shellscript
   Mime-Version: 1.0
   
   #!/bin/bash
   
   # ECS config
   {
     echo "ECS_CLUSTER=YOUR_ECS_CLUSTER_NAME"
   } >> /etc/ecs/ecs.config
   
   start ecs
   
   echo "Done"
   --MIMEBOUNDARY--

   コピー

8. Skip to reviewを選択します。

9. Create launch configurationを選択します。

次に、オートスケーリンググループの更新を行います。

1. Amazon EC2 コンソールを開く.

2. ナビゲーション ペインの

   Auto scaling

   の下で、

   Auto scaling groups

   を選択します。

3. 更新したいオートスケーリンググループを選択します。

4. Actions

   メニューから

   Edit

   を選択します。

5. Launch configuration

   のドロップダウン メニューで、作成された新しいリリース設定を選択します。

6. Save

   をクリックします。

エージェントがインスタンスを自動的に検出しているかどうかをテストするには、Auto Scaling グループ内のEC2 インスタンスを終了します 。これで、置換インスタンスが新しいユーザー データで起動されます。5 分後、 [ホスト] ページに新しいホストからのデータが表示されます。

次に、サービスの監視を可能にすることに移ります。

ステップ2：サービスの監視を有効にする

EC2がインフラストラクチャエージェントを実行できるようにすると 、エージェントはホスト上で実行されているコンテナの監視を開始します。

次に、ECSにデプロイされたサービスを監視する方法について説明します。例えば、アプリケーション・サーバーの前に配置されたNGINXインスタンスを含むECSタスクを監視することができます。

ここでは、ECS上に展開された サポートされているサービス をどのようにモニターするかについて簡単に説明します。

1. 監視するサービスのYAML構成ファイルを作成します。これは最終的に、AWSコンソールを介してEC2ユーザーデータセクションに配置されます。ただし、その前に、EC2のインフラストラクチャエージェントフォルダー（ etc/newrelic-infra/integrations.d ）にそのファイルを配置することで、設定が機能していることをテストできます。その構成ファイルは、コンテナーの自動検出形式を使用する必要があります。これにより、コンテナーを自動的に検索できます。正確な構成オプションは、特定の統合によって異なります。
2. サービスからのデータがNew Relicに報告されていることを確認します。
3. 表示されたデータに満足したら、EC2コンソールを使用して、その設定を適切な起動設定のwrite_filesセクションに追加し、自動スケーリンググループを更新できます。
4. runcmdセクションで、 yumコマンドを追加して、適切な起動構成に統合をインストールします。

ここでは、NGINXで上記の手順を行う詳細な例を示します。

1. サーバーへのSSHアクセス、または AWS Systems Manager Session Manager へのアクセスがあることを確認してください。インフラストラクチャエージェントを実行しているホストにログインします。

2. コマンドラインで、ディレクトリをintegrations configurationフォルダに変更します。

   bash

   コピー

   $
   cd /etc/newrelic-infra/integrations.d

3. nginx-config.ymlというファイルを作成し、次のスニペットを追加します。

   ---
   discovery:
     docker:
       match:
         image: /nginx/
   integrations:
     - name: nri-nginx
       env:
         STATUS_URL: http://${'${discovery.ip}'}:/status
         REMOTE_MONITORING: true
         METRICS: 1

   コピー

   この構成により、インフラストラクチャエージェントはnginxを含むECS内のコンテナを検索します。コンテナが一致すると、NGINXステータスページに接続します。discovery.ipスニペットの動作の詳細については、自動検出を参照してください。一般的なNGINX構成の詳細については、 NGINX統合を参照してください。

4. NGINX ステータス ページがポート 80 のSTATUS_URLからのリクエストを処理するように設定されている場合、インフラストラクチャ エージェントはそれを監視し始めます。 5 分後、NGINX データがインフラストラクチャ UI ( one.newrelic.com > All capabilities > Infrastructure > Third party servicesまたはone.newrelic.com > All capabilities > Infrastructure > Third-party services ) に表示されていることを確認します。

5. 設定がうまくいったら、EC2の起動設定に入れます。

   1. Amazon EC2 コンソールを開く.

   2. ナビゲーション ペインのAuto scalingの下で、 Launch configurationsを選択します。

   3. 次のページでは、アップデートしたいローンチ構成を選択します。

   4. 右クリックしてCopy launch configurationを選択します。

   5. Launch configuration detailsタブで、 Edit detailsをクリックします。

   6. User dataセクションで、 write_filesセクション ( text/cloud-configでマークされた部分) を編集します。

   7. 新しいファイル/コンテンツのエントリーを追加します。

      -   content: |
          ---
          discovery:
            docker:
              match:
                image: /nginx/
          integrations:
            - name: nri-nginx
              env:
                STATUS_URL: http://${'${discovery.ip}'}:/status
                REMOTE_MONITORING: true
                METRICS: 1
          path: /etc/newrelic-infra/integrations.d/nginx-config.yml

      コピー

   8. また、 runcmdセクションを編集してyumコマンドを含めてnri-nginxをインストールします。

      runcmd:
        - [ yum, install, newrelic-infra, -y ]
        - [ yum, install, nri-nginx, -y ]
        - [ systemctl, daemon-reload ]
        - [ systemctl, enable, newrelic-infra.service ]
        - [ systemctl, start, --no-block, newrelic-infra.service ]

      コピー

6. Skip to reviewを選択します。

7. Create launch configurationを選択します。

8. 次に、オートスケーリンググループの更新を行います。

   1. Amazon EC2 コンソールを開く.

   2. ナビゲーション ペインの

      Auto scaling

      の下で、

      Auto scaling groups

      を選択します。

   3. 更新したいオートスケーリンググループを選択します。

   4. Actions

      メニューから

      Edit

      を選択します。

   5. Launch configuration

      のドロップダウン メニューで、作成された新しいリリース設定を選択します。

   6. Save

      をクリックします。

EC2 インスタンスが終了すると、新しい NGINX コンテナを自動的に検索する新しいインスタンスに置き換えられます。