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 のインスタンスを監視するには、以下の手順を実行する必要があります:
これらの手順を完了すると、 Instana のUIでメトリクスを確認できるようになります。 詳細については、 「メトリクスの表示」 を参照してください。
必要なIAM権限の追加
AWS Beanstalk 環境を監視するには、IAMロールの設定に以下の権限を追加してください。 詳細については、 「Amazon Web Services(AWS)のIAM設定」 を参照してください。
cloudwatch:GetMetricStatisticscloudwatch:GetMetricDataelasticbeanstalk:DescribeEnvironmentselasticbeanstalk:ListTagsForResourceelasticbeanstalk: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 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>'
監視対象の AWS Beanstalk インスタンスのフィルタリング
AWS Beanstalk センサーを有効にすると、デフォルトで AWS Beanstalk のすべてのインスタンスが監視されます。 ただし、 AWS タグに基づいて、センサーが検出および監視すべき AWS Beanstalk インスタンスをフィルタリングすることができます。 フィルタリングを設定するには、 AWS/opt/instana/agent/etc/instana/configuration.yamlのエージェント設定ファイルを変更してください。
複数のタグを定義するには、コンマで区切ります。 タグは、コロン(:)で区切られたキーと値のペアとして指定する必要があります。設定を簡単にするために、ディスカバリの対象に含めるタグや除外するタグを定義することができます。 「含める」リストと「除外する」リストの両方に同じタグを定義した場合、「除外する」リストが優先されます。 フィルタリングサービスが必要ない場合は、設定を行わないでください。 フィルタリングを有効にするためにすべての値を定義することは必須ではありません。
`configuration tagged-services-poll-rate ` プロパティを使用する ` AWS ` タグ付きリソースに対して、センサーがポーリングを行う間隔を指定できます(デフォルトは 300 秒)。 詳細については、 「ポーリング頻度の変更」 を参照してください。
指定されたタグを持つ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
メトリクスと設定データの確認
指標を確認するには、以下の手順に従ってください:
- Instana のUIにあるナビゲーションメニューから、 「インフラストラクチャ」 をクリックします。
- 指定されたホストをクリックしてください。
収集されたすべてのメトリクスと監視対象のプロセスが表示されたホストダッシュボードを確認できます。
追跡された構成データ
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