Amazon MQ のモニター

「 Instana 」エージェントをインストールすると、Amazon MQ センサーが自動的に展開およびインストールされます。

注: サポートされるその他の AWS サービスについては、AWS の資料を使用してください。

センサー (データ収集)

メトリック収集は、 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:GetMetricData
  • cloudwatch:GetMetricStatistics
  • mq:ListBrokers
  • mq: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 のプロファイルに関するグローバル設定が上書きされます。

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>'
注: サービスレベルでIAMロールを定義すると、グローバルな AWS のIAMロール設定が上書きされます。

フィルタリング

複数のタグを定義するには、コンマで区切ります。 タグは、以下によって区切られたキーと値のペアとして提供されます。構成を容易にするために、ディスカバリーに含めるタグ、またはディスカバリーから除外するタグを定義することができます。 両方のリスト (包含および除外) でタグを定義する場合は、除外リストの優先順位が高くなります。 サービスをフィルタリングする必要がない場合は、構成を定義しないでください。 フィルタリングを有効にするためにすべての値を定義することは必須ではありません。

ユーザーは、tagged-services-poll-rate構成プロパティーを使用する AWS タグ付きリソースをセンサーがポーリングする頻度を指定できます (デフォルトは 300 秒)。

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

タグ付きリソースをセンサーがポーリングする頻度を定義するには、以下の構成を使用します。

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