Amazon MQ のモニター
「 Instana 」エージェントをインストールすると、Amazon MQ センサーが自動的に展開およびインストールされます。
センサー (データ収集)
メトリック収集は、 ActiveMQ エンジン・タイプおよび RabbitMQ エンジン・タイプでサポートされます。
追跡対象の構成
使用されているエンジンに関係なく、以下のブローカーの詳細を使用できます。
| ブローカーの詳細 |
|---|
| 名前 |
| ARN |
| 状態 |
| 作成時刻 |
| エンジン・タイプ |
| エンジンのバージョン |
| インスタンス・タイプ |
| デプロイメント |
| パブリック・アクセシビリティー |
| AWS リージョン |
メトリック
ActiveMQ 指標
| ブローカーのメトリック | 説明 |
|---|---|
| CpuCreditBalance | インスタンスが開始または開始されて以降に発生した、獲得された CPU クレジットの数 (起動クレジットの数を含む) |
| CpuUtilization | ブローカーが現在使用している 割り振り済み EC2 コンピュート・ユニットの割合 (%)。 |
| CurrentConnectionsCount | 現在のブローカー上のアクティブな接続の現在の数。 |
| JournalFilesForFastRecovery | 正常なシャットダウン後に再生されるジャーナル・ファイルの数。 |
| JournalFilesForFullRecovery | 異常なシャットダウン後に再生されるジャーナル・ファイルの数。 |
| HeapUsage | ブローカーが現在使用している ActiveMQ JVM メモリー制限の割合 (%)。 |
| NetworkIn | ブローカーの着信トラフィックの量。 |
| NetworkOut | ブローカーの発信トラフィックの量。 |
| OpenTransactionsCount | 進行中のトランザクション合計数。 |
| StorePercentUsage | ストレージ制限によって使用されている割合 (%)。 100 に達すると、ブローカーはメッセージを拒否します。 |
| TotalConsumerCount | 現行ブローカー上の宛先にサブスクライブしているメッセージ・コンシューマーの数。 |
| TotalMessageCount | ブローカーに保管されているメッセージの数。 |
| TotalProducerCount | 現在のブローカー上の宛先でアクティブなメッセージ・プロデューサーの数。 |
| 宛先のメトリック | 説明 |
|---|---|
| ConsumerCount | 宛先にサブスクライブされているコンシューマーの数。 |
| EnqueueCount | この宛先に送信されたメッセージの数。 |
| EnqueueTime | ブローカーがプロデューサーからメッセージを受け入れて宛先に送信するのにかかる時間。 |
| ExpiredCount | 期限切れになったために配信できなかったメッセージの数。 |
| DispatchCount | コンシューマーに送信されたメッセージの数。 |
| DequeueCount | コンシューマーによって確認されたメッセージの数。 |
| MemoryUsage | 宛先が現在使用しているメモリー制限の割合 (%)。 |
| ProducerCount | 宛先のプロデューサーの数。 |
| QueueSize | キューに入っているメッセージ数 (このメトリックはキューにのみ適用されます)。 |
RabbitMQ 指標
| ブローカーのメトリック | 説明 |
|---|---|
| ConnectionCount | ブローカー上で確立されている接続の総数。 |
| ConsumerCount | ブローカーに接続されているコンシューマーの合計数。 |
| MessageCount | キュー内のメッセージの合計数。 |
| MessagesRate | キュー内の 1 秒当たりの合計メッセージ数。 |
| MessageReadyCount | キュー内の作動可能メッセージの総数。 |
| MessagesReadyRate | クライアントに配信する準備ができている 1 秒当たりのメッセージ数。 |
| MessageUnacknowledgedCount | キュー内の確認応答のないメッセージの総数。 |
| MessageUnacknowledgedRate | クライアントに配信されたが、まだ確認されていない 1 秒当たりのメッセージの数。 |
| PublishRate | ブローカーに対してメッセージがパブリッシュされる率。 |
| ConfirmRate | RabbitMQ サーバーがパブリッシュされたメッセージを確認する速度。 |
| AckRate | メッセージがコンシューマーによって確認される率。 |
| ノード・メトリック | 説明 |
|---|---|
| SystemCpuUtilization | ブローカーが現在使用している割り振り済み Amazon EC2 計算単位の割合。 |
| MemoryLimit | RabbitMQ ノードの RAM の制限。 |
| MemoryUsed | RabbitMQ ノードによって使用される RAM のボリューム。 |
| DiskFreeLimit | RabbitMQ ノード用のディスク制限。 |
| DiskFree | RabbitMQ ノードで使用可能なフリー・ディスク・スペースの合計ボリューム。 |
| FileDescriptorsUsed | 使用されるファイル記述子の数。 |
RabbitMQ ブローカーのデプロイメントタイプが「 CLUSTER_MULTI_AZ」 の場合、ごくまれに「 RabbitMQ 」ダッシュボードに3つ以上のノードが表示されることがあります。 これは、 CLUSTER_MULTI_AZ ブローカーが削除され、同じ名前で作成され、数時間の間にエージェントによって検出された場合に発生する可能性があります。 この問題は、リソースが削除された後も CloudWatch がメトリクスを保持し続けることに起因しています。 この問題を解決するには、エージェントを再起動してください。 {: note}
| キュー評価指標 | 説明 |
|---|---|
| ConsumerCount | キューにサブスクライブされているコンシューマーの数。 |
| MessageReadyCount | 配信のために現在使用可能なメッセージの数。 |
| MessageUnacknowledgedCount | サーバーが確認応答を待機しているメッセージの数。 |
| MessageCount | MessageReadyCount と MessageUnacknowledgedCount の合計数(キュー深度とも呼ばれる)。 |
必要なアクセス権
cloudwatch:GetMetricDatacloudwatch:GetMetricStatisticsmq:ListBrokersmq:DescribeBroker
構成
Amazon MQ のメトリックは 5 分ごとにプルされます。これは、エージェント構成 (<agent_install_dir>/etc/instana/configuration.yaml) を使用して変更できます。
com.instana.plugin.aws.mq:
cloudwatch_period: 300
MQ インスタンスのモニターを無効にするには、以下の構成を使用します。
com.instana.plugin.aws.mq:
enabled: false
ActiveMQ 設定
ActiveMQ ブローカーの詳細なメトリック・モニターを有効にするには、各ブローカーでモニターするキューまたはトピックについてホスト・エージェントに通知する必要があります。 これは、エージェント構成ファイル <agent_install_dir>/etc/instana/configuration.yaml で以下のように構成できます。
com.instana.plugin.aws.mq:
PLACEHOLDER_ACTIVE_MQ_BROKER_NAME: # replace PLACEHOLDER_ACTIVE_MQ_BROKER_NAME with your ActiveMQ broker name
queues: # max 165 queues
- 'queue1'
- 'queue2'
topics: # max 165 topics
- 'topic1'
RabbitMQ 設定
RabbitMQ ブローカーの詳細なメトリック・モニターを有効にするには、各ブローカー (最大 700 キュー) でモニターするキューについてホスト・エージェントに通知する必要があります。 これは、エージェント構成ファイル <agent_install_dir>/etc/instana/configuration.yaml で以下のように構成できます。
com.instana.plugin.aws.mq:
PLACEHOLDER_RABBIT_MQ_BROKER_NAME: # replace PLACEHOLDER_RABBIT_MQ_BROKER_NAME with your RabbitMQ broker name
queuesRegex: '.*' # Regex pattern used for matching monitored queues
monitorQueues:
- queue: 'queue1' # name of the queue
vhost: '/' # name of the vhost, default is '/'
- queue: 'queue2' # name of the queue
vhost: '/' # name of the vhost, default is '/'
プロキシー構成
プロキシー構成を使用するように特定の AWS センサーを構成するには、以下のエージェント構成設定を追加します。
com.instana.plugin.aws.mq:
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 アカウントのモニター
同じリージョン内の 1 つの AWS エージェントを使用して複数の AWS アカウントのモニターをセットアップするには、 複数の AWS アカウントのモニター の資料を参照してください。
AWS 名前付きプロファイルを使用する方法
MQのモニターに使用されるプロファイルをオーバーライドするには、以下の構成を使用します。
com.instana.plugin.aws.mq:
profile_names:
- 'profile2'
- 'profile3'
AWS STS を使用する方法
MQのモニターに使用される IAM 役割をオーバーライドするには、以下の構成を使用します。
com.instana.plugin.aws.mq:
role_arns:
- 'arn:aws:iam::<account_1_id>:role/<role_1_name>'
- 'arn:aws:iam::<account_2_id>:role/<role_2_name>'
フィルタリング
複数のタグを定義するには、コンマで区切ります。 タグは、以下によって区切られたキーと値のペアとして提供されます。構成を容易にするために、ディスカバリーに含めるタグ、またはディスカバリーから除外するタグを定義することができます。 両方のリスト (包含および除外) でタグを定義する場合は、除外リストの優先順位が高くなります。 サービスをフィルタリングする必要がない場合は、構成を定義しないでください。 フィルタリングを有効にするためにすべての値を定義することは必須ではありません。
ユーザーは、tagged-services-poll-rate構成プロパティーを使用する AWS タグ付きリソースをセンサーがポーリングする頻度を指定できます (デフォルトは 300 秒)。
タグ付きリソースをセンサーがポーリングする頻度を定義するには、以下の構成を使用します。
com.instana.plugin.aws:
tagged-services-poll-rate: 60 #default 300
タグによってサービスをディスカバリーに組み込むには、以下の構成を使用します。
com.instana.plugin.aws.mq:
include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)
タグごとのサービスをディスカバリーから除外するには、以下の構成を使用します。
com.instana.plugin.aws.mq:
exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)
タグのない AWS サービスはデフォルトでモニターされますが、include_untaggedフィールドをfalseに設定することで除外できます。
com.instana.plugin.aws.mq:
include_untagged: false # True value by default
Instana エージェント・タグ
なお、タグ機能は AWS エージェントでのみ利用可能です。 タグの使用方法の詳細については、こちらをご覧ください。