Creating Your First Event Broker Service

This tutorial shows you how to:

  1. Create an Event Broker Service
  2. Find Your Event Broker Service Connection Information

When you create an event broker service on PubSub+ Cloud we take care of deploying and operating the service so that you that can focus on building client applications to stream events. You create an event broker service using Cluster Manager. After creating the service, you can see the connection details for connecting clients that publish and subscribe events with your service.

To see these steps in action, you can watch the Overview Videos.

Before You Begin

Before you start this tutorial, you must have a PubSub+ Cloud account. If you don't already have one, complete the Accessing PubSub+ Cloud tutorial.

Create an Event Broker Service

After you log into the PubSub+ Cloud Console, you'll see a welcome page with a navigation bar on the left-hand side of the page:

Screenshot showing the elements described in the surrounding text

On the welcome page you'll find Cluster Manager, which is the tool you'll use to create and manage your event broker service. When you launch Cluster Manager, the Services page shows you the event broker services that are available to you. If you're using a new account, there won't be any services. To create an event broker service, perform these steps:

  1. If you aren't logged into PubSub+ Cloud, in a browser, go to the PubSub+ Cloud login page.
  2. In the PubSub+ Cloud Console, on the navigation bar, select Cluster Manager .
  3. On the Services page, click Create Service located on the top-right corner of the page or click the Create Service card.
  4. In the Service Name field, type "MyFirstService".
  5. If you have multiple environments, use the Environment field to select an environment.
  6. In the Cloud list, select a cloud provider. For example, select Google Cloud.

    Screenshot showing the elements described in the surrounding text

  7. In the Region list, select a region for the cloud provider you selected. For your first event broker service, choose the region closest to your geographical location. For example, if you live in the United States, choose GKE - US Central (Iowa). The map updates to show the geographic location of the region you select.
  8. In the Broker Release and Broker Version lists, leave the default versions selected.

    Screenshot showing the elements described in the surrounding text

  9. In Service Type, list select Developer.

    Service types provide various levels of connections, message spools, and messaging performance. For more information, see PubSub+ Event Broker: Cloud Pricing. If you have a trial account, you will only have access to one Developer service.

  10. Click Create Service to create your first event broker service.

You've now created your first event broker service. Next, we'll take a look at the service's details to find information, such as connection details, for your service.

Find Your Event Broker Service Connection Information

After you clicked Create Service, the event broker service takes a few minutes to start.

When the service is ready, you can see the following tabs across the top of the page.

  • Status: View the overall status and health of your event broker service. You can also view information such as your event mesh details (if the service is part of an event mesh), the service information such as the cluster name/password, the status of authentication schemes used for the event broker service, and login information. You can also view the expiry date of custom TLS server certificates installed using the v2 REST APIs.

    Server certificate expiration dates on the Status tab of Cluster Manager are only visible for server certificates installed using the v2 REST APIs. Server certificates installed using other methods (for example, CLI or by Solace) may not show a date, or may show an invalid date.

  • Connect: See the connection information for your event broker service by selecting your language or protocol of choice.
  • Manage: Perform tasks such as configuring queues or managing clients.
  • Monitoring: If you have PubSub+ Insights, you can see advanced visualizations and graphs to manage and understand the performance of your event broker service.
  • Configuration: View the details of the event broker service that you created, such as the cloud provider, region, connection limits, messaging storage, and number of queued messages.
  • Try Me!: View connection details for the Broker Manager Try-Me! tool.

To find your event broker service's connection information:

  1. Select the Connect tab and in the View by list, select Protocol to choose the messaging protocol your client application will use. For example, we have selected Solace Messaging. If you're not sure, you can also keep the View by list set to Language so you can see the connection details for the language your client application is written in.

  2. Based on the connection information you have chosen, select the client library you would like to use. For example, we have selected the Go API. The connection information for that library is shown. Click Get Started.

    The following information is summarized on this page:

    1. Get API—Information about how to get and use the client library.
    2. Connect to Service—Code snippets about how to connect to the service.
    3. Learn with Tutorials—Explore links to tutorials and API documentation.

You've now learned how to see connection information for your service, in particular the connection details for your service for a particular API. This is important when you want to develop or test applications that publish and subscribe to events from your service.

Next Steps

Awesome! You have learned how to create services event broker service and now have a basic understanding of how to find connection information about your service. Want to learn more?