This CodeLab will walk you through the basics of performing a Solace Runtime Discovery scan of your existing (or a demo) Solace application / broker.
This CodeLab is only a placeholder and meant to accompany the live coding stream here: https://www.youtube.com/watch?v=gXNI7kwFjjo
The streaming US aviation data used in this CodeLab will eventually be moved somewhere more permanent, and this CodeLab will be updated at that point.
Not a lot:
Some of the data we will be looking can be displayed visually on a map. To see this, try the following link: https://solacese.github.io/faa-scds-feeds-gui/
(Props to Andrew and Robert)
Use either the existing credentials or these:
At the top of the map, toggle between "hand" to pan around, or "box" to draw filtered areas of the map. The blue button above them will delete all filtered areas.
We will be doing a Solace Discovery Scan. You will need to log into the Solace Event Portal: https://console.solace.cloud/
The agent is a local application running on your localhost or whatever server your Docker is running on. Point your favourite browser to
http://localhost:8120 to see the Agent GUI.
Use the following credentials to do Solace "Runtime Discovery". (note, these credentials will also work for a Topic Discovery scan):
After the scan is complete, upload it to your Solace Cloud account. Or download the JSON if you wish, you can upload it later.
Back in Solace Cloud Console, under the Designer, you should see the scan you just ran. Click the three vertical dots and "Import to Designer".
You will be presented with two sets of data:
Navigate through the topic hierarchy. When you navigate/expand a topic tree all the way down to the leaf node, you can then create an event with that static topic. There will appear a little + sign and allow you to create a Portal Event.
To create a topic level with mulitple values (e.g. enums or variable), click the checkmark box to the left of the first value at that level, and then say "Select All". Then you can create a variable for that level.
Watch the video for more details, or check back later when this CodeLab is updated.
On the 2nd tab, Queues & Direct Clients, you can see what consumers are active and consuming data from Solace. These can be generated into Portal Appliations.
Once Events and Applications have been created from your scan, you can move into the Designer view and start enhancing the data there (e.g. description, owner, etc.). Note that for scanned Events (topics), the Schema is not automatically generated as Solace (currently) don't reverse engineer schemas from published payloads.
Finally, you can export the AsyncAPI schema of any Applications you like, and then use any AsyncAPI code generator to build you a new application framework for publishing or subscribing to the data.
Thanks for participating in this codelab! Let us know what you thought in the Solace Community Forum! If you found any issues along the way we'd appreciate it if you'd raise them by clicking the Report a mistake button at the bottom left of this codelab.