監視 Amazon MQ

在您安裝 Instana 代理程式之後，會自動部署並安裝 Amazon MQ 感應器。

附註: 請參閱 AWS 說明文件，以瞭解其他受支援的 AWS 服務。

感應器 (資料收集)

ActiveMQ 和 RabbitMQ 引擎類型支援度量值收集。

追蹤配置

不論使用的引擎為何，都可以使用下列分配管理系統詳細資料。

分配管理系統詳細資料
名稱
ARN
州/省（縣/市）
建立時間
引擎類型
引擎版本
實例類型
部署
公用協助工具
AWS 區域

度量值

ActiveMQ 度量值

分配管理系統度量值 說明
CpuCreditBalance 實例自啟動或啟動後所產生的已獲得 CPU 額度數目 (包括啟動額度數目)
CpuUtilization 分配管理系統目前使用的已配置 EC2 計算單元百分比。
CurrentConnections計數 現行分配管理系統上作用中連線的現行數目。
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 佇列中每秒的訊息總數。
MessageReady 計數 佇列中備妥訊息的總數。
MessagesReady率 每秒備妥可遞送至用戶端的訊息數。
MessageUnacknowledged 計數 佇列中未確認的訊息總數。
MessageUnacknowledged 率 每秒遞送至用戶端但尚未確認的訊息數。
PublishRate 將訊息發佈至分配管理系統的速率。
ConfirmRate RabbitMQ 伺服器確認已發佈訊息的速率。
AckRate 消費者確認訊息的速率。
節點度量 說明
SystemCpu 使用率 分配管理系統目前使用的已配置 Amazon EC2 計算單元百分比。
MemoryLimit RabbitMQ 節點的 RAM 限制。
MemoryUsed RabbitMQ 節點所使用的 RAM 磁區。
DiskFree 限制 RabbitMQ 節點的磁碟限制。
DiskFree RabbitMQ 節點中可用的可用磁碟空間磁區總計。
已使用 FileDescriptors 使用的檔案描述子數目。

附註: 如果 RabbitMQ 分配管理系統的部署類型為 CLUSTER_MULTI_AZ，在極少數情況下，您可能會看到 RabbitMQ 儀表板中列出超過三個節點。 當刪除 CLUSTER_MULTI_AZ 分配管理系統，以相同名稱建立，然後由代理程式在數小時的時間範圍內探索到時，可能會發生此情況。 此問題是由於 CloudWatch 會保留度量值，即使在刪除資源之後也是如此。 若要解決此問題，您可以將代理程式重新開機。

佇列度量 說明
ConsumerCount 訂閱佇列的消費者數目。
MessageReady 計數 目前可遞送的訊息數目。
MessageUnacknowledged 計數 伺服器正在等待確認的訊息數目。
MessageCount MessageReady計數與 MessageUnacknowledged計數總數 (也稱為佇列深度)。

必要許可權

  • 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 '/'

Proxy 配置

若要配置特定的 AWS 感應器以使用 Proxy 配置，請新增下列代理程式配置設定:

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 帳戶

請參閱 監視多個 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

Instana 代理程式標籤

請注意，標籤僅適用於 AWS 代理程式。 如需使用標籤的詳細資料，請參閱 這裡說明。