Amazon MQ

Learn about other supported AWS services on our AWS docs.

Sensor (Data Collection)

Tracked Configuration

Broker Details
Name
ARN
State
Created At
Engine Type
Engine Version
Instance Type
Deployment
Public Accessibility
AWS Region

Metrics

Broker Metrics Description
CpuCreditBalance The number of earned CPU credits that an instance has accrued since it was launched or started (including the number of launch credits)
CpuUtilization The percentage of allocated EC2 compute units that the broker currently uses.
CurrentConnectionsCount The current number of active connections on the current broker.
JournalFilesForFastRecovery The number of journal files that will be replayed after a clean shutdown.
JournalFilesForFullRecovery The number of journal files that will be replayed after an unclean shutdown.
HeapUsage The percentage of the ActiveMQ JVM memory limit that the broker currently uses.
NetworkIn The volume of incoming traffic for the broker.
NetworkOut The volume of outgoing traffic for the broker.
OpenTransactionsCount The total number of transactions in progress.
StorePercentUsage The percent used by the storage limit. If this reaches 100 the broker will refuse messages.
TotalConsumerCount The number of message consumers subscribed to destinations on the current broker.
TotalMessageCount The number of messages stored on the broker.
TotalProducerCount The number of message producers active on destinations on the current broker.
Destination Metrics Description
ConsumerCount The number of consumers subscribed to the destination.
EnqueueCount The number of messages sent to the destination.
EnqueueTime The amount of time it takes the broker to accept a message from the producer and send it to the destination.
ExpiredCount The number of messages that could not be delivered because they expired.
DispatchCount The number of messages sent to consumers.
DequeueCount The number of messages acknowledged by consumers.
MemoryUsage The percentage of the memory limit that the destination currently uses.
ProducerCount The number of producers for the destination.
QueueSize The number of messages in the queue. (This metric applies only to queues.)

Required Permissions

  • cloudwatch:GetMetricData
  • cloudwatch:GetMetricStatistics
  • mq:ListBrokers
  • mq:DescribeBroker

Configuration

Metrics for Amazon MQ are pulled every 5 minutes, this can be changed via agent configuration (<agent_install_dir>/etc/instana/configuration.yaml):

com.instana.plugin.aws.mq:
  cloudwatch_period: 300

To disable monitoring of MQ instances use the following configuration:

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

In order to enable in-depth metric monitoring, you need to inform the Agent about the queues/topics you want to monitor for every broker. You can configure it in the agent <agent_install_dir>/etc/instana/configuration.yaml:

com.instana.plugin.aws.mq:
  PLACEHOLDER_BROKER_NAME: # replace PLACEHOLDER_BROKER_NAME with your broker name 
    queues: # max 100 queues
      - 'queue1'
      - 'queue2'
    topics: # max 100 topics
      - 'topic1'

Tags

Please note that tags are currently only available in conjunction with the dedicated AWS Instana agent, described here AWS Agent Installation docs. More detail on using tags is described here.