Skip to content

Commit d2d2849

Browse files
committed
Refining navigation; fixing numbering; better wording
1 parent 5dde2ff commit d2d2849

File tree

6 files changed

+61
-48
lines changed

6 files changed

+61
-48
lines changed

modules/use-cases-architectures/nav.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
* xref:real-time-data-pipeline/index.adoc[Stream Processing]
1+
* xref:real-time-data-pipeline/index.adoc[Real-time Processing]
22
** xref:real-time-data-pipeline/index.adoc[]
33
44
* xref:starlight/index.adoc[Pulsar extensions]

modules/use-cases-architectures/pages/real-time-data-pipeline/01-create-astra-objects.adoc

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
= Creating the real-time data pipeline Astra objects
1+
= Real-time data pipeline Astra objects
22
David Dieruf <david[email protected]>
33
1.0, February 1, 2022: Creating the real-time data pipeline Astra objects
44

@@ -8,7 +8,7 @@ David Dieruf <[email protected]>
88

99
This guide is part of a series of guides that creates a real-time data pipeline. Read more about the series xref:streaming-learning:use-cases-architectures:real-time-data-pipeline/index.adoc[here].
1010

11-
== Creating message topics to stream click data
11+
== Creating message topics to capture the stream of click data
1212

1313
. Navigate to your Astra portal home and choose "Create a stream"
1414
+
@@ -38,7 +38,7 @@ image:decodable-data-pipeline/01/image8.png[]
3838
+
3939
image:decodable-data-pipeline/01/image13.png[]
4040

41-
== Creating a store to persist click data
41+
== Storing the stream of click data
4242

4343
. From the Astra portal home click “Create a Database”.
4444
+
@@ -91,7 +91,7 @@ describe click_data;
9191
+
9292
The output will be 3 “create” CQL statements for the keyspace, the click_data.all_clicks table, and the click_data.product_clicks table
9393

94-
== Create a sink between your topics and the store
94+
== Connecting the topics to the store
9595

9696
. From the Astra portal home, click on the “webstore-clicks” streaming tenant.
9797
+
@@ -191,4 +191,4 @@ To debug you can click the sink name, scroll to the bottom terminal output area
191191

192192
== Next step
193193

194-
Now it's time see the magic! xref:real-time-data-pipeline/03-put-it-all-together.adoc[Run the pipelines >>]
194+
With the Astra objects in place, now it's time to get the Decodable processing set up. xref:real-time-data-pipeline/03-put-it-all-together.adoc[Setup Decodable >>]

modules/use-cases-architectures/pages/real-time-data-pipeline/02-create-decodable-objects.adoc

Lines changed: 25 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
= Creating the real-time data pipeline Decodable objects
1+
= Real-time data pipeline Decodable objects
22
David Dieruf <david[email protected]>
33
1.0, February 1, 2022: Creating the real-time data pipeline Decodable objects
44

@@ -10,7 +10,7 @@ This guide is part of a series of guides that creates a real-time data pipeline.
1010

1111
== The Astra Streaming connection info
1212

13-
To create the connection you are going to need a few things from your Astra Streaming tenant. First from the Astra portal home navigate to the webstore-clicks streaming tenant.
13+
To connect Astra to Decodable you are going to need a few things from your Astra Streaming tenant. First from the Astra portal home navigate to the webstore-clicks streaming tenant.
1414

1515
image:decodable-data-pipeline/02/image4.png[]
1616

@@ -22,21 +22,21 @@ You will also need a Pulsar token. Click the “Token Manager” link and “Cre
2222

2323
image:decodable-data-pipeline/02/image31.png[]
2424

25-
Navigate back to the “Connect” tab. We’ll come back here in a bit.
25+
Close the popup and navigate back to the “Connect” tab. We’ll come back here in a bit.
2626

2727
== Creating a Decodable connection to Astra Streaming for all web clicks
2828

29-
In a different browser tab, sign in to your Decodable account and navigate to the “Connections” tab.
29+
In a different browser tab, sign in to your Decodable account and navigate to the “Connections” tab. We are going to create a new connection and stream, that will direct all web clicks to the correct topic in Astra.
3030

31-
. We are going to create a new connection and stream, that will direct all web clicks to the correct topic in Astra. Click the “New Connection” button
31+
. Click the “New Connection” button
3232
+
3333
image:decodable-data-pipeline/02/image25.png[]
3434

35-
. In the “Choose a Connector” view, locate the DataStax Astra Streaming connector and click “Connect”.
35+
. In the “Choose a Connector” view, locate the DataStax Astra Streaming connector and click “Connect”.
3636
+
3737
image:decodable-data-pipeline/02/image14.png[]
3838

39-
. Use the Tenant Details from Astra to fill in the details about the connection as follows:
39+
. Use the Tenant Details from Astra (in your other browser tab) to fill in the details about the connection as follows:
4040
+
4141
[cols="1,4a",frame=none]
4242
|===
@@ -61,9 +61,7 @@ image:decodable-data-pipeline/02/image14.png[]
6161
+
6262
image:decodable-data-pipeline/02/image35.png[]
6363

