Amazon Web Services (AWS) エージェントを使用した Amazon Web Services (AWS) のモニター

「 AWS 」エージェントは、 Windows または Linux から EC2 にインストールできます。 Instana AWS エージェントは、 Linux® を実行している現行世代の汎用マシン上で実行することをお勧めします。例えば、 m5.large インスタンスが理想的です。

1. Instana のUIで、 「詳細 」> 「エージェント 」> 「エージェントのインストール 」>「 AWS 」をクリックします。

2. 「テクノロジー」リストから、「Instana AWS センサー」を選択します。

3. 「 AWS エージェントを実行する 」リストから、 「 Elastic Cloud Compute ( EC2 ) 」を選択します（これがデフォルトです）。

   エージェントの鍵と場所は、 EC2上で User Data として使用されるスクリプトに事前に取り込まれます。 表示されているスクリプトをコピーします。 スクリプトは以下のようになりますが、必要な情報がすべて提供されている点が異なります。

   #!/bin/bash
   
   curl -o setup_agent.sh https://setup.instana.io/agent
   chmod 700 ./setup_agent.sh
   sudo -E ./setup_agent.sh -y -a <your-agent-key> -m aws -t dynamic -e <location> -s
    

4. 専用の EC2 仮想マシンをスピンアップし、コピーしたスクリプトを User Dataとして使用します。 EC2 での User Data 使用方法の詳細については、 Launch のドキュメントにある「 Linux インスタンスでのコマンドの実行」を参照してください。

5. 「IAM 役割」 トピックのコード・ブロック内の構成を IAM_permission.json ファイルにコピーします。 これらの設定は、 Instana AWS エージェントを実行する EC2 仮想マシンに必要なIAMロールに使用され、 AWS エージェントが AWS リソースを検出および監視できるようにします。 次に、 IAM_permission.json ファイルを使用して IAM 役割を作成します。 詳細については、 「IAM ユーザーに権限を委任するためのロールの作成」 を参照してください。

6. IAMロールがアクション AssumedRole を実行できるようにするには、以下のように（ Trust RelationshipInstana のUIでは trust_relationship.json 「」として表示されます）を編集してください：

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "ec2.amazonaws.com"
         },
         "Action": "sts:AssumeRole"
       }
     ]
   }
    

   エージェントがインターネットに接続できない EC2 マシン上で実行される場合は、次 Trust Relationship のように編集してください：

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "ec2.amazonaws.com.cn"
         },
         "Action": "sts:AssumeRole"
       }
     ]
   }
    

   その他の必要な設定については、 「STSリージョンエンドポイントの設定」 を参照してください。

ECS上のFargateで、 Windows または Linux に AWS エージェントをインストールできます。

1. Instana のUIで、 「詳細 」> 「エージェント 」> 「エージェントのインストール 」>「 AWS 」をクリックします。

2. 「テクノロジー」リストから、「Instana AWS センサー」を選択します。

3. AWS エージェントを以下の場所で実行します。 リストから、 エラスティック・コンテナー・サービス (ECS)を選択します。

   タスク定義の JSON は、タスク定義 JSON テンプレートで自動的に生成されます。 JSON ファイルをダウンロードし、タスク定義のユーザーインターフェースにある 「 JSON 」関数を使用して設定を行ってください。

4. IAM権限のJSON ファイルをダウンロードし、新しいタスク定義に対して、ダウンロードした JSON ファイルに記載されている権限を少なくとも含むIAMロールを割り当ててください。

5. 新しく作成したタスク定義のインスタンスを 1 つ持つ ECS サービスを作成します。

AWS インフラストラクチャーの外部で実行されるすべてのエージェントを専用にすることもできます。 この目標を達成するには、 setenv ファイル内に以下の環境変数を指定する必要があります。

• Linux の場合:

  /opt/instana/agent/bin/setenv

• Windows の場合:

  C:\Program Files\Instana\instana-agent\bin\setenv

• モニター対象の地域:

  INSTANA_AWS_REGION_CONFIG=

• AWS リソースにアクセスするための資格情報。 これらの資格情報は、 Amazon Web Services IAM の構成 セクションで既に説明されているリソースへのアクセスが許可されているユーザーに属している必要があります。

  AWS_ACCESS_KEY_ID=
  AWS_SECRET_ACCESS_KEY=

デフォルトでは、Instana エージェントは、 EC2 インスタンスからグローバル STS エンドポイントに接続して、インスタンス・プロファイル資格情報を収集します。 ただし、 Instana ホストエージェントがインターネットに接続できない EC2 マシン（例えば、中国地域など）上で実行される場合、STSリージョンのエンドポイントを環境変数として指定する必要があります。これにより、 Instana エージェントはリージョンのSTSエンドポイントを使用するようになります。

Instana エージェントがインストールされたら、*instanaAgentDir*/bin/setenv内で以下の環境変数を指定します。

export AWS_STS_REGIONAL_ENDPOINTS=regional
 

サービスごとに、モニター対象サービス セクションからリンクされた個々のサービス・ページに必要な許可を追加する必要があります。 サービスをモニター対象から除外するには、それぞれのアクセス許可を除外します。

あるいは、以下の個々のサービス・ページで説明されているように、モニター対象からサービスを除外する別の方法として、<agent_install_dir>/etc/instana/configuration.ymlに適切な-enabled_ フラグを追加することもできます。

