Kafka Configs Kafka Protocol Wire Format API Versions KIPs Errors Kafka Upgrade Config Advisor Flink SQL
conduktor.io ↗

Kafka ShareGroupHeartbeat Response Wire Format v1 — Binary Protocol Layout

What is ShareGroupHeartbeat?

Maintains membership in a share group (KIP-932), where multiple consumers read from the same partitions cooperatively with each record delivered to exactly one consumer. Unlike classic consumer groups, partitions aren't exclusively assigned; the broker tracks delivery state per record range.

Related Errors

COORDINATOR_NOT_AVAILABLE · GROUP_AUTHORIZATION_FAILED · INVALID_REQUEST · TOPIC_AUTHORIZATION_FAILED · UNSUPPORTED_VERSION

Wire Diagram

Response Header · flexible
message_size int32 · 4B
correlation_id int32 · 4B
tagged var
ShareGroupHeartbeatResponse v1
ThrottleTimeMs int32 · 4B
ErrorCode int16 · 2B
ErrorMessage? string (compact)
MemberId? string (compact)
MemberEpoch int32 · 4B
HeartbeatIntervalMs int32 · 4B
Assignment? struct
tagged var
TopicPartitions array
tagged var
TopicId uuid · 16B
Partitions []int32
tagged var

Schema & Example

Schema
{
  "ThrottleTimeMs": int32,
  "ErrorCode": int16,
  "ErrorMessage": string?,
  "MemberId": string?,
  "MemberEpoch": int32,
  "HeartbeatIntervalMs": int32,
  "Assignment": {
    "TopicPartitions": [{
        "TopicId": uuid,
        "Partitions": [int32]
    }]
  }?
}
Example
{
  "ThrottleTimeMs": 0,
  "ErrorCode": 0,
  "ErrorMessage": "NETWORK_EXCEPTION",
  "MemberId": "consumer-1-abc123",
  "MemberEpoch": 12,
  "HeartbeatIntervalMs": 3000,
  "Assignment": {
    "TopicPartitions": [{
        "TopicId": "550e8400-e29b-41d4-a716-446655440000",
        "Partitions": [1, 2, 3]
    }]
  }?
}