64-
. Click “Next” to set up a new stream.
65-
66-
. Choose “New Stream”. Name the new stream “Webstore-Normalized-Clicks-Stream”.
64+
. Click “Next” and choose “New Stream”. Name the new stream “Webstore-Normalized-Clicks-Stream”.
6765
+
6866
image:decodable-data-pipeline/02/image12.png[]
6967

@@ -108,7 +106,9 @@ image:decodable-data-pipeline/02/image13.png[]
108106

109107
== Creating Decodable connections to Astra Streaming for product web clicks
110108

111-
Now let’s create another connection for the specific product clicks. Navigate back to the “Connections” area and click “New Connection”.
109+
Create another connection to stream product clicks.
110+
111+
. Navigate back to the “Connections” area and click “New Connection”.
112112

113113
. Just as previously done, locate the Astra Streaming connection and use the Tenant Details from Astra to fill in the details about the connection as follows. Note the change in topic name.
114114
+
@@ -213,22 +213,24 @@ image:decodable-data-pipeline/02/image24.png[]
213213
+
214214
image:decodable-data-pipeline/02/image7.png[]
215215

216-
If it goes as planned you should have 3 connections ready to go.
216+
You now have 3 connections ready to go.
217217

218218
image:decodable-data-pipeline/02/image5.png[]
219219

220220
== Creating a data normalization pipeline
221221

222-
Now we are going to create the core functions for our stream processing. Navigate to the “Pipelines” area and click “Create Pipeline”.
222+
Now we are going to create the core functions for our stream processing.
223+
224+
. Navigate to the “Pipelines” area and click “Create Pipeline”.
223225
+
224226
image:decodable-data-pipeline/02/image9.png[]
225227

226-
Choose an input of “Webstore-Raw-Clicks-Stream” and click “Next”.
228+
. Choose an input of “Webstore-Raw-Clicks-Stream” and click “Next”.
227229
+
228230
image:decodable-data-pipeline/02/image28.png[]
229231

230232
. Clear the existing SQL and copy/paste the following into the “SQL” area.
231-
233+
+
232234
[source,sql]
233235
----
234236
insert into `Webstore-Normalized-Clicks-Stream`
@@ -267,14 +269,16 @@ image:decodable-data-pipeline/02/image20.png[]
267269

268270
== Creating a data filtering pipeline
269271

270-
Now let’s create one more pipeline to filter out product click data. Navigate to the “Pipelines” area and click “New Pipeline”.
272+
Create one more pipeline to filter out product click data.
273+
274+
. Navigate to the “Pipelines” area and click “New Pipeline”.
271275

272276
. Choose the “Webstore-Normalized-Clicks-Stream” as the input.
273277
+
274278
image:decodable-data-pipeline/02/image22.png[]
275279

276-
Clear the SQL from the window and copy/paste the following into the “SQL” window.
277-
280+
. Clear the SQL from the window and copy/paste the following into the “SQL” window.
281+
+
278282
[source,sql]
279283
----
280284
insert into `Webstore-Product-Clicks-Stream`
@@ -296,10 +300,10 @@ image:decodable-data-pipeline/02/image32.png[]
296300
+
297301
image:decodable-data-pipeline/02/image18.png[]
298302

299-
Now we have a pipeline ready to filter by product.
300-
303+
. Now we have a pipeline ready to filter by product.
304+
+
301305
image:decodable-data-pipeline/02/image30.png[]
302306

303307
== Next step
304308

305-
With the Astra objects in place, now it's time to get the Decodable processing set up. xref:real-time-data-pipeline/03-put-it-all-together.adoc[Setup Decodable >>]
309+
Now it's time see the magic! xref:real-time-data-pipeline/03-put-it-all-together.adoc[Run the pipelines >>]

modules/use-cases-architectures/pages/real-time-data-pipeline/03-put-it-all-together.adoc

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
= Putting the real-time data pipeline together
1+
= Putting the real-time data pipeline to work
22
David Dieruf <david[email protected]>
33
1.0, February 1, 2022: Putting the real-time data pipeline together
44

@@ -35,7 +35,7 @@ Let’s make sure we have all the pieces in order…
3535

3636
== Your first ingested data
3737

38-
The moment of truth! Navigate to the “Connections” area and click the “REST” connector.
38+
. Navigate to the “Connections” area and click the “REST” connector.
3939

4040
. Choose the “Upload” tab and copy/paste the following web click data into the window.
4141
+
@@ -54,7 +54,7 @@ The moment of truth! Navigate to the “Connections” area and click the “RES
5454

5555
. Click “Upload” to simulate data being posted to the endpoint. You should receive a confirmation that data has been received.
5656

57-
TIP: This was not a big moment with cheers and balloons. The celebration is at the end of the next area.
57+
NOTE: NO, this was not a big moment with cheers and balloons. The celebration is at the end of the next area.
5858

