Monitor ActiveMQ with the JMX integration

With our ActiveMQ dashboards, you can easily track your ActiveMQ logs, keep an eye on your critical brokers, and get a total overview of all components of your messaging system. Built with our infrastructure agent and our JMX integration, ActiveMQ take advantage of JMX scraping so you can view all your most important data, all in one place.

After setting up ActiveMQ with New Relic, your data will display in dashboards like these, right out of the box.

Install the JMX integration

Before getting ActiveMQ data into New Relic, first install our infrastructure agent, then expose your metrics by installing the JMX integration. If you haven't already:

Follow our guided install to instrument your system with the infrastructure agent. Or, if you prefer, install the infrastructure agent via the command line.
Install the JMX monitoring integration.

Configure the JMX integration for ActiveMQ

Our ActiveMQ dashboard takes data scraped from your JMX integration and translates it into dashboards. By storing all your data in New Relic, you've a one stop shop to get a full overview of your system's health and critical business points.

If you haven't already, you'll need to install our JMX monitoring integration. You'll need to make some additional configurations once it's installed.

The below YAML snippet connects your ActiveMQ metrics via CONNECTION_URL to jconsole, a Java tool that makes those metrics readable. If you're following along with the JMX integration install, this step corresponds with the configuration step.

To update:

Go to file path: /etc/newrelic-infra/integrations.d/jmx-config.yml
Add the below snippet, which configures your JMX integration.
```
integrations:
- name: nri-jmx
  env:
    COLLECTION_FILES: "/etc/newrelic-infra/integrations.d/jvm-metrics.yml"
    JMX_HOST: 127.0.0.1
    JMX_PASS: admin
    JMX_PORT: 8161
    JMX_user: admin
    CONNECTION_URL: "service:jmx:rmi://127.0.0.1:1098/jndi/rmi://127.0.0.1:1099/jmxrmi"
    REMOTE_MONITORING: "true"
  interval: 15s
  labels:
    env: staging
```

This step organizes your metrics to be human readable once they're in New Relic. Update the jvm metrics.yml file with any metrics that jconsole should capture. In the procedure below is the snippet of the jvm-metrics.yml file.

Before you start, here are some things to know about using the snippet:

For the code snippet below, you'll update it with your desired metrics.
Update YOUR_BROKER_NAME, YOUR_TOPIC_NAME, and YOUR_QUEUE_NAME with your actual values. You can use the jconsole tool to get these values.
All the metrics captured are stored on the events determined by the event_type field.

To update the jvm-metrics.yml file:

Go to file path /etc/newrelic-infra/integrations.d/jvm-metrics.yml

Add this snippet:

