Steadybit logoReliability Hub
GitHubGitHub iconStart Free Trial
Steadybit logoReliability Hub

Check Consumer State

CheckCheck
Monitor consumer group state transitions (Stable, Dead, Rebalancing) during an experiment
Targets:
Kafka Consumers
Install now

Check Consumer State

Monitor consumer group state transitions (Stable, Dead, Rebalancing) during an experiment
CheckCheck
Install now

Check Consumer State

CheckCheck
Monitor consumer group state transitions (Stable, Dead, Rebalancing) during an experiment
Install now

Check Consumer State

Monitor consumer group state transitions (Stable, Dead, Rebalancing) during an experiment
CheckCheck
Install now
Go back to list
The action "Check Consumer State" within the experiment editor.The action "Check Consumer State" within the experiment editor.

Introduction

Monitors the state of a Kafka consumer group during an experiment. This check polls the consumer group's coordination state and evaluates whether it matches the expected states.

This action targets consumer groups, not brokers or topics. For broker-level monitoring (controller elections, downtime), use Check Brokers. For topic partition changes (leader election, replica changes), use Check Partitions. For consumer lag monitoring, use Check Consumer Lag.

Use Cases

  • Verify that a consumer group remains Stable while injecting faults into downstream services.
  • Assert that a consumer group transitions to PreparingRebalance when a consumer pod is killed.
  • Detect if a consumer group enters a Dead state during a broker fault injection.

Parameters

ParameterDescriptionDefault
DurationHow long the check runs. The check continuously polls consumer group state for this duration.30s
Expected State List(optional) Which consumer group states to expect. Valid values: Stable, Dead, Empty, Unknown, CompletingRebalance, PreparingRebalance. Multiple states can be selected — the check succeeds if the group is in any of the listed states.
State Check ModeHow the expected state is evaluated. All the time (allTheTime): every poll must find the consumer in one of the expected states. At least once (atLeastOnce): the expected state must be observed at least once during the duration.allTheTime

Useful Templates

See all
Simulate Kafka brokers downtime and see how consumers are handling topic lag

An experiment to block access to brokers for consumers while producing records in the topic. The consumers should get back to consume when the kafka brokers are available again and the accumulated lag must be deal with quickly.

Message Queue
Kafka
Recoverability

More Kafka Consumer Actions

See all
Start Using Steadybit Today

Get started with Steadybit, and you’ll get access to all of our features to discover the full power of Steadybit. Available for SaaS and on-prem!

Are you unsure where to begin?

No worries, our reliability experts are here to help: book a demo with them!

Statistics
-Stars
Tags
Message Queue
Kafka
AWS
Homepage
hub.steadybit.com/extension/com.steadybit.extension_kafka
License
MIT
MaintainerSteadybit
Install now
Steadybit logoReliability Hub
Start Free Trial
© 2026 Steadybit GmbH. All rights reserved.
Twitter iconLinkedIn iconGitHub icon