Project: SkyWalking (Observability and Analysis / Observability)
File: backend-activemq-monitoring.md

SkyWalking leverages jmx prometheus exporter for collecting metrics data from ActiveMQ classic. It leverages OpenTelemetry Collector to transfer the metrics to and into the . ActiveMQ classic has extensive support for JMX to allow you to monitor and control the behavior of the broker via the JMX MBeans. The 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. OpenTelemetry Collector fetches metrics from jmx prometheus exporter via Prometheus Receiver and pushes metrics to SkyWalking OAP Server via OpenTelemetry gRPC exporter. The SkyWalking OAP Server parses the expression with to filter/calculate/aggregate and store the results. in `activemq.xml`, the JMX remote port defaults to `1616`, you can change it through `ACTIVEMQSUNJMXSTART`. The example for ActiveMQ configuration, refer to . Set up which runs as a Java Agent(recommended) of ActiveMQ classic. If you work with docker, you also can set up for exporter, refer to (note the configuration of `includeObjectNames`). Set up . The example for OpenTelemetry Collector configuration, refer to . Config SkyWalking . ActiveMQ classic monitoring provides multidimensional metrics monitoring of ActiveMQ Exporter as `Layer: ActiveMQ` `Service` in the OAP. In each cluster, the broker is represented as `Instance` and the destination is represented as `Endpoint`. | Monitoring Panel |Unit | Metric Name | Description | Data Source | |--||-||-| | System Load Average | Count | meteractivemqclustersystemload_average | The average system load, range:[0, 10000]. | JMX Prometheus Exporter | | Thread Count | Count | meteractivemqclusterthreadcount | Threads currently used by the JVM. | JMX Prometheus Exporter | | Init Heap Memory Usage | Bytes | meteractivemqclusterheapmemoryusageinit | The initial amount of heap memory available. | JMX Prometheus Exporter | | Committed Heap Memory Usage | Bytes | meteractivemqclusterheapmemoryusagecommitted | The memory is guaranteed to be available for the JVM to use. | JMX Prometheus Exporter | | Used Heap Memory Usage | Bytes | meteractivemqclusterheapmemoryusageused | The amount of JVM heap memory currently in use. | JMX Prometheus Exporter | | Max Heap Memory Usage | Bytes | meteractivemqclusterheapmemoryusagemax | The maximum possible size of the heap memory. | JMX Prometheus Exporter | | GC G1 Old Collection Count | Count | meteractivemqclustergcg1oldcollection_count | The gc count of G1 Old Generation(JDK[9,17]). | JMX Prometheus Exporter | | GC G1 Young Collection Count | Count | meteractivemqclustergcg1youngcollection_count | The gc count of G1 Young Generation(JDK[9,17]). | JMX Prometheus Exporter | | GC G1 Old Collection Time | ms | meteractivemqclustergcg1oldcollection_time | The gc time spent in G1 Old Generation in milliseconds(JDK[9,17]). | JMX Prometheus Exporter | | GC G1 Young Collection Time | ms | meteractivemqclustergcg1youngcollection_time | The gc time spent in G1 Young Generation in milliseconds(JDK[9,17]). | JMX Prometheus Exporter | | GC Parallel Old Collection Count | Count | meteractivemqclustergcparalleloldcollection_count | The gc count of Parallel Old Generation(JDK[6,8]). | JMX Prometheus Exporter | | GC Parallel Young Collection Count | Count | meteractivemqclustergcparallelyoungcollection_count | The gc count of Parallel Young

| JMX Prometheus Exporter | | GC Parallel Old Collection Time | ms | meteractivemqclustergcparalleloldcollection_time | The gc time spent in Parallel Old Generation in milliseconds(JDK[6,8]). | JMX Prometheus Exporter | | GC Parallel Young Collection Time | ms | meteractivemqclustergcparallelyoungcollection_time | The gc time spent in Parallel Young Generation in milliseconds(JDK[6,8]). | JMX Prometheus Exporter | | Enqueue Rate | Count/s | meteractivemqclusterenqueuerate | Number of messages that have been sent to the cluster per second(JDK[6,8]). | JMX Prometheus Exporter | | Dequeue Rate | Count/s | meteractivemqclusterdequeuerate | Number of messages that have been acknowledged or discarded on the cluster per second.| JMX Prometheus Exporter | | Dispatch Rate | Count/s | meteractivemqclusterdispatchrate | Number of messages that has been delivered to consumers per second. | JMX Prometheus Exporter | | Expired Rate | Count/s | meteractivemqclusterexpiredrate | Number of messages that have been expired per second. | JMX Prometheus Exporter | | Average Enqueue Time | ms | meteractivemqclusteraverageenqueue_time | The average time a message was held on this cluster. | JMX Prometheus Exporter | | Max Enqueue Time | ms | meteractivemqclustermaxenqueue_time | The max time a message was held on this cluster. | JMX Prometheus Exporter | | Monitoring Panel |Unit | Metric Name | Description | Data Source | |--|--|-|-- |-| | Uptime | sec | meteractivemqbroker_uptime | Uptime of the broker in day. | JMX Prometheus Exporter | | State | | meteractivemqbroker_state | If slave broker 1 else 0. | JMX Prometheus Exporter | | Current Connections | Count | meteractivemqbrokercurrentconnections | The number of clients connected to the broker currently. | JMX Prometheus Exporter | | Current Producer Count | Count | meteractivemqbrokercurrentproducer_count | The number of producers currently attached to the broker. | JMX Prometheus Exporter | | Current Consumer Count | Count | meteractivemqbrokercurrentconsumer_count | The number of consumers consuming messages from the broker. | JMX Prometheus Exporter | | Producer Count | Count | meteractivemqbrokerproducercount | Number of message producers active on destinations. | JMX Prometheus Exporter | | Consumer Count | Count | meteractivemqbrokerconsumercount | Number of message consumers subscribed to destinations. | JMX Prometheus Exporter | | Enqueue Count | Count | meteractivemqbrokerenqueuecount | The total number of messages sent to the broker. | JMX Prometheus Exporter | | Dequeue Count | Count | meteractivemqbrokerdequeuecount | The total number of messages the broker has delivered to consumers. | JMX Prometheus Exporter | | Enqueue Rate | Count/sec | meteractivemqbrokerenqueuerate | The total number of messages sent to the broker per second. | JMX Prometheus Exporter | | Dequeue Rate | Count/sec | meteractivemqbrokerdequeuerate | The total number of messages the broker has delivered to consumers per second. | JMX Prometheus Exporter | | Memory Percent Usage | % | meteractivemqbrokermemorypercent_usage | Percentage of configured memory used by the broker. | JMX Prometheus Exporter | | Memory Usage | Bytes | meteractivemqbrokermemorypercent_usage | Memory used by undelivered messages in bytes. | JMX Prometheus Exporter | | Memory Limit | Bytes | meteractivemqbrokermemorylimit | Memory limited used for holding undelivered messages before paging to temporary

