Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This KIP builds upon KIP-932, which introduced the concept of Queues/Cooperative Consumption in Kafka. KIP-932 implementation introduced Share Group, Share Partitions and Delayed Share Fetch purgatory to enable this cooperative consumption behavior. The proposed metrics in this KIP are broker metrics which will enhance the debugging and monitoring capabilities for cooperative consumption. By providing a more granular view of the underlying mechanisms, these broker metrics will aid in identifying and resolving potential issues and optimizing performance.

Public Interfaces

RationaleMetric NameTypeGroupTagsDescriptionJMX Bean
Similar to existing fetch metric TotalFetchRequestsPerSec  for Fetch, which record all topic cumulative and individual topic stats.TotalShareFetchRequestsPerSecMeter
ShareGroupMetrics
BrokerTopicMetricstopic:
{topic}
([-.\w]+)The fetch request rate per second.

kafka.server:type=ShareGroupMetrics,name=TotalShareFetchRequestsPerSec

kafka.server:type=ShareGroupMetrics,name=TotalShareFetchRequestsPerSec,topic={topic}

Similar to existing fetch metric FailedFetchRequestsPerSec  for Fetch, which record all topic cumulative and individual topic stats.FailedShareFetchRequestsPerSecMeter
ShareGroupMetrics
BrokerTopicMetricstopic:
{topic}
([-.\w]+)The share fetch request rate for requests that failed.

kafka.server:type=ShareGroupMetrics,name=FailedShareFetchRequestsPerSec

kafka.server:type=ShareGroupMetrics,name=FailedShareFetchRequestsPerSec

,topic={topic}Similar to above defined share fetch metrics, this metirc tracks the number of share release requests stats.TotalShareReleaseRequestsPerSecMeterShareGroupMetricstopic:{topic}The share release request rate per second.

kafka.server:type=ShareGroupMetrics,name=TotalShareReleaseRequestsPerSec

kafka.server:type=ShareGroupMetrics,name=TotalShareReleaseRequestsPerSec,topic={topic}

Similar to above defined failed fetch metrics, this metirc tracks the number of failed share release requests stats.FailedShareReleaseRequestsPerSecMeterShareGroupMetricstopic:{topic}The share release request rate for requests that failed

kafka.server:type=ShareGroupMetrics,name=FailedShareReleaseRequestsPerSec

kafka.server:type=ShareGroupMetrics,name=FailedShareReleaseRequestsPerSec

,topic={topic}

Similar to above defined failed fetch metrics, this metirc tracks the number of failed share acknowledgement requests stats.FailedShareAcknowledgementRequestsPerSecMeter
ShareGroupMetrics
BrokerTopicMetricstopic:
{topic}
([-.\w]+)The share acknowledgement request rate for requests that failed

kafka.server:type=ShareGroupMetrics,name=FailedShareAcknowledgementRequestsPerSec

kafka.server:type=ShareGroupMetrics,name=FailedShareAcknowledgementRequestsPerSec,topic={topic}

In shared consumption, topic-partitions are locked before fetching data to ensure exclusive access for each share fetch request. Multiple consumers can request the same partitions, but only a subset can acquire locks.

This metric represents the ratio of successfully fetched topic-partitions to the total requested in a share fetch. A low ratio indicates that many requests are unable to fetch from a significant portion of the requested partitions.

Potential Causes for Low Ratios:

  • High Share Consumer Count: A large number of share consumers can lead to increased competition for partitions.
  • Strict Locks Limit: A low group.share.partition.max.record.locks value can exclude partition a share consumer can acquire, if reached.
  • Fewer Topic Partitions: Fewer partitions can intensify competition, especially with a high share consumer count.
  • Suboptimal Partition Assignments: Inefficient assignments can hinder efficient consumption.

This metric, in conjunction with other metrics and configuration parameters, can help optimize shared consumption by adjusting consumer counts, partition limits, and partition assignments.

RequestTopicPartitionsFetchRatioMeterShareGroupMetrics

The ratio of topic-partitions acquired to the total number of topic-partitions in share fetch request.

kafka.server:type=ShareGroupMetrics,name=RequestTopicPartitionsFetchRatio

Example:

If the metric reports low values and:

  • InFlightMessageCount is high: Consider increasing group.share.partition.max.record.locks to allow more locks per share partition.
  • InFlightMessageCount is not high: Consider pptimizing partition assignments for cooperative consumption. If assignments are optimal and lock contention persists, increasing topic partitions or reducing the number of share consumers might improve performance.
  • If the aforementioned optimizations have been implemented, further investigation should focus on the time taken to complete log fetches and acquire records. This includes the duration for which the fetch lock is held. The FetchLockTimeMs metric provides the total time spent in this process. High values indicate potential optimization opportunities in the efficiency of fetching and acquiring messages.
