Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
dashboards
docs General cleanup for surfacing docs on RTD (#337) Oct 2, 2017
img
20-activemq.conf
LICENSE
README.md
meta.yaml

README.md

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.

  • ActiveMQ Host: Focus on a single ActiveMQ host.

  • ActiveMQ Queue: Focus on a single ActiveMQ queue.

  • ActiveMQ Topic: Focus on a single ActiveMQ topic.

  • ActiveMQ Message Age: (if enabled) Shows the average age of messages in ActiveMQ queues. See ActiveMQ message age listener.

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 the collectd/activemq monitor 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:

METRICS

For documentation of the metrics and dimensions emitted by this plugin, click here.

LICENSE

This integration is released under the Apache 2.0 license. See LICENSE for more details.