5959
== Following the flow
6060

@@ -70,15 +70,15 @@ image:decodable-data-pipeline/03/image2.png[]
7070
+
7171
image:decodable-data-pipeline/03/image4.png[]
7272

73-
. Now we can go to our Astra Tenant “webstore-clicks”, and navigate to the “Namespace and Topics” area, then expand the “Production” namespace, and click the “all-clicks” topic. Notice in the “Data In” area 1 message was produced and in the “Data Out” area 1 message was consumed.
73+
. Now we can go to our Astra Streaming tenant “webstore-clicks” and navigate to the “Namespace and Topics” area. Expand the “Production” namespace and click the “all-clicks” topic. Notice that “Data In” has 1 message and “Data Out” has 1 message. That means the topic took the data in and a consumer acknowledged receipt of the message.
7474
+
7575
image:decodable-data-pipeline/03/image6.png[]
7676

77-
. Now on to the “Sinks” tab in Astra and click the “all-clicks” sink. In “Instance Stats” you see “Reads” has a value of 1 and “Writes” has a value of 1. This confirms our AstraDB sink received a message from the topic and wrote the data to our Cassandra table.
77+
. On to the “Sinks” tab in Astra and click the “all-clicks” sink. In “Instance Stats” you see “Reads” has a value of 1 and “Writes” has a value of 1. This confirms the Sink consumed a message from the topic and wrote the data to the store.
7878
+
7979
image:decodable-data-pipeline/03/image5.png[]
8080

81-
. Let’s look at the final data in AstraDB. Navigate to the Astra home and click the “webstore-clicks” Serverless Database. Choose the “CQL Console” tab and copy/paste the following command in the terminal.
81+
. Let’s look at the final data in Astra DB. Navigate to the Astra home and click the “webstore-clicks” Serverless Database. Choose the “CQL Console” tab and copy/paste the following command in the terminal.
8282
+
8383
[source,sql]
8484
----
@@ -89,10 +89,12 @@ Your should see a single record output.
8989
+
9090
image:decodable-data-pipeline/03/image8.png[]
9191

92-
{emoji-tada}{emoji-tada} Queue the loud cheers and high-fives! Our pipeline ingested raw web click data, normalized it, and persisted the parsed data to the database!
92+
{emoji-tada}{emoji-tada} Queue the loud cheers and high-fives! Our pipeline ingested raw web click data, normalized it, and persisted the parsed data to the database! Woot woot!!
9393

9494
== Follow the flow of the product clicks data
9595

96+
Similar to how you followed the above flow follow this flow to confirm the filtered messages were stored.
97+
9698
. Navigate to your Decodable pipeline named “Webstore-Product-Clicks-Pipeline”.
9799
.. The “Input Metrics” should be 1 record and the “Output Metrics” should be 1 record.
98100

@@ -118,13 +120,13 @@ image:decodable-data-pipeline/03/image7.png[]
118120

119121
Let’s see what this can do! To put a load on the pipeline we’ll need a way to continuously post data to our endpoint. Below are a few examples. Use the download button below to download a zip of a static(html) site ecommerce catalog, that silently posts click data to an endpoint. The site is a copy of https://www.blazemeter.com/[BlazeMeter^]’s{external-link-icon} https://www.demoblaze.com/[Demoblaze site^]{external-link-icon}.
120122

121-
You’ll need 2 pieces of information to attempt any of the examples, the Endpoint URL and an authorization token. Learn more about retrieving both of those in https://docs.decodable.co/docs/connector-reference-rest#authentication[Decodable documentation^]{external-link-icon}.
123+
You’ll need 2 pieces of information the Endpoint URL and an authorization token. Learn more about retrieving both of those in https://docs.decodable.co/docs/connector-reference-rest#authentication[Decodable documentation^]{external-link-icon}.
122124

123125
Once you extract the zip, open the folder in your text editor of IDE of choice and look in the script.js file. There are 2 placeholders for the data retrieved above.
124126

125127
Open the phones.html file in your browser (yes, as a local file) and begin clicking on products. Each click should be a new post to your Decodable endpoint.
126128

127-
image::icons/button-get-started.png["Download web clicks website",130,xref=attachment$web-clicks-website.zip]
129+
[.button]#xref:attachment$web-clicks-website.zip[*Download Now*]#
128130

129131
== Next step
130132

modules/use-cases-architectures/pages/real-time-data-pipeline/04-debugging-and-clean-up.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ image:decodable-data-pipeline/04/image2.png["Delete decodable connection"]
2828

2929
=== Removing Astra objects
3030

31-
. In Astra navigate to the "Streaming" area to see a list of your tenants.
31+
. From the Astra portal home navigate to the "Streaming" area to see a list of your tenants.
3232

3333
. Click the 3 dots associated with "webstore-clicks" tenant and choose the "Delete". This will remove all sinks, topics, messages, and namespaces.
3434
+

0 commit comments

Comments
 (0)