Creating Your First Event Broker Service

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

This tutorial shows you how to:

Creating a service on PubSub+ Cloud is easy as 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(or simply a 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.

Creating 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:

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 the Create Service button located on the top right corner of the page or click the Create Service card.
  4. In the Select Service Type step, select the type of service to use.

    For your first event broker service, select any available service type. PubSub+ Cloud offers service types that provide various levels of messaging performance. Some of these service types may be inaccessible before configuring a billing method for your account. You can request access to additional service types later. For more information, see PubSub+ Event Broker: Cloud Pricing. If you have a trial account, you will only have access to one Developer service. For now, select Developer.

  5. In the Select Cloud step, select a cloud provider from the drop-down menu. For example, select Amazon Web Services.
  6. In the Select Region step, choose where the you want the service to run. To do this, click the map and choose a region for the provider you selected, and then click OK. For your first event broker service, choose the region closest to your geographical location. For example, choose Canada Central (Montreal).
  7. In the Service Details step, do the following:
    • Leave the default version in the Select Your Broker Version drop-down.
    • Enter a name for the event broker service in the Service Name field. An event broker service is identified by its name.
  8. Click Start 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.

Finding Your Event Broker Service's Connection Information

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

Once your service has started, you can see the following tabs across the top of the page. The steps below show you how to find the connection details for your service, but here's a summary of the other tabs available:

  • 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 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, and connection limits.
  • Try Me!: Try your event broker service using embedded CodePen examples.

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 Java 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?