Skip to content

Commit 4f67982

Browse files
applying suggestions
1 parent 137cf72 commit 4f67982

File tree

1 file changed

+32
-26
lines changed
  • src/connections/destinations/catalog/actions-kafka

1 file changed

+32
-26
lines changed

src/connections/destinations/catalog/actions-kafka/index.md

Lines changed: 32 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,70 +1,76 @@
11
---
22
title: Kafka Destination
3+
beta: true
4+
hidden: true
5+
id:
36
---
47

58
{% include content/plan-grid.md name="actions" %}
69

710
[Kafka](https://kafka.apache.org/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank”} provides a highly scalable and fault-tolerant messaging system that enables real-time data processing and stream processing at scale. When integrated with Segment, Kafka serves as a powerful backbone for managing and processing event data collected by Segment, allowing businesses to efficiently ingest, route, and analyze data across various applications and systems in real time.
811

9-
This destination is maintained by Segment.
12+
This destination is maintained by Segment. For any issues with the destination, [contact the Segment Support team](mailto:[email protected]).
1013

1114
## Getting started
1215

1316
### Create the Kafka Destination
1417

15-
1. From your workspace's [Destination catalog page](https://app.segment.com/goto-my-workspace/destinations/catalog){:target="_blank”} search for "Kafka"
16-
2. Select the "Kafka" tile and click **Add Destination**
18+
1. From your workspace's [Destination catalog page](https://app.segment.com/goto-my-workspace/destinations/catalog){:target="_blank”} search for "Kafka".
19+
2. Select the "Kafka" tile and click **Add Destination**.
1720
3. Select an existing Source to connect to Kafka.
18-
4. Give your Kafka Destination a name.
21+
4. Enter a name for your Kafka destination.
1922

2023
### Configure the Kafka Destination
2124

22-
Authentication and Encryption settings for Kafka depend on the way your cluster is configured. You may need the assistance of someone technical to provide values for the following configuration Settings:
25+
The way you've configured your Kafka Cluster informs the authentication and encryption settings you'll need to apply to the Segment Kafka Destination. You may need the assistance of someone technical to provide values for the following Settings:
2326

24-
5. On the Settings tab, provide values for the **Client ID**, **Brokers** and **Authentication Mechanism** Setting fields.
25-
6. Populate fields for your selected **Authentication Mechanism**:
26-
For **Plain** or **SCRAM-SHA-256 / 512**: provide values for **Username** and **Password** fields.
27-
For **AWS**: Provide values for **AWS Access Key ID** and **AWS Secret Key** fields, and optionally for the **AWS Authorization Identity** field.
28-
For **Client Certificate** you will need to provide values for the **SSL Client Key** and **SSL Client Certificate** Settings fields.
29-
7. Optionally populate the **SSL Certificate Authority** field.
30-
8. Save your changes before proceeding to the next step.
27+
5. On the Settings tab, enter values into the **Client ID**, **Brokers** and **Authentication Mechanism** setting fields.
28+
6. Populate fields based on the value you selected from the **Authentication Mechanism** field:
29+
- **Plain** or **SCRAM-SHA-256 / 512** authentication: provide values for **Username** and **Password** fields.
30+
- **AWS** authentication: provide values for **AWS Access Key ID** and **AWS Secret Key** fields, and optionally for the **AWS Authorization Identity** field.
31+
- **Client Certificate** authentication: provide values for the **SSL Client Key** and **SSL Client Certificate** fields.
32+
7. Populate the **SSL Certificate Authority** field, if necessary.
33+
8. Save your changes and proceed to Configure the Send Action.
3134

3235
### Configure the "Send" Action
3336

34-
9. Click to the Mappings tab and add a new **Send** Mapping.
35-
10. Select a Topic to send data to. This field should auto-populate based on the credentials provided in the Settings tab.
37+
9. Select the Mappings tab and add a new **Send** mapping.
38+
10. Select a Topic to send data to. This field should auto-populate based on the credentials you provided in the Settings tab.
3639
11. Map your payload using the **Payload** field.
37-
12. Optionally specify Partitioning preferences, Headers and Message Key values.
38-
13. Save and enable the Action, then navigate back to the Destination's Settings tab and enable and save the Destination.
39-
40-
The Destination should now be configured to send data to your Kafka cluster.
40+
12. _(Optional)_: Specify partitioning preferences, Headers and Message Key values.
41+
13. Save and enable the Action, then navigate back to the Kafka destination's Settings tab to enable and save the Destination.
4142

4243
{% include components/actions-fields.html %}
4344

4445
## FAQ
4546

4647
### Which Kafka Platforms are supported?
4748

48-
The Kafka Destination can send data to Topics on self hosted Kafka Clusters, or to Clusters hosted on Managed Service platforms such as **Confluent Cloud** and **Aiven**.
49+
The Kafka Destination can send data to Topics on self-hosted Kafka Clusters, or to Clusters hosted on Managed Service platforms like **Confluent Cloud** and **Aiven**
4950

5051
### Which data formats are supported?
5152

52-
Data will be sent to Kafka in JSON format only. Avro, Protobuf and other formats are not yet supported.
53+
Segment sends data to Kafka in JSON format only. Segment does not yet support other formats, like Avro or Protobuf.
5354

5455
### Which authentication mechanisms are supported?
5556

5657
The Authentication Mechanism is controlled with the **Authentication Mechanism** Setting field.
5758

58-
The following SASL based authentication mechanisms are supported: **Plain**, **SCRAM-SHA-256**, **SCRAM-SHA-512** and **AWS**.
59-
**Client Certificate** auth is also supported.
59+
Segment supports the following SASL-based authentication methods:
60+
- Plain
61+
- SCRAM-SHA-256
62+
- SCRAM-SHA-512
63+
- AWS
64+
65+
Segment also supports **Client Certificate** authentication.
6066

61-
### How is Partitioning controlled?
67+
### How is partitioning controlled?
6268

6369
The **Send** Action provides multiple ways to specify which Partition an event should be sent to.
6470

65-
1) The **Partition** field: Use this field to specify the name of the Partition to send the event to.
66-
2) The **Default Partition** field: Use this field to specify a default Partition. This will be used when value is provided in the **Partition** field.
67-
3) The **Message Key** field: A hash of the field's value will be used to determine which Partition to send the event to. If no value is provided in the **Message Key** field a round robin algorithm is used.
71+
- **Partition**: Use this field to specify the name of the Partition Segment should send events to.
72+
- **Default Partition**: Use this field to specify a default Partition. Segment uses this when you don't provide a value in the **Partition** field.
73+
- **Message Key**: Segment uses a hash of this field's value to determine which Partition should receive an event. If you don't provide a Message Key, Segment uses a round robin algorithm to select the partition to send the event to.
6874

6975
### What is the "SSL - Reject Unauthorized Certificate Authority" field for?
7076

0 commit comments

Comments
 (0)