apache / apache/iggy

Kafka gateway: Kafka DescribeGroups and ListGroups admin APIs

Open
#3,548 0 comments 0 reactions 0 assignees View on GitHub
gateways
Dominant language
Rust
Stars
4.9k
Forks
432
Avg merge
2d 10h
Merged PRs (30d)
173

Description

Part of #3560.

## Summary

Implement **DescribeGroups (15)** and **ListGroups (16)** for observability and `kafka-consumer-groups.sh` compatibility.

## Depends on

- #3541 — consumer group state exists
- #3539 — Phase 1

## Scope

- [ ] ListGroups: active groups on coordinator
- [ ] DescribeGroups: members, assignment, state (Stable, CompletingRebalance, etc.)
- [ ] Integration test with running consumer group

## Acceptance criteria

- [ ] Admin can inspect group membership via Kafka CLI tools

## References

- Rollout plan: https://github.com/apache/iggy/discussions/3253#discussioncomment-17181030

Contributor guide

Open the contributing guide

Research direction

Start by reviewing issues #3541 and #3539, then locate the Kafka gateway's existing admin API handling. Run the relevant gateway tests and inspect how consumer group state, members, and assignments are represented. Done means ListGroups and DescribeGroups work for a running consumer group and are usable through kafka-consumer-groups.sh, with an integration test covering the behavior.

Written by the indexing model from the issue text.

Assessment

Tech stack
kafka, rust
Domain
api, distributed-systems
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.