Support ActiveMQ classic Monitoring

Motivation

Apache ActiveMQ Classic is a popular and powerful open source messaging and Integration Patterns server. It supports many Cross Language Clients and Protocols, comes with easy to use Enterprise Integration Patterns and many advanced features.

Now I want to add ActiveMQ Classic monitoring via the OpenTelemetry Collector which fetches metrics from jmx prometheus exporter run as a Java Agent.

Architecture Graph

There is no significant architecture-level change.

Proposed Changes

Apache ActiveMQ Classic has extensive support for JMX to allow you to monitor and control the behavior of the broker via the JMX MBeans.

Jmx prometheus exporter collects metrics data from ActiveMQ classic, this exporter is intended to be run as a Java Agent, exposing a HTTP server and serving metrics of the local JVM.

Using openTelemetry receiver to fetch these metrics to SkyWalking OAP server.

ActiveMQ Cluster Supported Metrics

Monitoring Panel Unit Metric Name Description Data Source
System Load Average Count meter_activemq_cluster_system_load_average The average system load, range:[0, 10000]. JMX Prometheus Exporter
Thread Count Count meter_activemq_cluster_thread_count Threads currently used by the JVM. JMX Prometheus Exporter
Init Heap Memory Usage Bytes meter_activemq_cluster_heap_memory_usage_init The initial amount of heap memory available. JMX Prometheus Exporter
Committed Heap Memory Usage Bytes meter_activemq_cluster_heap_memory_usage_committed The memory is guaranteed to be available for the JVM to use. JMX Prometheus Exporter
Used Heap Memory Usage Bytes meter_activemq_cluster_heap_memory_usage_used The amount of JVM heap memory currently in use. JMX Prometheus Exporter
Max Heap Memory Usage Bytes meter_activemq_cluster_heap_memory_usage_max The maximum possible size of the heap memory. JMX Prometheus Exporter
GC G1 Old Collection Count Count meter_activemq_cluster_gc_g1_old_collection_count The gc count of G1 Old Generation(JDK[9,17]). JMX Prometheus Exporter
GC G1 Young Collection Count Count meter_activemq_cluster_gc_g1_young_collection_count The gc count of G1 Young Generation(JDK[9,17]). JMX Prometheus Exporter
GC G1 Old Collection Time ms meter_activemq_cluster_gc_g1_old_collection_time The gc time spent in G1 Old Generation in milliseconds(JDK[9,17]). JMX Prometheus Exporter
GC G1 Young Collection Time ms meter_activemq_cluster_gc_g1_young_collection_time The gc time spent in G1 Young Generation in milliseconds(JDK[9,17]). JMX Prometheus Exporter
GC Parallel Old Collection Count Count meter_activemq_cluster_gc_parallel_old_collection_count The gc count of Parallel Old Generation(JDK[6,8]). JMX Prometheus Exporter
GC Parallel Young Collection Count Count meter_activemq_cluster_gc_parallel_young_collection_count The gc count of Parallel Young Generation(JDK[6,8]). JMX Prometheus Exporter
GC Parallel Old Collection Time ms meter_activemq_cluster_gc_parallel_old_collection_time The gc time spent in Parallel Old Generation in milliseconds(JDK[6,8]). JMX Prometheus Exporter
GC Parallel Young Collection Time ms meter_activemq_cluster_gc_parallel_young_collection_time The gc time spent in Parallel Young Generation in milliseconds(JDK[6,8]). JMX Prometheus Exporter
Enqueue Rate Count/s meter_activemq_cluster_enqueue_rate Number of messages that have been sent to the cluster per second(JDK[6,8]). JMX Prometheus Exporter
Dequeue Rate Count/s meter_activemq_cluster_dequeue_rate Number of messages that have been acknowledged or discarded on the cluster per second. JMX Prometheus Exporter
Dispatch Rate Count/s meter_activemq_cluster_dispatch_rate Number of messages that has been delivered to consumers per second. JMX Prometheus Exporter
Expired Rate Count/s meter_activemq_cluster_expired_rate Number of messages that have been expired per second. JMX Prometheus Exporter
Average Enqueue Time ms meter_activemq_cluster_average_enqueue_time The average time a message was held on this cluster. JMX Prometheus Exporter
Max Enqueue Time ms meter_activemq_cluster_max_enqueue_time The max time a message was held on this cluster. JMX Prometheus Exporter

ActiveMQ Broker Supported Metrics

