IBM Cloud Docs
Event Streams

Event Streams

Event Streams is a message bus that is built by using Apache Kafka. It has high throughput and is optimized for event ingestion into IBM Cloud and event stream distribution between your services and applications. In Event Streams, applications can send data by creating messages and sending to a topic. To receive messages, the application subscribes to a topic and can choose to receive all the messages of the topic or share the messages between them.

Event Streams represents a service destination. Since Event Streams is a Kafka managed service, incoming notifications cannot be stored and consumed programmatically because Kafka does not store the data once it has been read.

Before you begin

Configuring an Event Streams destination in the console

If you are using Event Notifications CLI or API to configure an Event Streams service instance as a destination, ensure that you have enabled authorization to grant access between services before integrating with Event Streams. For more information, see Using authorizations to grant access between services.

To configure an Event Streams destination, complete the following steps:

  1. Navigate to https://cloud.ibm.com , click the Menu icon hamburger icon > Resource List > Developer Tools > Your Event Notifications instance.

  2. From your Event Notifications instance dashboard, click Destinations.

  3. Click Add + to add a new destination.

  4. Provide the name, description (optional) and select the destination type as Event Streams and the account where the Event Streams instance is located.

    If the Event Streams instance is located in the same account as your Event Notifications instance:

    1. Select the name of the Event Streams instance to send notifications to.
    2. Once the instance is selected, the Endpoint field will be filled automatically by pulling it from the selected instance.
    3. Select the Topic to send/receive messages from. To select the topic, see Topic.

    If the Event Streams instance is located in a different account, provide the following details:

    1. Enter the Event Streams CRN . For more information, see CRN.
    2. Enter the Event Streams endpoint URL. For more information, see Endpoint url.
    3. Select the topic to send/receive messages from. To select the topic, see Topic.

  5. Click Add.

Finding the Event Streams service instance details

  1. Login to your IBM Cloud account.

  2. Navigate to Resource List in the menu.

  3. Navigate to Integration in the Resource list.

  4. Click the Event Streams name that displays your Event Streams console.

  5. From the Event Streams console:

CRN

Copy the CRN, that is used in the destination creation process. Use this copied CRN in the destination creation screen.

Endpoint URL

Copy the HTTP API endpoint that needs to be used in the destination creation process. Use this copied endpoint in the destination creation screen.

Topic

Navigate to Topics in the menu. You will find the list of available topics. Select the topic that you want to send messages to or receive messages from. Copy the Topic Name that needs to be used in the destination creation process. Use this copied name in the destination creation screen.

Creating an authorization in the console

An authorization is required to grant one service access to another service.You must grant Event Notifications the appropriate IAM service-to-service access so that it can publish messages to Event Streams.

To learn the process to create an authorization between Event Notifications and Event Streams, refer Authorization between services.