Creating Your First Event Broker Service

Before you start, you must have a user account for PubSub+ Cloud. If you haven't already, complete the Accessing PubSub+ Cloud tutorial.

This tutorial shows you how to:

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

Creating an event broker serviceon PubSub+ Cloud is easy because we take care of deploying and operating the service so that you that can focus on building client applications to stream events. You first must create an event broker service using Cluster Manager. After the service has been created, you can see the connection details, which is important for connecting from 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 haven't already, complete the Accessing PubSub+ Cloud tutorial.

Create an Event Broker Service

After you have logged 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 navigation bar, is Mission Control. Mission Control allows you create and configure event streaming. In particular, you use Cluster Manager to create and manage your event broker service. When you launch Cluster Manager, you go to the Services page. This page shows you the event broker services that are available to you. If this your first service on the account, there won't be any services. Follow these steps to create your event broker service:

  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 "My-First-Service".
  5. In the Cloud drop-down list, select a cloud provider. For example, select Google Cloud.

    Screenshot showing the elements described in the surrounding text

  6. Click the Region drop-down and select a region for the 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.
  7. In the Broker Release and Broker Version drop-down lists, leave the default versions selected.

    Screenshot showing the elements described in the surrounding text

  8. 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.

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

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

Find Your Event Broker Service Connection Information

After you've clicked Start Service, your event broker service takes a few minutes to start.

After your service has started, 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.
  • 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 max queue messages.
  • Try Me!: Try your event broker service using embedded CodePen examples.

    The TryMe! functionality that's accessible in the PubSub+ Cloud Console uses public Internet and both services must have the Solace Web Messaging protocol enabled on the event broker services.

    For event broker service using private endpoints (or where you have a mix of private endpoints and public endpoints), you must have connectivity to the same private network from the browser. For example, if you have a computer that has a VPN connection to the private region where the event broker services are located and also public Internet access, TryMe! works as expected.

To find your event broker service's connection information:

  1. Select the Connect tab and choose the messaging protocol your application will be using. If you're not sure, you can also change the View by drop-down to Language so you can see the connection details for the language your client application is written in. For example, we have selected Solace Messaging.

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

    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 More—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?