ActiveMQ

Supported Versions

Confirmed support for metrics and configuration data for versions:

  • 5.11.1
  • 5.12.0
  • 5.13.1
  • 5.14.3
  • 5.15.2

Sensor (Data Collection)

Tracked Configuration

  • Version
  • Broker Name
  • Health Status
  • Ports
  • Role
  • Memory Limit
  • Store Limit
  • Topics
  • Queues
  • Transport Connectors

Metrics

Broker wide

Metric Description
All Topics Messages Enqueue Number of messages that have been sent to the broker
All Topics Messages Dequeue Number of messages that have been acknowledged on the broker
All Queues Messages Enqueue Amount of messages that have been sent to all queues
All Queues Messages Dequeue Amount of messages that have been acknowledged on all queues
Total Connections Number of total connections on the broker
Total Producers Number of message producers active on destinations on the broker
Total Consumers Number of message consumers subscribed to destinations on the broker
Memory usage Percent of memory limit used
Store usage Percent of store limit used

Topics

Metric Description
Producer count Number of producers attached to the topic
Consumer count Number of consumers subscribed to the topic
Messages Enqueued Number of messages that have been sent to the topic
Messages Dequeued Number of messages that has been acknowledged (and removed) from the topic
Memory Usage Percent of memory limit used

Queues

Metric Description
Queue size Number of messages on this queue, including any that have been dispatched but not acknowledged
Messages Enqueued Number of messages that have been sent to the queue
Messages Dequeued Number of messages that has been acknowledged (and removed) from the queue
Memory Usage Percent of memory limit used

Health Signatures

Health Description
Memory limit reached Memory usage is close to 100% of memory limit
Store limit reached Store usage is close to 100% of store limit
Dead-letter queue filling Dead-letter queue size is growing

Configuration

In order to enable in depth metric monitoring, you need to inform the Agent about the queues/topics you want to monitor. You can configure it in the agent configuration.yaml:

com.instana.plugin.activemq:
  monitorQueues:
    - 'test-queue-1'
    - 'DLQ.test-1'
  monitorTopics:
    - 'ActiveMQ.Advisory.Topic'
    - 'test-topic-1'