collect:
  - domain: java.lang
    event_type: JVMSampleActiveMQ
    beans:
      - query: type=GarbageCollector,name=*
        attributes:
          - CollectionCount
          - CollectionTime
      - query: type=Memory
        attributes:
          - HeapMemoryUsage.Committed
          - HeapMemoryUsage.Init
          - HeapMemoryUsage.Max
          - HeapMemoryUsage.Used
          - NonHeapMemoryUsage.Committed
          - NonHeapMemoryUsage.Init
          - NonHeapMemoryUsage.Max
          - NonHeapMemoryUsage.Used
      - query: type=Threading
        attributes:
          - ThreadCount
          - TotalStartedThreadCount
      - query: type=ClassLoading
        attributes:
          - LoadedClassCount
      - query: type=Compilation
        attributes:
          - TotalCompilationTime
  - domain: org.apache.activemq 
    event_type: JVMSampleActiveMQ 
    beans: 
      - query: type=Broker,brokerName=* 
        attributes: 
          - AverageMessageSize 
          - Brokerid 
          - BrokerName 
          - BrokerVersion 
          - CurrentConnectionscount 
          - DataDirectory 
          - DurableTopicSubscribers 
          - DynamicDestinationProducers 
          - InactiveDurable 
          - Topic 
          - Subscribers 
          - JMS 
          - JobScheduler 
          - JobschedulerStorelimit 
          - JobSchedulerStorePercentUsage 
          - MaxMessageSize 
          - Memorylimit 
          - MemoryPercentUsage 
          - MinMessageSize 
          - Persistent 
          - Queue 
          - Producers 
          - QueueSubscribers
          - Queues
          - slave
          - StatisticsEnabled
          - StoreLimit 
          - StorePercentUsage 
          - Templimit 
          - TempPercentUsage 
          - TemporaryQueue 
          - Producers 
          - TemporaryQueueSubscribers 
          - TemporaryQueues 
          - TemporaryTopicProducers 
          - TemporaryTopicSubscribers 
          - TemporaryTopics 
          - TopicProducers 
          - TopicSubscribers 
          - Topics 
          - TotalConnectionsCount 
          - TotalConsumerCount 
          - TotalDequeueCount 
          - TotalEnqueueCount 
          - TotalMessageCount 
          - TotalProducerCount 
          - TransportConnectors 
          - Uptime 
          - UptimeMills
      - query: type=Broker,brokerName=YOUR_BROKER_NAME,destinationType=Topic,destinationName=YOUR_TOPIC_NAME 
        attributes: 
          - AlwaysRetroactive 
          - AverageBlockedTime
          - AverageEnqueueTime
          - AverageMessageSize
          - BlockedSends
          - BlockedProducerWarningInterval
          - ConsumerCount
          - DequeueCount
          - DispatchCount
          - DLQ
          - EnqueueCount
          - ExpiredCount
          - ForwardCount
          - InFlightCount
          - MaxAuditDepth
          - MaxEnqueueTime
          - MaxMessageSize
          - MaxPageSize
          - MaxProducersToAudit
          - MemoryLimit
          - MemoryPercentUsage
          - MemoryUsageByteCount
          - MemoryUsagePortion
          - MinEnqueueTime
          - MinMessageSize
          - Name
          - Options
          - PrioritizedMessages
          - ProducerCount
          - ProducerFlowControl
          - QueueSize
          - SlowConsumerStrategy
          - StoreMessageSize
          - Subscriptions
          - TotalBlockedTime
          - useCache
      - query: type=Broker,brokerName=YOUR_BROKER_NAME,destinationType=Queue,destinationName=YOUR_QUEUE_NAME 
        attributes: 
          - CacheEnabled 
          - Paused 
          - CursorFull
          - CursorMemoryUsage
          - CursorPercentUsage
          - MessageGroups
          - MessageGroupType 
          - MemoryLimit 
          - Name
          - Options
          - QueueSize
          - ProducerCount
          - ConsumerCount
          - EnqueueCount
          - DequeueCount
          - ForwardCount
          - MemoryPercentUsage
          - InFlightCount
          - DLQ
          - MaxMessageSize
          - SlowConsumerStrategy
          - PrioritizedMessages
          - AverageMessageSize
          - MinMessageSize
          - ProducerFlowControl
          - MaxAuditDepth
          - AlwaysRetroactive
          - BlockedProducerWarningInterval
          - MaxProducersToAudit
          - MaxPageSize
          - UseCache
          - BlockedSends
          - MinEnqueueTime
          - MaxEnqueueTime
          - StoreMessageSize
          - MemoryUsageByteCount
          - AverageEnqueueTime
          - MemoryUsagePortion
          - Subscriptions
          - AverageBlockedTime
          - TotalBlockedTime
          - DispatchCount
          - ExpiredCount

With your monitoring environment set up, forward your ActiveMQ logs to New Relic. To forward logs:

Go to file path: /etc/newrelic-infra/logging.d/logging.yml
Add this snippet to the end of the file. Make sure the indentation is correctly matched with the existing file
```
- name: activemq.log
  file: /opt/activemq/data/activemq.log
  attributes:
    logtype: activemq-log
```

Get ActiveMQ metrics in a dashboard

Once you've installed the ActiveMQ quickstart, you can see your critical ActiveMQ data in New Relic using our pre-built dashboard.

Explore on one.newrelic.com using NRQL the metrics stored on the event_type.

Example query:

FROM JVMSampleActiveMQ SELECT latest(TotalProducerCount), latest(TotalConsumerCount)

What's next?

To learn more about building NRQL queries and generating dashboards, check out these docs:

Introduction to the query builder to create basic and advanced queries.
Introduction to dashboards to customize your dashboard and carry out different actions.
Manage your dashboard to adjust your display mode, or to add more content to your dashboard.

Monitor ActiveMQ with the JMX integration

Install the JMX integration

Configure the JMX integration for ActiveMQ

Step 1. Update the `jmx-config.yml` file with the JMX service

Step 2. Update the `jvm-metrics.yml` with ActiveMQ metric names

Step 3. Forward your ActiveMQ logs

Step 4. Restart infrastructure agent

Get ActiveMQ metrics in a dashboard

What's next?

Monitor ActiveMQ with the JMX integration

Install the JMX integration .css-21sua1{background:none;border:none;width:0;padding:0;}

Configure the JMX integration for ActiveMQ

Step 2. Update the `jvm-metrics.yml` with ActiveMQ metric names

Step 3. Forward your ActiveMQ logs

Step 4. Restart infrastructure agent

Get ActiveMQ metrics in a dashboard

What's next?

Install the JMX integration