# Share Consumer Metrics ## Client metrics The following client metrics are available for monitoring share consumer applications. ### Share consumer metrics These metrics track the overall performance and behavior of share consumer clients. #### last-poll-seconds-ago MBean: `kafka.consumer:type=consumer-share-metrics,client-id=([-.w]+),name=last-poll-seconds-ago` : The number of seconds since the last `poll()` invocation. #### time-between-poll-avg MBean: `kafka.consumer:type=consumer-share-metrics,client-id=([-.w]+),name=time-between-poll-avg` : The average delay between invocations of `poll()` in milliseconds. #### time-between-poll-max MBean: `kafka.consumer:type=consumer-share-metrics,client-id=([-.w]+),name=time-between-poll-max` : The maximum delay between invocations of `poll()` in milliseconds. #### poll-idle-ratio-avg MBean: `kafka.consumer:type=consumer-share-metrics,client-id=([-.w]+),name=poll-idle-ratio-avg` : The average fraction of time the consumer’s `poll()` is idle as opposed to waiting for user code to process records. ### Share coordinator metrics These metrics track share consumer coordination activities, including heartbeats and rebalancing. #### heartbeat-response-time-max MBean: `kafka.consumer:type=consumer-share-coordinator-metrics,client-id=([-.w]+),name=heartbeat-response-time-max` : The maximum time taken to receive a response to a heartbeat request in milliseconds. #### heartbeat-rate MBean: `kafka.consumer:type=consumer-share-coordinator-metrics,client-id=([-.w]+),name=heartbeat-rate` : The number of heartbeats per second. #### heartbeat-total MBean: `kafka.consumer:type=consumer-share-coordinator-metrics,client-id=([-.w]+),name=heartbeat-total` : The total number of heartbeats. #### last-heartbeat-seconds-ago MBean: `kafka.consumer:type=consumer-share-coordinator-metrics,client-id=([-.w]+),name=last-heartbeat-seconds-ago` : The number of seconds since the last coordinator heartbeat was sent. #### rebalance-total MBean: `kafka.consumer:type=consumer-share-coordinator-metrics,client-id=([-.w]+),name=rebalance-total` : The total number of rebalance events. #### rebalance-rate-per-hour MBean: `kafka.consumer:type=consumer-share-coordinator-metrics,client-id=([-.w]+),name=rebalance-rate-per-hour` : The number of rebalance events per hour. ### Share fetch manager metrics These metrics track fetch operations, record consumption, and acknowledgements for share consumers. #### fetch-size-avg MBean: `kafka.consumer:type=consumer-share-fetch-manager-metrics,client-id=([-.w]+),name=fetch-size-avg` : The average number of bytes fetched per request. #### fetch-size-max MBean: `kafka.consumer:type=consumer-share-fetch-manager-metrics,client-id=([-.w]+),name=fetch-size-max` : The maximum number of bytes fetched per request. #### bytes-consumed-rate MBean: `kafka.consumer:type=consumer-share-fetch-manager-metrics,client-id=([-.w]+),name=bytes-consumed-rate` : The average number of bytes fetched per second. #### bytes-consumed-total MBean: `kafka.consumer:type=consumer-share-fetch-manager-metrics,client-id=([-.w]+),name=bytes-consumed-total` : The total number of bytes fetched. #### records-per-request-avg MBean: `kafka.consumer:type=consumer-share-fetch-manager-metrics,client-id=([-.w]+),name=records-per-request-avg` : The average number of records in each request. When set to `batch_optimized` (default), this value may exceed `max.poll.records` to align with batch boundaries. When `share.acquire.mode` is set to `record_limit`, this value will not exceed `max.poll.records`. #### records-per-request-max MBean: `kafka.consumer:type=consumer-share-fetch-manager-metrics,client-id=([-.w]+),name=records-per-request-max` : The maximum number of records in a request. When set to `batch_optimized` (default), this value may exceed `max.poll.records` to align with batch boundaries. When `share.acquire.mode` is set to `record_limit`, this value will not exceed `max.poll.records`. #### records-consumed-rate MBean: `kafka.consumer:type=consumer-share-fetch-manager-metrics,client-id=([-.w]+),name=records-consumed-rate` : The average number of records fetched per second. #### records-consumed-total MBean: `kafka.consumer:type=consumer-share-fetch-manager-metrics,client-id=([-.w]+),name=records-consumed-total` : The total number of records fetched. #### acknowledgements-send-rate MBean: `kafka.consumer:type=consumer-share-fetch-manager-metrics,client-id=([-.w]+),name=acknowledgements-send-rate` : The average number of record acknowledgements sent per second. #### acknowledgements-send-total MBean: `kafka.consumer:type=consumer-share-fetch-manager-metrics,client-id=([-.w]+),name=acknowledgements-send-total` : The total number of record acknowledgements sent. #### acknowledgements-error-rate MBean: `kafka.consumer:type=consumer-share-fetch-manager-metrics,client-id=([-.w]+),name=acknowledgements-error-rate` : The average number of record acknowledgements that resulted in errors per second. #### acknowledgements-error-total MBean: `kafka.consumer:type=consumer-share-fetch-manager-metrics,client-id=([-.w]+),name=acknowledgements-error-total` : The total number of record acknowledgements that resulted in errors. #### fetch-latency-avg MBean: `kafka.consumer:type=consumer-share-fetch-manager-metrics,client-id=([-.w]+),name=fetch-latency-avg` : The average time taken for a fetch request in milliseconds. #### fetch-latency-max MBean: `kafka.consumer:type=consumer-share-fetch-manager-metrics,client-id=([-.w]+),name=fetch-latency-max` : The maximum time taken for any fetch request in milliseconds. #### fetch-rate MBean: `kafka.consumer:type=consumer-share-fetch-manager-metrics,client-id=([-.w]+),name=fetch-rate` : The number of fetch requests per second. #### fetch-total MBean: `kafka.consumer:type=consumer-share-fetch-manager-metrics,client-id=([-.w]+),name=fetch-total` : The total number of fetch requests. #### fetch-throttle-time-avg MBean: `kafka.consumer:type=consumer-share-fetch-manager-metrics,client-id=([-.w]+),name=fetch-throttle-time-avg` : The average throttle time in milliseconds. #### fetch-throttle-time-max MBean: `kafka.consumer:type=consumer-share-fetch-manager-metrics,client-id=([-.w]+),name=fetch-throttle-time-max` : The maximum throttle time in milliseconds.