AWS Beanstalk のモニター

「 Instana 」の「 AWS 」センサーを使用すると、 AWS Beanstalk サービスを監視し、Webアプリケーションのパフォーマンスや状態に関する詳細情報を把握することができます。

Instana AWS エージェントをインストールすると、 AWS Beanstalk センサーが自動的に展開およびインストールされます。 Beanstalkインスタンスを監視するには、 AWS コンソールで拡張モニタリングを有効にし、環境設定で必要なメトリクスを選択してください。 その後、 Instana のUIでBeanstalkのメトリクスを確認できます。

その他のサポート対象の AWS サービスに関する詳細については、『 AWS 』のドキュメントを参照してください。

監視の前提条件

以下の前提条件が満たされていることを確認してください。

  • Instana AWS エージェントがインストールされました。 詳細については、 「 AWS エージェントのインストール」 を参照してください。
  • AWS コンソールで拡張モニタリングが有効になっています。
  • 必要なメトリクスは環境設定で選択します。

監視の設定

AWS エージェントをインストールすると、 AWS Beanstalk センサーが自動的に展開およびインストールされます。 AWS Beanstalk のインスタンスを監視するには、以下の手順を実行する必要があります:

  1. 必要なIAM権限を追加する
  2. オプション: AWS Beanstalk センサーを設定する

これらの手順を完了すると、 Instana のUIでメトリクスを確認できるようになります。 詳細については、 「メトリクスの表示」 を参照してください。

必要なIAM権限の追加

AWS Beanstalk 環境を監視するには、IAMロールの設定に以下の権限を追加してください。 詳細については、 「Amazon Web Services(AWS)のIAM設定」 を参照してください。

  • cloudwatch:GetMetricStatistics
  • cloudwatch:GetMetricData
  • elasticbeanstalk:DescribeEnvironments
  • elasticbeanstalk:ListTagsForResource
  • elasticbeanstalk:DescribeInstancesHealth

これらの権限により、 Instana AWS エージェントは、 AWS のリソースを検出および監視できるようになります。

オプション: AWS Beanstalk センサーの設定

Instana エージェントのインストールと必要な権限の付与が完了すると、 AWS Beanstalk センサーはデフォルトで有効になります。 センサーは、 AWS Beanstalk の環境およびインスタンスからメトリクスの収集を開始します。 監視機能を強化するために、以下の設定を変更できます:

メトリクスの収集間隔の設定

Beanstalk インスタンスは 60 秒ごとに最新表示されます。 検出は非同期で行われるため、 Instana のUIにおけるインスタンスメトリクスの表示に遅延が生じる場合があります。 この遅延は、エージェントの設定ファイルで指定されたポーリングレート (cloudwatch_period) によって決まります。

デフォルトでは、 AWS Beanstalk センサーは60秒ごとにインスタンスのメトリクスを取得し、 Instana ダッシュボードに表示します。 この設定を変更するには、エージェントの設定YAMLファイル内の設定 cloudwatch_period パラメータの値 /opt/instana/agent/etc/instana/configuration.ymlを変更してください:

com.instana.plugin.aws.beanstalk:
  cloudwatch_period: 60

プロキシ設定の設定

プロキシー構成を使用するように特定の AWS センサーを構成するには、以下のエージェント構成設定を追加します。

com.instana.plugin.aws.beanstalk:
  proxy_host: 'example.com' # proxy host name or ip address
  proxy_port: 3128 # proxy port
  proxy_protocol: 'HTTP' # proxy protocol: HTTP or HTTPS
  proxy_username: 'username' # OPTIONAL: proxy username
  proxy_password: 'password' # OPTIONAL: proxy password

複数の AWS アカウントにまたがる AWS Beanstalk 環境の監視

複数の AWS アカウントにまたがるBeanstalk環境を監視するために、どのプロファイルまたはロールを使用する必要があるかを設定する必要があります。

同じリージョン内の1つの AWS エージェントで複数の AWS アカウントの監視を設定する方法の詳細については、「 複数の AWS アカウントの監視」 を参照してください。

AWS 名前付きプロファイルを使用する方法

Beanstalkの監視に使用するプロファイルを上書きするには、 AWS エージェントが使用するプロファイルを以下のように追加します:

com.instana.plugin.aws.beanstalk:
  profile_names:
    - 'profile2'
    - 'profile3'
注: サービスレベルでプロファイルを定義すると、 AWS のプロファイルに関するグローバル設定が上書きされます。
AWS STS を使用する方法

Beanstalkの監視に使用するIAMロールを上書きするには、追加の AWS アカウントすべてのIAMロールのARNを指定してください:

com.instana.plugin.aws.beanstalk:
  role_arns:
    - 'arn:aws:iam::<account_1_id>:role/<role_2_name>'
    - 'arn:aws:iam::<account_2_id>:role/<role_3_name>'
注: サービスレベルでIAMロールを定義すると、グローバルな AWS のIAMロール設定が上書きされます。

監視対象の AWS Beanstalk インスタンスのフィルタリング

AWS Beanstalk センサーを有効にすると、デフォルトで AWS Beanstalk のすべてのインスタンスが監視されます。 ただし、 AWS タグに基づいて、センサーが検出および監視すべき AWS Beanstalk インスタンスをフィルタリングすることができます。 フィルタリングを設定するには、 AWS/opt/instana/agent/etc/instana/configuration.yamlのエージェント設定ファイルを変更してください。

