# Decodable A video walkthrough can be found below: {% embed url="" %} ## Prerequisites 1. WarpStream account - get access to WarpStream by registering [here](https://console.warpstream.com/signup). 2. Decodable account - get access to Decodable by registering [here](https://www.decodable.co/). 3. WarpStream cluster is up and running. ## Step 1: Create a topic in your WarpStream cluster Obtain the Bootstrap Broker from the WarpStream console by navigating to your cluster and clicking the Connect tab. If you don't have SASL credentials yet, you can also [create a set of credentials](https://docs.warpstream.com/warpstream/kafka/manage-security/sasl-authentication#creating-credentials) from the console. Store these values as environment variables for easy reference: ```bash export BOOTSTRAP_HOST= \ SASL_USERNAME= \ SASL_PASSWORD=; ``` Then, create a topic using the WarpStream CLI: {% code overflow="wrap" %} ```bash warpstream kcmd -bootstrap-host $BOOTSTRAP_HOST -tls -username $SASL_USERNAME -password $SASL_PASSWORD -type create-topic -topic decodable_demo ``` {% endcode %} You should see the following output in your Terminal: `Created topic decodable_demo.` ## Step 2: Produce some records Using the WarpStream CLI, produce several messages to your topic: {% code overflow="wrap" %} ```bash warpstream kcmd -bootstrap-host $BOOTSTRAP_HOST -tls -username $SASL_USERNAME -password $SASL_PASSWORD -type produce -topic decodable_demo --records '{"action": "click", "user_id": "user_0", "page_id": "home"},,{"action": "hover", "user_id": "user_0", "page_id": "home"},,{"action": "scroll", "user_id": "user_0", "page_id": "home"},,{"action": "click", "user_id": "user_1", "page_id": "home"},,{"action": "click", "user_id": "user_1", "page_id": "home"},,{"action": "click", "user_id": "user_2", "page_id": "home"}' ``` {% endcode %} Note that the WarpStream CLI uses double commas (`,,)` as a delimiter between JSON records. ## Step 3: Connect Decodable to WarpStream In the Decodable Web Console, under the Start Building heading, click "**Connect to a source**". Select "**Apache Kafka**", and configure Decodable to read from your WarpStream topic.
Click **Next.** Create a new stream named `decodable_demo`:
Specify the schema of our data:
And finally, finish creating the Connection:
## Step 4: Start the Connection and verify that Decodable is ingesting data from WarpStream In the upper right corner of the Connection overview screen, click "**Start**", then start the connection with the default settings:
After a few moments, the Decodable Connection should transition from **Starting** to **Running**, and the Output Metrics will show that Decodable is consuming from WarpStream:
Navigate to **Streams > decodable\_demo** to view a sample of your data in Decodable.
## Step 5: Create a Pipeline In the Decodable Web Console, navigate to **Pipelines > Create your first Pipeline** and select `decodable_demo` from the list of Streams.
This query creates a new Stream and inserts only the records that have a `user_id` of `user_0`. Click **Next**. Click **Create Stream**, then click **Next.**
Name your Pipeline and click **Create Pipeline**.
Produce some more records to WarpStream from your Terminal (you can add more records if you want; just remember to use the `,,` delimiter in the WarpStream CLI): {% code overflow="wrap" %} ```bash warpstream kcmd -bootstrap-host $BOOTSTRAP_HOST -tls -username $SASL_USERNAME -password $SASL_PASSWORD -type produce -topic decodable_demo --records '{"action": "click", "user_id": "user_0", "page_id": "home"},,{"action": "hover", "user_id": "user_1", "page_id": "home"},,{"action": "scroll", "user_id": "user_1", "page_id": "home"},,{"action": "click", "user_id": "", "page_id": "home"},,{"action": "click", "user_id": "", "page_id": "home"},,{"action": "click", "user_id": "user_0", "page_id": "home"}' ``` {% endcode %} And then **Start** your Pipeline, configuring it to read from the earliest offset:
After a few moments, you should be able to observe the Input and Output Metrics, confirming that the Pipeline is working as expected!
## Next Steps Congratulations! You've set up a stream processing pipeline between WarpStream and Decodable and created a simple Pipeline that filters data out of a firehose of events. Next, check out the WarpStream docs for configuring the [WarpStream Agent](https://docs.warpstream.com/warpstream/agent-setup/deploy), or review the [Decodable docs](https://docs.decodable.co/docs) to learn more about what is possible with WarpStream and Decodable!