| JMX Prometheus Exporter | | Store Percent Usage | % | meteractivemqbrokerstorepercent_usage | Percentage of available disk space used for persistent message storage. | JMX Prometheus Exporter | | Store Limit | Bytes | meteractivemqbrokerstorelimit | Disk limited used for persistent messages before producers are blocked. | JMX Prometheus Exporter | | Temp Percent Usage | Bytes | meteractivemqbrokertemppercent_usage | Percentage of available disk space used for non-persistent message storage. | JMX Prometheus Exporter | | Temp Limit | Bytes | meteractivemqbrokertemplimit | Disk limited used for non-persistent messages and temporary data before producers are blocked. | JMX Prometheus Exporter | | Average Message Size | Bytes | meteractivemqbrokeraveragemessage_size | Average message size on this broker. | JMX Prometheus Exporter | | Max Message Size | Bytes | meteractivemqbrokermaxmessage_size | Max message size on this broker. | JMX Prometheus Exporter | | Queue Size | Count | meteractivemqbrokerqueuesize | Number of messages on this broker that have been dispatched but not acknowledged. | JMX Prometheus Exporter | | Monitoring Panel |Unit | Metric Name | Description | Data Source | |--||-|--|-| | Producer Count | Count | meteractivemqdestinationproducercount | Number of producers attached to this destination. | JMX Prometheus Exporter | | Consumer Count | Count | meteractivemqdestinationconsumercount | Number of consumers subscribed to this destination. | JMX Prometheus Exporter | | Topic Consumer Count | Count | meteractivemqdestinationtopicconsumer_count | Number of consumers subscribed to the topics. | JMX Prometheus Exporter | | Queue Size | Count | meteractivemqdestinationqueuesize | The number of messages that have not been acknowledged by a consumer. | JMX Prometheus Exporter | | Memory Usage | Bytes | meteractivemqdestinationmemoryusage | Memory used by undelivered messages in bytes. | JMX Prometheus Exporter | | Memory Percent Usage | % | meteractivemqdestinationmemorypercent_usage | Percentage of configured memory used by the destination. | JMX Prometheus Exporter | | Enqueue Count | Count | meteractivemqdestinationenqueuecount | The number of messages sent to the destination. | JMX Prometheus Exporter | | Dequeue Count | Count | meteractivemqdestinationdequeuecount | The number of messages the destination has delivered to consumers. | JMX Prometheus Exporter | | Average Enqueue Time | ms | meteractivemqdestinationaverageenqueue_time | The average time a message was held on this destination. | JMX Prometheus Exporter | | Max Enqueue Time | ms | meteractivemqdestinationmaxenqueue_time | The max time a message was held on this destination. | JMX Prometheus Exporter | | Dispatch Count | Count | meteractivemqdestinationdispatchcount | Number of messages that has been delivered to consumers. | JMX Prometheus Exporter | | Expired Count | Count | meteractivemqdestinationexpiredcount | Number of messages that have been expired. | JMX Prometheus Exporter | | Inflight Count | Count | meteractivemqdestinationinflightcount | Number of messages that have been dispatched to but not acknowledged by consumers. | JMX Prometheus Exporter | | Average Message Size | Bytes | meteractivemqdestinationaveragemessage_size | Average message size on this destination. | JMX Prometheus Exporter | | Max Message Size | Bytes | meteractivemqdestinationmaxmessage_size | Max message size on this destination. | JMX Prometheus Exporter | You can customize your own metrics/expression/dashboard panel. The metrics definition and expression rules are found in `otel-rules/activemq/activemq-cluster.yaml, otel-rules/activemq/activemq-broker.yaml, otel-rules/activemq/activemq-destination.yaml`. The ActiveMQ dashboard panel configurations are found in `ui-initialized-templates/activemq`.