How Sources Work
A source connector receives messages from an external system and appends them to a KurrentDB stream. A source is not a reversed sink. The path has no subscription, no filter, and no transformer.
Settings
Section titled “Settings”A source accepts these two keys and the settings of its own connector type. Nothing else is shared. For the required settings, see the page for Kafka or Webhook.
| Name | Details |
|---|---|
instanceTypeName |
required Description: The type of connector instance. Accepted Values:
|
logging:enabled |
Description: Enables or disables logging. Default: "true" |
What Does Not Apply
Section titled “What Does Not Apply”Everything on How Sinks Work applies to sinks only. If you set one of these keys on a source, the server accepts it and nothing reads it.
| Feature | Why it does not apply |
|---|---|
Filters (subscription:filter:*) |
A source has no subscription. It receives from the outside. |
Transformations (transformer:*) |
The transformer runs only on the sink write path. |
Auto-commit (autocommit:*) |
Only sinks commit a position to KurrentDB. |
Resilience (resilience:*) |
Each sink declares its own retry strategy. A source retries only as far as its client library does. |
The esdb- headers |
A sink adds these when it writes. A source passes the origin system’s headers through unchanged. |
| The KurrentDB record shape | A sink hands that shape to its filters and transformations. |
Position Tracking
Section titled “Position Tracking”A source does not write to the $connectors/{connector-id}/checkpoints stream. That stream belongs to
sinks. A source tracks its position in the origin system instead.
- The Kafka source commits a Kafka consumer-group offset. It starts from its own
offsetandpartitionsettings, not frominitialPosition. - The webhook source has no position to track. It appends what it receives.
Data Protection
Section titled “Data Protection”Sensitive source settings are encrypted the same way sink settings are. See Data Protection.
Available Sources
Section titled “Available Sources”instanceTypeName |
Reads from | Since |
|---|---|---|
kafka-source |
A Kafka topic | 26.0 |
webhook-source |
POST /webhook/{connectorId} |
26.1 |