All Products
Search
Document Center

ApsaraMQ for Kafka:Prometheus monitoring

Last Updated:Mar 11, 2026

Alibaba Cloud Prometheus Service enables you to collect, store, and view monitoring data of Alibaba Cloud services in a unified manner. Prometheus Service also provides Grafana dashboards and alerts for cloud services.

This topic describes the metrics supported in Prometheus Service and how to use Prometheus Service with ApsaraMQ for Kafka. You can view monitoring data from the ApsaraMQ for Kafka console, the Managed Service for Grafana console, or a self-managed Grafana system.

Metrics

Metrics are organized by scope: instance, topic, and consumer group. The following tables list each metric name, description, and unit.

Instance metrics

Metric nameDescriptionUnit
instance_message_inputInbound message throughput (production traffic)bytes/s
instance_message_outputOutbound message throughput (consumption traffic)bytes/s
instance_reqs_inputRate of produce requestsrequests/s
instance_message_num_inputRate of messages producedmessages/second
instance_reqs_outputRate of consume requestsrequests/s
instance_disk_capacityDisk usage%
instance_tcp_numTCP connections per nodeItem
instance_tcp_num_sumTotal TCP connections across all nodesunit
instance_public_tcp_numInternet TCP connections per nodeItem
instance_public_tcp_num_sumTotal Internet TCP connections across all nodesUnit

Topic metrics

Metric nameDescriptionUnit
topic_message_inputInbound message throughput (production traffic)bytes/s
topic_message_outputOutbound message throughput (consumption traffic)bytes/s
topic_reqs_inputRate of produce requestsrequests/s
topic_reqs_outputRate of consume requestsrequests/s
topic_message_num_inputRate of messages producedmessages/second

Consumer group metrics

Metric nameDescriptionUnit
message_accumulationTotal number of accumulated messagesItems
message_accumulation_onetopicNumber of accumulated messages in a topicItems
rebalance_generationNumber of rebalances triggeredCount
group_message_num_outputTotal consumption ratemessages/second
group_message_num_output_onetopicConsumption rate for a single topicmessages/second
group_message_num_output_onetopic_onepartitionConsumption rate for a single partitionmessages/second

View monitoring data in the ApsaraMQ for Kafka console

  1. Log on to the ApsaraMQ for Kafka console.

  2. On the Overview page, select a region in the Resource Distribution section.

  3. On the Instances page, click the name of the target instance.

  4. In the left-side navigation pane, choose Observability > Prometheus Monitoring.

  5. On the Prometheus Monitoring page, select a time range in the upper-right corner.

    To view metrics for a specific topic or consumer group, go to the details page of that topic or consumer group and click the Prometheus Monitoring tab.

View monitoring data in Grafana

  1. Log on to the Managed Service for Grafana console.

  2. In the left-side navigation pane, click Workspace Management.

  3. On the Workspace Management page, click the URL of the target workspace to open Grafana.

  4. Locate and open the ApsaraMQ for Kafka dashboard. The navigation path depends on your Grafana version.

    Grafana 9.x

    1. In the left-side navigation pane, click the Browse icon icon, and then click Browse.

    2. On the Browse tab, click a dashboard in the target folder.

      Example: To view instance-level data for the China (Hangzhou) region, open the kafka-instance dashboard in the folder named cloud-product-prometheus_cn-hangzhou.

    Grafana 10.x

    1. In the upper-left corner of the Grafana homepage, click the Menu icon icon.

    2. In the left-side navigation pane, click Dashboard, and then click a dashboard in the target folder.

      Example: To view instance-level data for the China (Hangzhou) region, open the kafka-instance dashboard in the folder named cloud-product-prometheus_cn-hangzhou.

Export metrics to a self-managed Grafana system

All ApsaraMQ for Kafka metric data is stored in Alibaba Cloud Managed Service for Prometheus. To import this data into a self-managed Grafana system, use the API operations provided by Managed Service for Prometheus.

For detailed steps, see Import data from Managed Service for Prometheus to a local Grafana system.