Skip to content

chore: announce kafka connector group ID generation strategy change#8432

Open
chillleader wants to merge 3 commits intomainfrom
kafka-connector-group-id-change-announcement
Open

chore: announce kafka connector group ID generation strategy change#8432
chillleader wants to merge 3 commits intomainfrom
kafka-connector-group-id-change-announcement

Conversation

@chillleader
Copy link
Copy Markdown
Member

@chillleader chillleader commented Mar 31, 2026

Description

Added an announcement about a potentially breaking change, affecting some users during 8.8-8.9 migration. The change is related to the Kafka connector's default consumer group ID generation strategy that has changed between minors.

Also adjusted the connector docs to emphasize the importance of defining a custom group ID.

When should this change go live?

  • This is a bug fix, security concern, or something that needs urgent release support. (add bug or support label)
  • This is already available but undocumented and should be released within a week. (add available & undocumented label)
  • This is on a specific schedule and the assignee will coordinate a release with the Documentation team. (create draft PR and/or add hold label)
  • This is part of a scheduled alpha or minor. (add alpha or minor label)
  • There is no urgency with this change (add low prio label)

PR Checklist

  • My changes are for an upcoming minor release and are in the /docs directory (version 8.9).
  • My changes are for an already released minor and are in a /versioned_docs directory.

@chillleader chillleader self-assigned this Mar 31, 2026
@chillleader chillleader added 8.9.0 component:connectors Issues related to the connectors project. labels Mar 31, 2026
@chillleader chillleader requested review from a team and sbuettner March 31, 2026 14:19
@camunda-docs-pr-automation camunda-docs-pr-automation bot moved this to 👀 In Review in Documentation Team Mar 31, 2026
@chillleader chillleader force-pushed the kafka-connector-group-id-change-announcement branch from 36150be to 87b5303 Compare March 31, 2026 14:20
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 31, 2026

👋 🤖 🤔 Hello, @christinaausley! Did you make your changes in all the right places?

These files were changed only in docs/. You might want to duplicate these changes in versioned_docs/version-8.8/.

  • docs/components/connectors/out-of-the-box-connectors/kafka.md
  • docs/reference/announcements-release-notes/890/890-announcements.md

You may have done this intentionally, but we wanted to point it out in case you didn't. You can read more about the versioning within our docs in our documentation guidelines.

</div>
<div className="release-announcement-content">

#### Kafka Consumer connector: auto-generated consumer group ID format changed
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [vale] reported by reviewdog 🐶
[all.glossary] Inconsistent spelling detected. Use Kafka consumer instead of Kafka Consumer. Review the WCoE glossary - https://confluence.camunda.com/x/b5RZBw .


Because Kafka treats a changed group ID as a brand-new consumer group, connectors using an auto-generated group ID after upgrading will lose their committed offsets and may reprocess messages.

**Action required:** Before upgrading to 8.9, set an explicit **Consumer Group ID** in each Kafka Consumer connector configuration to preserve consumer group identity. See the [Kafka connector documentation](/components/connectors/out-of-the-box-connectors/kafka.md?kafka=inbound) for details.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [vale] reported by reviewdog 🐶
[all.glossary] Inconsistent spelling detected. Use Kafka consumer instead of Kafka Consumer. Review the WCoE glossary - https://confluence.camunda.com/x/b5RZBw .

sbuettner
sbuettner previously approved these changes Mar 31, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

8.9.0 component:connectors Issues related to the connectors project.

Projects

Status: 👀 In Review

Development

Successfully merging this pull request may close these issues.

3 participants