ActiveMQ Artemis

Supported Versions

Confirmed support for metrics and configuration data for versions: 2.0.0 to 2.6.x. By supporting these versions of Artemis we support JBoss AMQ version 7 and later

Sensor (Data Collection)

Tracked Configuration

  • Version
  • Broker Name
  • Node ID
  • Ports
  • Memory Limit
  • Addresses
  • Queues
  • Transport Acceptors

Metrics

Broker wide

Metric Description
Messages Added Number of messages that have been added to the broker
Messages Acknowledged Number of messages that have been acknowledged (and removed) from the broker
Messages Expired Number of messages that have been expired on the broker
Messages killed Amount of messages that have been killed on the broker to exceeding the max delivery attempts
Message Count Message count on all queues
Total Connections Number of total connections on the broker
Total Consumers Number of total consumers on the broker
Memory usage Percent of memory limit used by all addresses on broker

Queues

Metric Description
Message count Number of messages currently in this queue (includes scheduled, paged, and in-delivery messages)
Messages Added Number of messages that have been added to the queue
Messages Acknowledged Number of messages that have been acknowledged (and removed) from the queue
Messages Expired Number of messages that have been expired on this queue
Messages killed Amount of messages that have been killed on this queue due to exceeding the max delivery attempts

Health Signatures

Health Description
Memory limit reached Memory usage is close to 100% of memory limit
No connections There is no connections in last 5 seconds
No consumers There is no consumers in last 5 seconds

Enable JMX

If JMX is not enabled, the following message will be shown in the UI:

Jmx is not enabled. 
You can enable it in activemq config by setting the broker property useJmx to true.

You can enable JMX access by removing <authorisation> element from /apache-artemis/bin/myinstance/etc/management.xml

Configuration

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

com.instana.plugin.activemqartemis:
  monitorQueues:
    - 'test-queue'
    - 'DLQ'