Monitoring ActiveMQ
The ActiveMQ sensor is automatically deployed and installed after you install the Instana agent.
Supported information
Supported versions
The ActiveMQ sensor supports the metrics and configuration data for the following versions: 5.11.1, 5.12.0, 5.13.1, 5.14.3, 5.15.2, 5.18.0, and 6.1.2.
Supported client-side tracing
For this technology, Instana supports client-side tracing for the following language:
Enabling JMX
If Java Management Extensions (JMX) is not enabled, the following message is displayed in the Instana UI:
Jmx is not enabled.
You can enable it in activemq config by setting the broker property useJmx to true.
For more information about how to enable JMX support with the useJmx="true" broker property, see ActiveMQ documentation.
Configuration
To enable in-depth metric monitoring, add the queues or topics you want to monitor to the <agent_install_dir>/etc/instana/configuration.yaml agent configuration file:
com.instana.plugin.activemq:
monitorQueues:
- 'test-queue-1'
- 'DLQ.test-1'
monitorTopics:
- 'ActiveMQ.Advisory.Topic'
- 'test-topic-1'
A limit is set to 100 for both the queues and topics that are monitored in ActiveMQ sensor.
Metrics collection
To view the metrics, complete the following steps:
-
From the navigation menu in the Instana UI, select Infrastructure.
-
Click a specific monitored host.
Then, you can see a host dashboard with all the collected metrics and monitored processes.
Configuration data
- Version
- Broker Name
- Health Status
- Ports
- Role
- Memory Limit
- Store Limit
- Topics
- Queues
- Transport Connectors
Performance metrics
Broker wide
| Metric | Description | Granularity |
|---|---|---|
| All topics messages Enqueue | The number of messages that are sent to the broker and is collected from BrokerMBean#TotalEnqueueCount. |
1 second |
| All topics messages Dequeue | The number of messages that are acknowledged on the broker and is collected from BrokerMBean#TotalDeque. |
1 second |
| All Queues messages Enqueue | The number of messages that are sent to all queues and is collected from the sum of BrokerMBean#EnqueueCount for all queues. |
1 second |
| All Queues messages Dequeue | The number of messages that are acknowledged on all queues and is collected from the sum of BrokerMBean#DequeueCount for all queues. |
1 second |
| Total Connections | The number of total connections on the broker and is collected from the BrokerMBean,connector=clientConnectors#connectionCount sum. |
1 second |
| Total Producers | The number of message producers that are active on destinations on the broker and is collected from BrokerMBean#TotalProducerCount. |
1 second |
| Total Consumers | The number of message consumers that are subscribed to destinations on the broker and is collected from BrokerMBean#TotalConsumerCount. |
1 second |
| Memory usage | The percentage of memory limit that is used and is collected from BrokerMBean#MemoryPercentUsage. |
1 second |
| Store usage | The percentage of the store limit that is used and is collected from BrokerMBean#StorePercentUsage. |
1 second |
Topics
| Metric | Description | Granularity |
|---|---|---|
| Producer count | The number of producers who are attached to the topic and is collected from BrokerMBean,destinationType=Topic#ProducerCount. |
1 second |
| Consumer count | The number of consumers that are subscribed to the topic and is collected from BrokerMBean,destinationType=Topic#ConsumerCount. |
1 second |
| Messages Enqueued | The number of messages that are sent to the topic and is collected from BrokerMBean,destinationType=Topic#EnqueueCount. |
1 second |
| Messages Dequeued | The number of messages that are acknowledged (and removed) from the topic and is collected from BrokerMBean,destinationType=Topic#DequeueCount. |
1 second |
| Memory Usage | The percentage of memory limit that is used and is collected from BrokerMBean,destinationType=Topic#MemoryPercentUsage. |
1 second |
Queues
| Metric | Description | Granularity |
|---|---|---|
| Queue size | The number of messages on this queue, including any that are dispatched but not acknowledged and is collected from BrokerMBean,destinationType=Queue#QueueSize. |
1 second |
| Messages Enqueued | The number of messages that are sent to the queue and is collected from BrokerMBean,destinationType=Queue#EnqueueCount. |
1 second |
| Messages Dequeued | The number of messages that are acknowledged (and removed) from the queue and is collected from BrokerMBean,destinationType=Queue#DequeueCount. |
1 second |
| Memory Usage | The percentage of memory limit that is used and is collected from BrokerMBean,destinationType=Queue#MemoryPercentUsage. |
1 second |
Health Signatures
For each sensor, a curated knowledgebase of health signatures are evaluated continuously against the incoming metrics and are used to raise issues or incidents that depend on user impact.
Built-in events** trigger issues or incidents based on failing health signatures on entities, and custom events** trigger issues or incidents based on the thresholds of an individual metric of any entity.
For more information about built-in events for the ActiveMQ sensor, see Built-in events reference.