Skip to content

ActiveMQ Integration

Infrastructure Integration

Instructions

Follow the installation guide below for your given collector environment.

During installation, use the configuration section below as reference.

After installation, the infrastructure datasources in the table below will be available in the AOC.

Installation Guide

Installing this integration consists of creating a yaml file in the filesystem of your collectors. Click below for instructions on how to do so for your given collectors environment.

Docker

Kubernetes

Mesos-Marathon

Debian

Ubuntu

RHEL/CentOS

Configuration

  1. Ensure that JMX Remote is enabled on ActiveMQ server.
  2. Edit activemq.yaml to configure the agent. Please refer activemq.yaml for all available configuration options.

    instances:
      - host: localhost
        port: 1099
    
    # List of metrics to be collected by the integration
    init_config:
      conf:
        - include:
        destinationType: Queue
        attribute:
          AverageEnqueueTime:
            alias: activemq.queue.avg_enqueue_time
            metric_type: gauge
          ConsumerCount:
            alias: activemq.queue.consumer_count
            metric_type: gauge
          ProducerCount:
            alias: activemq.queue.producer_count
            metric_type: gauge
    
        - include:
        type: Broker
        attribute:
          StorePercentUsage:
            alias: activemq.broker.store_pct
            metric_type: gauge
          TempPercentUsage:
            alias: activemq.broker.temp_pct
            metric_type: gauge
          MemoryPercentUsage:
            alias: activemq.broker.memory_pct
            metric_type: gauge
    
  3. In addition, you can edit activemq_xml.yaml as well.

    init_config:
    instances:
      - url: http://localhost:8161
    

Infrastructure Datasources

Datasource Available Aggregations Unit Description
activemq.queue.avg_enqueue_time avg max min sum millisecond On average the amount of time (ms) that messages remained enqueued.
activemq.queue.consumer_count avg max min sum The number of consumers connected
activemq.queue.producer_count avg max min sum The number of producers connected
activemq.queue.max_enqueue_time avg max min sum millisecond The max the amount of time (ms) that messages remained enqueued.
activemq.queue.min_enqueue_time avg max min sum millisecond The min the amount of time (ms) that messages remained enqueued.
activemq.queue.memory_pct avg max min sum percent The percentage of memory currently in use
activemq.queue.size avg max min sum The amount of messages that remained queued.
activemq.queue.dequeue_count avg max min sum The amount of messages that remained dequeued.
activemq.queue.dispatch_count avg max min sum The amount of messages that have been dispatched.
activemq.queue.enqueue_count avg max min sum The amount of messages that have been enqueued.
activemq.queue.expired_count avg max min sum The amount of messages that have been expired.
activemq.queue.in_flight_count avg max min sum The amount of messages that have been in flight.
activemq.broker.store_pct avg max min sum percent The percentage of store in use.
activemq.broker.temp_pct avg max min sum percent The percentage of temporary in use.
activemq.broker.memory_pct avg max min sum percent The percentage of memory in use.