RequestTopicPartitionsFetchRatioHistogramShareGroupMetrics

The ratio of topic-partitions acquired to the total number of topic-partitions in share fetch request

Specifies the number of share fetch requests where no topic-partition can be acquired for fetch.RequestTopicPartitionsFetchEmptyCountGaugeShareGroupMetricsThe number of share fetch requests completed without any acquired topic-partition

.

kafka.server:type=ShareGroupMetrics,name=
RequestTopicPartitionsFetchEmptyCount
RequestTopicPartitionsFetchRatio
Tracks the number of client timeouts acknowledging share fetches. Timeout is set by group.share.record.lock.duration.ms.AcquisitionLockTimeoutCount
Gauge
MeterSharePartitionMetricsshare-partition : {group-topic-partition}

The number of times acquisition lock timed out for share partition.

kafka.server:type=SharePartitionMetrics,name=AcquisitionLockTimeoutCount,share-partition={group-topic-partition}
Defines the maximum number of in-flight messages per share partition, as set by group.share.partition.max.record.locks. A share partition cannot be acquired for fetching messages if this limit is reached.InFlightMessageCount
Gauge
MeterSharePartitionMetricsshare-partition : {group-topic-partition}

The number of in-flight messages for the share partition.

kafka.server:type=SharePartitionMetrics,name=InFlightMessageCount,share-partition={group-topic-partition}
Specifies the number of batches currently being processed by a share partition. This metric provides insights into memory consumption and performance bottlenecks, aiding in optimization efforts.InFlightBatchCountGaugeSharePartitionMetricsshare-partition : {group-topic-partition}

The number of in-flight batches for the share partition.

kafka.server:type=SharePartitionMetrics,name=InFlightBatchCount,share-partition={group-topic-partition}
Specifies the number of messages in a single in-flight batch.InFlightBatchMessageCount
Gauge
HistogramSharePartitionMetricsshare-partition : {group-topic-partition}

The number of messages in the in-flight batch.

kafka.server:type=SharePartitionMetrics,name=InFlightBatchMessageCount,share-partition={group-topic-partition}
Tracks the duration of fetch lock acquisitions.FetchLockTimeMsMeterSharePartitionMetricsshare-partition : {group-topic-partition}

The time elapsed (in milliseconds) while a share partition is held under lock for fetching messages.

kafka.server:type=SharePartitionMetrics,name=FetchLockTimeMs,share-partition={group-topic-partition}
Similar to IncrementalFetchSessionEvictionsPerSec ShareSessionEvictionsPerSecMeterShareSessionCache

The share session eviction rate per second.

kafka.server:type=ShareSessionCache,name=ShareSessionEvictionsPerSec
Similar to NumIncrementalFetchPartitionsCached SharePartitionsCountGaugeShareSessionCache

The number of cached share partitions.

kafka.server:type=ShareSessionCache,name=SharePartitionsCount
Similar to NumIncrementalFetchSessions ShareSessionsCountGaugeShareSessionCache

The number of cached share sessions.

kafka.server:type=ShareSessionCache,name=ShareSessionsCount
Similar to ExpiresPerSec  for other existing delayed operations i.e. DelayedFetch , etc.ExpiresPerSecMeterDelayedShareFetchMetrics

The expired delayed share fetch operation rate per second.

kafka.server:type=DelayedShareFetchMetrics,name=ExpiresPerSec
Add ShareFetch  to existing MessageConversionsPerSec metric.

MessageConversionsPerSec

(ShareFetch added to existing metric for Produce and Fetch)

MeterBrokerTopicMetricstopic:
{topic}
([-.\w]+)

The message format conversion rate, for Produce, Fetch or ShareFetch requests, per topic. Omitting ‘topic={…}’ will yield the all-topic rate.

kafka.server:type=BrokerTopicMetrics,name={Produce|Fetch|ShareFetch}MessageConversionsPerSec,topic=([-.\w]+)
Add ShareFetch  to existing purgatory metrics.PurgatorySize (ShareFetch)GaugeDelayedOperationPurgatorydelayedOperation : ShareFetch

The number of requests waiting in the share fetch purgatory. This is high if share consumers use a large value for fetch.wait.max.ms

kafka.server:type=DelayedOperationPurgatory,delayedOperation=ShareFetch,name=PurgatorySize
Add ShareFetch  to existing purgatory metrics.NumDelayedOperations (ShareFetch)GaugeDelayedOperationPurgatorydelayedOperation : ShareFetch

The number of delayed operations for share fetch purgatory.

kafka.server:type=DelayedOperationPurgatory,delayedOperation=ShareFetch,name=NumDelayedOperations

Move share-group-metrics  defined in KIP-932 to Yammer based metrics.

...