aws/eventbridge-kafka-connector
64.7
Adequate · 8 November 2026
2.9k
lines of production code
Java
primary language
7
measurements over time
What this system is
Features
Introduces extensible mappers for EventBridge detail type and timestamp mapping
The connector now uses pluggable \DetailTypeMapper\ and \TimeMapper\ interfaces to determine the EventBridge detail type and event timestamp for each Kafka record. A new \DefaultDetailTypeMapper\ allows users to configure a static detail type with topic substitution or map topics to specific detail types via configuration, while a new \JsonPathDetailTypeMapper\ enables extracting the detail type dynamically from the record's JSON payload using a configurable JSON path. Additionally, a \DefaultTimeMapper\ is introduced that currently returns null (falling back to the EventBridge service timestamp), and the \DefaultEventBridgeMapper\ orchestrates these mappers to construct the final \PutEventsRequestEntry\. This change provides users with flexible, configurable ways to control how Kafka records are mapped to AWS EventBridge events.
src/main/java/software/amazon/event/kafkaconnector/mapping · high confidence
Major connector refactoring with S3 offloading, custom mappers, and improved batching
The EventBridge Kafka Connector has been significantly refactored to support new capabilities and improve reliability. Users can now offload large event payloads to an S3 bucket (claim check) using configurable JSON paths, reducing EventBridge event sizes. The connector introduces extensible mapping interfaces, allowing custom logic for both detail-type and event-time mapping via new configuration options. Batching behavior has been improved to support proper batch sending to EventBridge, and the connector now supports global EventBridge endpoints, custom AWS credential providers, and profile-based authentication. Logging has been enhanced to include Git commit identifiers for better traceability, and the internal error handling model has been updated to distinguish between retryable, report-only, and panic errors, improving dead-letter queue integration and retry logic.
src/main/java/software/amazon/event/kafkaconnector · high confidence
New E2E test infrastructure for Apache Kafka, Confluent, and Redpanda
Added end-to-end test configurations and Docker Compose setups to validate the EventBridge Sink Connector against multiple Kafka distributions. The changes introduce dedicated compose files for Apache Kafka (v4.1.1), Confluent Platform (v8.1.1), and Redpanda (v25.3.2), alongside LocalStack (v4.12.0) for AWS service simulation. Connector configurations are provided for standard EventBridge publishing and for AWS S3 offloading (claim check), with specific settings for endpoints, buckets, and field references. Logging and standalone properties are also included to support debugging and local execution of the connector within these test environments.
e2e · high confidence
Behavioural changes
Refactor StatusReporter to use standard Java scheduling and introduce utility classes
The StatusReporter class has been refactored to remove the dependency on Guava's AbstractScheduledService, replacing it with a standard Java ScheduledExecutorService for logging throughput metrics. This change also updates logging initialization to use ContextAwareLoggerFactory across PropertiesUtil and StatusReporter. Additionally, new utility classes have been added: EventBridgeEventId for wrapping EventBridge event IDs, MappedSinkRecord for pairing Kafka SinkRecords with mapped values, and ThrowingFunction/ThrowingFunctionApplyException to support functional interfaces that throw checked exceptions.
src/main/java/software/amazon/event/kafkaconnector/util · high confidence
Strict EventBridge batching with 1MB size limit
The connector now enforces strict batching rules when sending events to EventBridge: batches are limited to a maximum of 10 items and a combined payload size strictly less than 1MB. If an individual event exceeds the 1MB limit, it is isolated into its own batch and logged as a warning, allowing downstream handling (such as dropping or sending to a dead-letter topic) rather than causing a batch failure. This change introduces the \EventBridgeBatchingStrategy\ interface and its \DefaultEventBridgeBatching\ implementation to manage this logic, replacing previous behavior that may not have adhered to these specific constraints.
src/main/java/software/amazon/event/kafkaconnector/batch · high confidence
Support for custom AWS credential providers and improved default credential handling
The authentication module now allows users to supply a custom AWS credentials provider class via configuration; if the class implements Kafka's Configurable interface, it is automatically initialized with the connector's configuration. Additionally, the default credentials provider has been refactored to explicitly leverage the AWS SDK's ProfileFileSupplier for automatic credential reloading and to properly handle named profiles, replacing the previous hardcoded default behavior. The class has also been renamed from EventBridgeCredentialsProvider to EventBridgeAwsCredentialsProviderFactory to reflect its new role as a factory for various provider types.
src/main/java/software/amazon/event/kafkaconnector/auth · high confidence
Test coverage
Expanded test coverage for EventBridge Kafka Connector
Added comprehensive integration and unit tests for the EventBridge Kafka Connector, including end-to-end scenarios for sending JSON records to Kafka and receiving them via SQS, as well as tests for the AWS S3 sidelining (claim check) feature. The suite also covers the new \DefaultDetailTypeMapper\ for custom mapping logic, strict \<1MB EventBridge payload batching, and configuration validation for AWS credential providers and global endpoints.
src/test/java · high confidence
Dependencies
Major dependency upgrades, Java 17 migration, and AWS SDK expansion
The project has upgraded its build target to Java 17 and significantly updated its dependency landscape. The AWS SDK for Java is bumped to version 2.50.1, introducing new S3 and SQS client dependencies alongside the existing AWS CRT client. A critical security fix addresses [CVE redacted] by explicitly overriding the json-smart library version to 2.6.0, required by the upgraded JsonPath 3.0.0. Other notable updates include Jackson to 2.21.3, Logback to 1.6.1, and the removal of the Guava dependency in favor of standard Java libraries. Test dependencies have also been refreshed, including JUnit Jupiter to 6.1.2, Mockito to 5.23.0, and Testcontainers to 2.0.5.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 61 → 65 (+4.0)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 72 → 72 (-0.2)
- Architecture 99 → 99 (-0.0)
- Maturity 53 → 65 (+12.5)
- Readiness 57 → 57 (+0.2)
- Security 78 → 76 (-2.1)
Resolved (21)
- Critical CVE: [GHSA redacted] (pom.xml)
- High CVE: [GHSA redacted] (pom.xml)
- High CVE: [GHSA redacted] (pom.xml)
- Medium CVE: [GHSA redacted] (pom.xml)
- Medium CVE: [GHSA redacted] (pom.xml)
- Orphaned file (src/main/java/software/amazon/event/kafkaconnector/EventBridgeSinkConfig.java)
- Orphaned file (src/main/java/software/amazon/event/kafkaconnector/EventBridgeSinkConfigValidator.java)
- Orphaned file (src/main/java/software/amazon/event/kafkaconnector/EventBridgeSinkTask.java)
- Orphaned file (src/main/java/software/amazon/event/kafkaconnector/EventBridgeWriter.java)
- Outdated (compile): org.slf4j:slf4j-api
- Outdated (provided): com.fasterxml.jackson.core:jackson-annotations
- Outdated (provided): com.fasterxml.jackson.core:jackson-core
- Outdated (provided): com.fasterxml.jackson.core:jackson-databind
- Outdated (test): org.junit.jupiter:junit-jupiter
- Outdated (test): org.junit.jupiter:junit-jupiter-api
- Outdated (test): org.junit.jupiter:junit-jupiter-engine
- Outdated (test): org.junit.jupiter:junit-jupiter-params
- Outdated (test): org.junit.platform:junit-platform-commons
- Outdated (test): org.junit.platform:junit-platform-engine
- Outdated (test): org.mockito:mockito-core
- …and 1 more
New (22)
- High CVE: [GHSA redacted] (pom.xml)
- MethodTooLong: EventBridgeSinkConfig.addParams (src/main/java/software/amazon/event/kafkaconnector/EventBridgeSinkConfig.java)
- No assertions: startConnector (src/test/java/software/amazon/event/kafkaconnector/EventBridgeSinkConnectorV2CloudEventsIT.java)
- No assertions: startConnector (src/test/java/software/amazon/event/kafkaconnector/EventBridgeSinkConnectorV2IT.java)
- No assertions: v1WithoutV2SettingsPasses (src/test/java/software/amazon/event/kafkaconnector/EventBridgeSinkConfigValidatorTest.java)
- No assertions: v2AvroOrProtobufWithRegistryUriPasses (src/test/java/software/amazon/event/kafkaconnector/EventBridgeSinkConfigValidatorTest.java)
- No assertions: v2ConfluentRegistryWithConnectionArnPasses (src/test/java/software/amazon/event/kafkaconnector/EventBridgeSinkConfigValidatorTest.java)
- No assertions: v2RecordKeyGroupingWithAckPasses (src/test/java/software/amazon/event/kafkaconnector/EventBridgeSinkConfigValidatorTest.java)
- No assertions: v2WithV2BusArnPasses (src/test/java/software/amazon/event/kafkaconnector/EventBridgeSinkConfigValidatorTest.java)
- No assertions: validApiVersion (src/test/java/software/amazon/event/kafkaconnector/EventBridgeSinkConfigValidatorTest.java)
- No assertions: validV2BusArnPerValue (src/test/java/software/amazon/event/kafkaconnector/EventBridgeSinkConfigValidatorTest.java)
- No assertions: validV2ContentType (src/test/java/software/amazon/event/kafkaconnector/EventBridgeSinkConfigValidatorTest.java)
- No assertions: validV2DeduplicationId (src/test/java/software/amazon/event/kafkaconnector/EventBridgeSinkConfigValidatorTest.java)
- No assertions: validV2EventGroupId (src/test/java/software/amazon/event/kafkaconnector/EventBridgeSinkConfigValidatorTest.java)
- No assertions: validV2PayloadStrategy (src/test/java/software/amazon/event/kafkaconnector/EventBridgeSinkConfigValidatorTest.java)
- Outdated (compile): com.fasterxml.jackson.core:jackson-core
- Outdated (compile): com.fasterxml.jackson.core:jackson-databind
- Outdated (compile): software.amazon.awssdk:eventbridgev2
- Outdated (compile): software.amazon.awssdk:smithy-rpcv2-protocol
- Outdated (compile): software.amazon.awssdk:third-party-jackson-dataformat-cbor
- …and 2 more
Changes since last survey
- 5 commits — 4 feature/other, 1 fixes
By area
- (repo) — 2 commits
- (root) — 2 commits
- .github/workflows — 1 commit
Notable commits
- fix: fix(build): pin google-java-format 1.37.0 only on JDK 21+
- change: Merge pull request #774 from sliedig/sliedig/custom-event-bus
- change: Merge pull request #775 from sliedig/chore/dependabot-updates
- change: build(deps): bump github actions pins
- change: build(deps): bump maven dependencies and plugins
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
aws/eventbridge-kafka-connector was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 8 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 688912dec9a546d04edc1d76a32b5ed2ce13e4e1 — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-45ab2cab63de.