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. Run your AWS Agent on リストから、 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 ./setup_agent.sh -y -a <your-agent-key> -m aws -t dynamic -e <location> -s
   

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

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

6. IAMロールが AssumedRole 。 Trust Relationship を以下のように編集する：

   {
     "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. Run your AWS Agent on リストから、 Elastic Container Service (ECS) を選択します。

   タスク定義の JSON は、タスク定義 JSON テンプレートで自動的に生成されます。 JSONファイルをダウンロードし、タスク定義ユーザー・インターフェースの JSON機能を使って設定します。

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

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

AWS インフラストラクチャーの外部で実行されるすべてのエージェントを専用にすることもできます。 この目標を達成するには、 /opt/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 エージェントは、 GetMetricData CloudWatch メトリクス収集のためのAPIリクエストを呼び出し、それが失敗した場合は、 GetMetricStatistics がフォールバックとして呼び出される。 どちらのエンドポイントでも、メトリックスごとに同じコストが発生する（フォールバックの GetMetricStatistics の使用には追加コストは発生しないことに注意）。 どちらの詳細も、 AWS CloudWatch 価格ページでご覧いただけます。

以下の表は、ポーリング間隔が5分で、Amazonの料金が1000 CloudWatch メトリクスあたり$ 0.01 である場合の、異なる AWS エージェントの1日の概算コストです：

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

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

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

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

AWS PrivateLink は、パブリックIPを使用する必要がなく、トラフィックがインターネットを横断する必要もなく、可用性と拡張性の高い方法で AWS。

AWS PrivateLink, を使用するには、監視が必要なすべての AWS サービス用に VPC エンドポイントを作成します。 VPC エンドポイントは、Instana ホストエージェントが使用できる AWS サービス API に、プライベート IP アドレスを持つサブネット内のエラスティックネットワークインターフェースを提供します。