Monitoring Panel Unit Metric Name Description Data Source
Uptime sec meter_activemq_broker_uptime Uptime of the broker in day. JMX Prometheus Exporter
State meter_activemq_broker_state If slave broker 1 else 0. JMX Prometheus Exporter
Current Connections Count meter_activemq_broker_current_connections The number of clients connected to the broker currently. JMX Prometheus Exporter
Current Producer Count Count meter_activemq_broker_current_producer_count The number of producers currently attached to the broker. JMX Prometheus Exporter
Current Consumer Count Count meter_activemq_broker_current_consumer_count The number of consumers consuming messages from the broker. JMX Prometheus Exporter
Producer Count Count meter_activemq_broker_producer_count Number of message producers active on destinations. JMX Prometheus Exporter
Consumer Count Count meter_activemq_broker_consumer_count Number of message consumers subscribed to destinations. JMX Prometheus Exporter
Enqueue Count Count meter_activemq_broker_enqueue_count The total number of messages sent to the broker. JMX Prometheus Exporter
Dequeue Count Count meter_activemq_broker_dequeue_count The total number of messages the broker has delivered to consumers. JMX Prometheus Exporter
Enqueue Rate Count/sec meter_activemq_broker_enqueue_rate The total number of messages sent to the broker per second. JMX Prometheus Exporter
Dequeue Rate Count/sec meter_activemq_broker_dequeue_rate The total number of messages the broker has delivered to consumers per second. JMX Prometheus Exporter
Memory Percent Usage % meter_activemq_broker_memory_percent_usage Percentage of configured memory used by the broker. JMX Prometheus Exporter
Memory Usage Bytes meter_activemq_broker_memory_percent_usage Memory used by undelivered messages in bytes. JMX Prometheus Exporter
Memory Limit Bytes meter_activemq_broker_memory_limit Memory limited used for holding undelivered messages before paging to temporary storage. JMX Prometheus Exporter
Store Percent Usage % meter_activemq_broker_store_percent_usage Percentage of available disk space used for persistent message storage. JMX Prometheus Exporter
Store Limit Bytes meter_activemq_broker_store_limit Disk limited used for persistent messages before producers are blocked. JMX Prometheus Exporter
Temp Percent Usage Bytes meter_activemq_broker_temp_percent_usage Percentage of available disk space used for non-persistent message storage. JMX Prometheus Exporter
Temp Limit Bytes meter_activemq_broker_temp_limit Disk limited used for non-persistent messages and temporary data before producers are blocked. JMX Prometheus Exporter
Average Message Size Bytes meter_activemq_broker_average_message_size Average message size on this broker. JMX Prometheus Exporter
Max Message Size Bytes meter_activemq_broker_max_message_size Max message size on this broker. JMX Prometheus Exporter
Queue Size Count meter_activemq_broker_queue_size Number of messages on this broker that have been dispatched but not acknowledged. JMX Prometheus Exporter

ActiveMQ Destination Supported Metrics

Monitoring Panel Unit Metric Name Description Data Source
Producer Count Count meter_activemq_destination_producer_count Number of producers attached to this destination. JMX Prometheus Exporter
Consumer Count Count meter_activemq_destination_consumer_count Number of consumers subscribed to this destination. JMX Prometheus Exporter
Topic Consumer Count Count meter_activemq_destination_topic_consumer_count Number of consumers subscribed to the topics. JMX Prometheus Exporter
Queue Size Count meter_activemq_destination_queue_size The number of messages that have not been acknowledged by a consumer. JMX Prometheus Exporter
Memory Usage Bytes meter_activemq_destination_memory_usage Memory used by undelivered messages in bytes. JMX Prometheus Exporter
Memory Percent Usage % meter_activemq_destination_memory_percent_usage Percentage of configured memory used by the destination. JMX Prometheus Exporter
Enqueue Count Count meter_activemq_destination_enqueue_count The number of messages sent to the destination. JMX Prometheus Exporter
Dequeue Count Count meter_activemq_destination_dequeue_count The number of messages the destination has delivered to consumers. JMX Prometheus Exporter
Average Enqueue Time ms meter_activemq_destination_average_enqueue_time The average time a message was held on this destination. JMX Prometheus Exporter
Max Enqueue Time ms meter_activemq_destination_max_enqueue_time The max time a message was held on this destination. JMX Prometheus Exporter
Dispatch Count Count meter_activemq_destination_dispatch_count Number of messages that has been delivered to consumers. JMX Prometheus Exporter
Expired Count Count meter_activemq_destination_expired_count Number of messages that have been expired. JMX Prometheus Exporter
Inflight Count Count meter_activemq_destination_inflight_count Number of messages that have been dispatched to but not acknowledged by consumers. JMX Prometheus Exporter
Average Message Size Bytes meter_activemq_destination_average_message_size Average message size on this destination. JMX Prometheus Exporter
Max Message Size Bytes meter_activemq_destination_max_message_size Max message size on this destination. JMX Prometheus Exporter

Imported Dependencies libs and their licenses.

No new dependency.

Compatibility

no breaking changes.

General usage docs