Docs » Integrations Guide » Integrations Reference » ActiveMQ

image0 ActiveMQ

Metadata associated with SignalFx’s integration with ActiveMQ can be found here. The relevant code for the plugin can be found here.

DESCRIPTION

SignalFx’s integration with ActiveMQ configures the Java plugin for collectd to monitor ActiveMQ.

Use this plugin to monitor the following types of information from ActiveMQ:

  • Broker (Totals per broker)
  • Queue (Queue status)
  • Topic (Topic status)

To monitor the age of messages inside ActiveMQ queues, see ActiveMQ message age listener.

FEATURES

Built-in dashboards

  • ActiveMQ Hosts: Overview of all data from ActiveMQ hosts.

image1

  • ActiveMQ Host: Focus on a single ActiveMQ host.

image2

  • ActiveMQ Queue: Focus on a single ActiveMQ queue.

image3

  • ActiveMQ Topic: Focus on a single ActiveMQ topic.

image4

image5

REQUIREMENTS AND DEPENDENCIES

Software Version
collectd 4.9 or later
ActiveMQ 5.8.0 or later
Java plugin for collectd (match collectd version)

INSTALLATION

If you are using the new Smart Agent, see the docs for thecollectd/activemqmonitor for more information. The configuration documentation below may be helpful as well, but consult the Smart Agent repo’s docs for the exact schema.

  1. RHEL/CentOS and Amazon Linux users: Install the Java plugin for collectd if it is not already installed.
  2. Download SignalFx’s example ActiveMQ configuration file to /etc/collectd/managed_config: 20-activemq.conf
  3. Modify 20-activemq.conf to provide values that make sense for your environment, as described in Configuration, below.
  4. Restart collectd.

CONFIGURATION

Using the example configuration file 20-activemq.conf as a guide, provide values for the configuration options listed below that make sense for your environment and allow you to connect to the ActiveMQ instance to be monitored.

configuration option definition example value
Host The name of this ActiveMQ broker. Appears as dimension host in SignalFx. Note: Do not modify or remove the [hostHasService=activemq] section. "ActiveMQ_Host1[hostHasService=activemq]"
ServiceURL URL of the ActiveMQ service. ServiceURL "service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi"

USAGE

Sample of built-in dashboard in SignalFx:

image6

METRICS

Below is a list of all metrics.

Metric Name Brief Type
counter.amq.TotalConnectionsCount Total connections count per broker counter
gauge.amq.TotalConsumerCount Total number of consumers subscribed to destinations on the broker gauge
gauge.amq.TotalDequeueCount Total number of messages that have been acknowledged from the broker. gauge
gauge.amq.TotalEnqueueCount Total number of messages that have been sent to the broker. gauge
gauge.amq.TotalMessageCount Total number of unacknowledged messages on the broker gauge
gauge.amq.TotalProducerCount Total number of message producers active on destinations on the broker gauge
gauge.amq.queue.AverageBlockedTime Average time (ms) that messages have spent blocked by Flow Control. gauge
gauge.amq.queue.AverageEnqueueTime Average time (ms) that messages have been held at this destination gauge
gauge.amq.queue.AverageMessageSize Average size of messages in this queue, in bytes. gauge
gauge.amq.queue.BlockedSends Number of messages blocked by Flow Control. gauge
gauge.amq.queue.ConsumerCount Number of consumers subscribed to this queue. gauge
gauge.amq.queue.DequeueCount Number of messages that have been acknowledged and removed from the queue. gauge
gauge.amq.queue.EnqueueCount Number of messages that have been sent to the queue. gauge
gauge.amq.queue.ExpiredCount Number of messages that have expired from the queue. gauge
gauge.amq.queue.ForwardCount Number of messages that have been forwarded from this queue to a networked broker. gauge
gauge.amq.queue.InFlightCount The number of messages that have been dispatched to consumers, but not acknowledged. gauge
gauge.amq.queue.ProducerCount Number of producers publishing to this queue gauge
gauge.amq.queue.QueueSize The number of messages in the queue that have yet to be consumed. gauge
gauge.amq.queue.TotalBlockedTime The total time (ms) that messages have spent blocked by Flow Control. gauge
gauge.amq.topic.AverageBlockedTime Average time (ms) that messages have been blocked by Flow Control. gauge
gauge.amq.topic.AverageEnqueueTime Average time (ms) that messages have been held at this destination. gauge
gauge.amq.topic.AverageMessageSize Average size of messages on this topic, in bytes. gauge
gauge.amq.topic.BlockedSends Number of messages blocked by Flow Control gauge
gauge.amq.topic.ConsumerCount The number of consumers subscribed to this topic gauge
gauge.amq.topic.DequeueCount Number of messages that have been acknowledged and removed from the topic. gauge
gauge.amq.topic.EnqueueCount The number of messages that have been sent to the topic. gauge
gauge.amq.topic.ExpiredCount The number of messages that have expired from this topic. gauge
gauge.amq.topic.ForwardCount The number of messages that have been forwarded from this topic to a networked broker. gauge
gauge.amq.topic.InFlightCount The number of messages that have been dispatched to consumers, but have not yet been acknowledged. gauge
gauge.amq.topic.ProducerCount Number of producers publishing to this topic. gauge
gauge.amq.topic.QueueSize Number of messages in the topic that have yet to be consumed. gauge
gauge.amq.topic.TotalBlockedTime The total time (ms) that messages have spent blocked by Flow Control gauge

