What is DescribeGroups?
Returns the full state of consumer groups including per-member partition assignments, used by kafka-consumer-groups.sh --describe. PreparingRebalance means JoinGroup responses are pending; Stable means all members are heartbeating; Empty means no members but offsets may still exist.
| Version | Kafka | Changes |
|---|---|---|
| DescribeGroupsRequest | ||
| v0 | 2.2 | + Groups []string |
| v1 | 2.2 | are the same as version 0. |
| v2 | 2.2 | are the same as version 0. |
| v3 | 2.3 | + IncludeAuthorizedOperations boolauthorized operations can be requested. |
| v4 | 2.4 | the response will include group.instance.id info for members. |
| v5 | 2.4 | ~ Flexible encoding enabled FLEXIBLE is the first flexible version. |
| v6 | 4.0 | returns error code GROUP_ID_NOT_FOUND if the group ID is not found (KIP-1043). |
| DescribeGroupsResponse | ||
| v0 | 2.2 | + Groups []DescribedGroup+ ErrorCode int16+ GroupId string+ GroupState string+ ProtocolType string+ ProtocolData string+ Members []DescribedGroupMember+ MemberId string+ ClientId string+ ClientHost string+ MemberMetadata bytes+ MemberAssignment bytes |
| v1 | 2.2 | + ThrottleTimeMs int32added throttle time. |
| v2 | 2.2 | on quota violation, brokers send out responses before throttling. |
| v3 | 2.3 | + AuthorizedOperations int32brokers can send authorized operations. |
| v4 | 2.4 | + GroupInstanceId stringthe response will optionally include group.instance.id info for members. |
| v5 | 2.4 | ~ Flexible encoding enabled FLEXIBLE is the first flexible version. |
| v6 | 4.0 | + ErrorMessage stringreturns error code GROUP_ID_NOT_FOUND if the group ID is not found (KIP-1043). |