ActiveMQ XML

Supported OS Linux Windows Mac OS

Integration version5.1.0

ActiveMQ XML Integration

Overview

Get metrics from ActiveMQ XML in real time to:

  • Visualize and monitor ActiveMQ XML states.
  • Be notified about ActiveMQ XML failovers and events.

Setup

Installation

The ActiveMQ XML check is included in the Datadog Agent package, so you don’t need to install anything else on your servers.

Configuration

Follow the instructions below to configure this check for an Agent running on a host. For containerized environments, see the Containerized section.

    Host

    To configure this check for an Agent running on a host:

    1. Edit activemq_xml.d/conf.yaml, in the conf.d/ folder at the root of your Agent’s configuration directory with your stats url. See the sample activemq_xml.d/conf.yaml for all available configuration options.

      Note: The ActiveMQ XML integration can potentially emit custom metrics, which may impact your billing. By default, there is a limit of 350 metrics. If you require additional metrics, contact Datadog support.

    2. Restart the Agent.

    Log collection

    1. Collecting logs is disabled by default in the Datadog Agent, enable it in your datadog.yaml file:

      logs_enabled: true

    2. Add this configuration block to your activemq_xml.d/conf.yaml or activemq.d/conf.yaml file to start collecting your ActiveMQ logs:

      logs:
  - type: file
    path: "<ACTIVEMQ_BASEDIR>/data/activemq.log"
    source: activemq
    service: "<SERVICE_NAME>"
  - type: file
    path: "<ACTIVEMQ_BASEDIR>/data/audit.log"
    source: activemq
    service: "<SERVICE_NAME>"

    3. Restart the Agent.

    Containerized

    For containerized environments, see the Autodiscovery with JMX guide.

    Validation

    Run the Agent’s status subcommand and look for activemq_xml under the Checks section.

    Data Collected

    Metrics

    activemq.queue.consumer_count
    (gauge)    		The number of consumers of a queue.
    activemq.queue.count
    (gauge)    		The number of queues.
    activemq.queue.dequeue_count
    (gauge)    		The total number of messages sent to a queue since the last restart.
    Shown as message
    activemq.queue.enqueue_count
    (gauge)    		The total number of messages removed from a queue (acknowledged by consumer) since the last restart.
    Shown as message
    activemq.queue.size
    (gauge)    		The size of a queue.
    activemq.subscriber.count
    (gauge)    		The number of subscribers.
    activemq.subscriber.dequeue_counter
    (gauge)    		The number of messages sent to and acknowledged by the client.
    Shown as message
    activemq.subscriber.dispatched_counter
    (gauge)    		The number of messages sent to the client.
    Shown as message
    activemq.subscriber.dispatched_queue_size
    (gauge)    		The number of messages dispatched that are awaiting acknowledgement.
    Shown as message
    activemq.subscriber.enqueue_counter
    (gauge)    		The number of messages that matched the subscription.
    Shown as message
    activemq.subscriber.pending_queue_size
    (gauge)    		The number of messages pending delivery.
    Shown as message
    activemq.topic.consumer_count
    (gauge)    		The number of consumers of a topic.
    activemq.topic.count
    (gauge)    		The number of topics.
    activemq.topic.dequeue_count
    (gauge)    		The total number of messages sent to a topic since the last restart.
    Shown as message
    activemq.topic.enqueue_count
    (gauge)    		The total number of messages removed from a topic (acknowledged by consumer) since the last restart.
    Shown as message
    activemq.topic.size
    (gauge)    		The size of a topic.

    Events

    The ActiveMQ XML check does not include any events.

    Service Checks

    The ActiveMQ XML check does not include any service checks.

    Troubleshooting

    Need help? Contact Datadog support.

    Further Reading