counter.amq.TotalConnectionsCount

counter

This metric indicates the total connections count per broker.

gauge.amq.TotalConsumerCount

gauge

Total number of consumers subscribed to destinations on the broker.

gauge.amq.TotalDequeueCount

gauge

Total number of messages that have been acknowledged from the broker.

gauge.amq.TotalEnqueueCount

gauge

Total number of messages that have been sent to the broker.

gauge.amq.TotalMessageCount

gauge

Total number of unacknowledged messages on the broker.

gauge.amq.TotalProducerCount

gauge

Total number of message producers active on destinations on the broker.

gauge.amq.queue.AverageBlockedTime

gauge

Average time (ms) that messages have spent blocked by Flow Control.

gauge.amq.queue.AverageEnqueueTime

gauge

Average time (ms) that messages have been held at this destination.

gauge.amq.queue.AverageMessageSize

gauge

Average size of messages in this queue, in bytes.

gauge.amq.queue.BlockedSends

gauge

Number of messages blocked by Flow Control.

gauge.amq.queue.ConsumerCount

gauge

Number of consumers subscribed to this queue.

gauge.amq.queue.DequeueCount

gauge

Number of messages that have been acknowledged and removed from the queue.

gauge.amq.queue.EnqueueCount

gauge

Number of messages that have been sent to the queue.

gauge.amq.queue.ExpiredCount

gauge

Number of messages that have expired from the queue.

gauge.amq.queue.ForwardCount

gauge

Number of messages that have been forwarded from this queue to a networked broker.

gauge.amq.queue.InFlightCount

gauge

The number of messages that have been dispatched to consumers, but not acknowledged.

gauge.amq.queue.ProducerCount

gauge

The number of producers publishing to this queue.

gauge.amq.queue.QueueSize

gauge

Number of messages in the destination which are yet to be consumed.

This metric indicates the number of messages in the queue that have yet to be
consumed. This potentially includes messages that have been dispatched but
not yet acknowledged.

gauge.amq.queue.TotalBlockedTime

gauge

The total time (ms) that messages have spent blocked by Flow Control.

gauge.amq.topic.AverageBlockedTime

gauge

Average time (ms) that messages have been blocked by Flow Control.

gauge.amq.topic.AverageEnqueueTime

gauge

Average time (ms) that messages have been held at this destination.

gauge.amq.topic.AverageMessageSize

gauge

Average size of messages on this topic, in bytes.

gauge.amq.topic.BlockedSends

gauge

Number of messages blocked by Flow Control.

gauge.amq.topic.ConsumerCount

gauge

The number of consumers subscribed to this topic.

gauge.amq.topic.DequeueCount

gauge

Number of messages that have been acknowledged and removed from the topic.

gauge.amq.topic.EnqueueCount

gauge

The number of messages that have been sent to the topic.

gauge.amq.topic.ExpiredCount

gauge

The number of messages that have expired from this topic.

gauge.amq.topic.ForwardCount

gauge

The number of messages that have been forwarded from this topic to a networked broker.

gauge.amq.topic.InFlightCount

gauge

The number of messages that have been dispatched to consumers, but have not yet been acknowledged.

gauge.amq.topic.ProducerCount

gauge

Number of producers publishing to this topic.

gauge.amq.topic.QueueSize

gauge

This metric indicates the number of messages in the topic that have yet to be
consumed. This potentially includes messages that have been dispatched but
not yet acknowledged.

gauge.amq.topic.TotalBlockedTime

gauge

The total time (ms) that messages have spent blocked by Flow Control.