AWS Instana エージェントは、同じリージョン内の複数の AWS アカウントのモニタリング・サービスをサポートしています。 現在、AWS 名前付きプロファイルを使用する方法と、AWS セキュリティー・トークン・サービス (STS) を使用する方法の 2 つの方法があります。

サービスのモニターを有効にした後、AWS エージェントのエージェント構成ファイル /opt/instana/agent/etc/instana/configuration.yaml を変更することで、Instana が AWS タグに基づいてモニターするインスタンスをフィルタリングすることができます。

構成ファイルで使用可能なオプションは、以下のとおりです。

com.instana.plugin.aws:
  # Comma-separated list of tags in key:value format.
  # Any AWS resource containing at least one of the specified tags is discovered.
  include_tags: ...
  # Comma-separated list of tags in key:value format.
  # Any AWS resource containing at least one of the specified tags is omitted from discovery.
  exclude_tags: ...
  # Exclude untagged AWS resources by setting the flag to `false`
  include_untagged: ...
 

複数のタグを定義するには、コンマで区切ります。 タグは、 :で区切られたキーと値のペアでなければなりません。 両方のリスト (包含と除外) にタグを定義すると、除外リストの優先順位が高くなります。 サービスをフィルタリングする必要がない場合は、構成を定義しないでください。

Instana エージェントは、タグが割り当てられていないすべての AWS リソースを自動的に監視します。 {: note} タグのないリソースを監視対象から除外するには、フラグ include_untagged を に設定してください false。

フィルタリングをサービス・レベルで構成することもできます。 この場合、特定のサービスのデフォルト構成はオーバーライドされます。 特定のサービスによるディスカバリー・フィルタリングについて詳しくは、特定のサービスの資料を参照してください。

AWS エージェントがモニター対象 AWS サービスをポーリングして関連タグを取得する頻度を指定するには、 tagged-services-poll-rate 構成プロパティーを使用します。 デフォルトは 300 秒です。 エージェントは、 AWS サービス・クライアントを使用してタグをポーリングします。

タグ付きリソースのポーリング頻度の構成は、以下のとおりです。

com.instana.plugin.aws:
  tagged-services-poll-rate: 60 #default 300
 

ポーリング間隔は、 AWS エージェントが CloudWatch の API を呼び出す頻度を示します。 これは、 configuration.yml ファイル内で cloudwatch_period として構成可能です。 デフォルト値は 300 秒です。 最も一般的なのは、モニター・プラットフォームが 5 分から 10 分の値を使用することです。

ポーリング間隔は、以下の 2 つのレベルで構成可能です。

• エージェントによってモニターされるすべての AWS サービスのエージェント・レベル

  com.instana.plugin.aws:
    cloudwatch_period: 300
   

• AWS サービス当たり

  com.instana.plugin.aws.rds:
    cloudwatch_period: 300
   

単一サービスの構成は、エージェント・レベルの構成をオーバーライドします。

AWS サービスに対する洞察を提供するには、Instana などのモニタリング・プラットフォームで CloudWatch API を使用する必要があります。 この API は、AWS によって消費量ベースの価格設定と共に提供されます。この資料の目的は、Instana が CloudWatch API を使用して AWS 請求への影響をユーザーが理解する方法を透過的に示すことです。

CloudWatch のコストは、以下の要因に影響を受けます。

• AWS サービスのモニター対象インスタンスの数
• AWS エージェントごとに収集されるメトリックの数
• ポーリング間隔 (構成可能)

各 AWS エージェントは、メトリクスの収集のために CloudWatchGetMetricData API リクエストを呼び出し、それが失敗した場合は代替 GetMetricStatistics 手段としてが呼び出されます。 どちらのエンドポイントも、メトリクスあたりのコストは同じです（なお、のフォールバック利用 GetMetricStatistics には追加コストは発生しません）。 両製品の詳細については、 AWS の CloudWatch 価格ページをご覧ください。

以下の表は、ポーリング間隔が 5 分で、Amazon の課金が 1000 CloudWatch メトリックごとに $0.01 である場合の、さまざまな AWS エージェントの日次コストの概算を示しています。

CloudWatch は EC2 およびポーリング・タグでは使用されないため、CloudWatch のコストは発生しないことに注意してください。

ポーリング間隔を長くすると CloudWatch のコストを削減できます。 ポーリング間隔を増やすことの欠点は、CloudWatch からの細分度メトリックを減らすことです。 各要求は単一のメトリック値を提供するため、60s と 300s のポーリング間隔の違いは、300s 期間の 5 つのメトリック値または 1 つのメトリック値です。

デフォルトのポーリング間隔がお客様のビジネスに適しているかどうか、またはコストと洞察の品質のバランスを取るようにカスタマイズするかどうかは、お客様が判断する必要があります。

Instana のホストエージェントが、インターネットに接続されていない EC2 マシン上で実行されている場合、エージェントは AWS サービスのパブリックAPIにアクセスできなくなり、その結果、サポートされている AWS サービスの監視に失敗します。

AWS PrivateLink AWS 上でホストされているサービスへのプライベートなアクセスを、高い可用性と拡張性を確保した形で提供します。これにはパブリックIPアドレスの使用が不要であり、トラフィックがインターネットを経由する必要もありません。

AWS PrivateLink を使用するには、監視が必要なすべての AWS サービスに対して VPC エンドポイントを作成してください。 VPCエンドポイントは、サブネット内にプライベートIPアドレスを持つElastic Network Interfaceを提供し、これを介して「 AWS 」サービス（ API ）に接続します。このインターフェースは、「 Instana 」ホストエージェントから利用可能です。