監視 Amazon Web Services ( AWS ) による Amazon Web Services ( AWS ) エージェント

エージェント AWS は Windows または Linux に EC2 インストールできます。 Instana AWS エージェントは、. Linux® NETを実行する現行世代汎用マシン上で実行することを推奨します。例えば、 m5.large インスタンスが理想的です。

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

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

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

   エージェントキーとロケーションはスクリプト内で事前に入力済みであり、 User Data として使用されます EC2。 表示されているスクリプトをコピーしてください。 スクリプトは以下の通りですが、必要な情報はすべて提供されています：

   #!/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として使用します。 詳細については、 Launch ドキュメントの「インスタンス Linux での User Data コマンドの実行 EC2 」を参照してください。

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

6. IAMロールがアクション AssumedRole を実行するには、以下のように Trust Relationship 編集します（Instana 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 リージョナル エンドポイントの設定」 を参照してください。

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

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

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

3. 「 エージェント AWS を実行する 」リストから、 Elastic Container Service (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 には追加コストは発生しません）。 両方の詳細については、 価格 CloudWatchAWS ページでご確認いただけます。

以下の表は、ポーリング間隔が5分、Amazonの課金単価が1000 CloudWatch メトリックあたり 0.01 $の場合における、各エージェント AWS のおおよその推定日次コストを示しています：

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

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

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

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

PrivateLinkAWS パブリックIPを使用する必要がなく、トラフィックがインターネットを経由する必要もない状態で、高可用性とスケーラビリティを AWS 備えた方法でホストされているサービスへのプライベートアクセスを提供します。

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