複数のタグを定義するには、コンマで区切ります。 タグは、コロン(:)で区切られたキーと値のペアとして指定する必要があります。設定を簡単にするために、ディスカバリの対象に含めるタグや除外するタグを定義することができます。 「含める」リストと「除外する」リストの両方に同じタグを定義した場合、「除外する」リストが優先されます。 フィルタリングサービスが必要ない場合は、設定を行わないでください。 フィルタリングを有効にするためにすべての値を定義することは必須ではありません。

`configuration tagged-services-poll-rate ` プロパティを使用する ` AWS ` タグ付きリソースに対して、センサーがポーリングを行う間隔を指定できます(デフォルトは 300 秒)。 詳細については、 「ポーリング頻度の変更」 を参照してください。

注: タグは、AWS エージェントでのみ使用可能です。

指定されたタグを持つBeanstalkインスタンスをディスカバリーに含めるには、以下の設定にそれらのタグを追加してください:

com.instana.plugin.aws.beanstalk:
  include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)

指定したタグを持つBeanstalkインスタンスをディスカバリから除外するには、以下の設定にそれらのタグを追加してください:

com.instana.plugin.aws.beanstalk:
  exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

タグのないBeanstalkインスタンスはデフォルトで監視対象となりますが、フィールド include_untagged を に設定することで除外することができます false

com.instana.plugin.aws.beanstalk:
  include_untagged: false # True value by default

ポーリング頻度の変更

センサーがタグ付けされたリソースをポーリングする頻度を定義するには、以下の設定で tagged-services-poll-rate を変更してください:

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

メトリクスと設定データの確認

指標を確認するには、以下の手順に従ってください:

  1. Instana のUIにあるナビゲーションメニューから、 「インフラストラクチャ」 をクリックします。
  2. 指定されたホストをクリックしてください。

収集されたすべてのメトリクスと監視対象のプロセスが表示されたホストダッシュボードを確認できます。

追跡された構成データ

AWS Beanstalk センサーは、以下の設定データを収集します:

環境の詳細

このセンサーは、以下の環境情報を追跡します:

  • アプリケーション名
  • 環境 ID
  • 環境名
  • 環境記述
  • 環境 ARN
  • 環境の状況
  • 作成日
  • バージョン・ラベル
  • ソリューション・スタック
  • 環境 URL
  • アプリケーション名
  • アプリケーション名
  • アプリケーション名
  • グループ化ゾーン (リージョン)

インスタンスの詳細

このセンサーは、以下のインスタンスの詳細を追跡します:

  • インスタンス ID
  • インスタンス状況
  • インスタンス・タイプ
  • インスタンス開始日

メトリック

AWS Beanstalk センサーは、以下のメトリクスを収集します:

環境メトリック

次の表は、センサーが収集する環境メトリクスを示しています:

名前 説明
EnvironmentHealth 7 つの状況のいずれかとして表される環境の正常性      
InstancesOk 環境内の OK 状況のインスタンスの数    
InstancesInfo 環境内の情報状況のインスタンスの数
InstancesUnknown 環境内の Unknown 状況のインスタンスの数           
InstancesNoData 環境内の NoData 状況のインスタンスの数     
InstancesWarning 環境内の Warning 状況のインスタンスの数     
InstancesDegraded 環境内の Degraded 状況のインスタンスの数
InstancesSevere 環境内の Severe 状況のインスタンスの数           

インスタンス・メトリック

次の表は、センサーが収集するインスタンスのメトリクスを示しています:

名前 説明
InstanceHealth インスタンスの現在の正常性状況
CPUIrq CPU が irq 状態で費やした時間のパーセンテージ
CPUIdle CPU がアイドル状態で費やした時間のパーセンテージ
CPUUser CPU がユーザー状態で費やした時間のパーセンテージ
CPUSystem CPU がシステム状態で費やした時間のパーセンテージ
CPUSoftirq CPU が softirq 状態で費やした時間のパーセンテージ
CPUIowait CPU が iowait 状態で費やした時間のパーセンテージ
CPUNice CPU が nice 状態で費やした時間の割合 (%)
LoadAverage1min 直近の 1 分間におけるインスタンスの CPU 負荷  
RootFilesystemUtil インスタンスによって使用中のディスク・スペースの割合 (%)

環境とインスタンスのメトリック

次の表は、センサーが収集する環境およびインスタンスのメトリクスを示しています:

名前 説明
ApplicationLatencyP10 要求のうち、速いほうから 10% の要求を完了するのにかかる時間    
ApplicationLatencyP50 要求のうち、速いほうから 50% の要求を完了するのにかかる時間    
ApplicationLatencyP75 要求のうち、速いほうから 75% の要求を完了するのにかかる時間   
ApplicationLatencyP85 要求のうち、速いほうから 85% の要求を完了するのにかかる時間    
ApplicationLatencyP90 要求のうち、速いほうから 90% の要求を完了するのにかかる時間    
ApplicationLatencyP95 要求のうち、速いほうから 95% の要求を完了するのにかかる時間  
ApplicationLatencyP99 要求のうち、速いほうから 99% の要求を完了するのにかかる時間 
ApplicationLatencyP99.9 要求のうち、速いほうから 99.9% の要求を完了するのにかかる時間   
ApplicationRequests2xx 2xx 状況コードで完了した要求の数            
ApplicationRequests3xx 3xx 状況コードで完了した要求の数            
ApplicationRequests4xx 4xx 状況コードで完了した要求の数            
ApplicationRequests5xx 5xx 状況コードで完了した要求の数            
ApplicationRequestsTotal 要求の総数

モニタリングを無効にしています

Beanstalkインスタンスの監視を無効にするには、エージェントの設定ファイルで以下の設定を変更してください:

com.instana.plugin.aws.beanstalk:
  enabled: false