# Streaming Rules

A streaming rule tells KORE which events you wish to stream to which destination. You can manage all your streaming rules through the [developer portal](https://build.korewireless.com/event-stream/rules).

<figure><img src="https://2506474853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ydryXnnBZcpfzlfF36e%2Fuploads%2F62dDvrhvk8DKCTyfIE7k%2Fimage.png?alt=media&#x26;token=33f27c6e-489b-4b5f-9494-8b449db3f9a2" alt=""><figcaption><p>Landing Page</p></figcaption></figure>

You will not see any streaming rules when you log in for the first time. You can review our [getting started guide](https://docs.korewireless.com/developers/get-started/event-streams) to stream KORE events to start consuming events from KORE.

When you have one or more streaming rules created, you will see them in a table.

<figure><img src="https://2506474853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ydryXnnBZcpfzlfF36e%2Fuploads%2FvKzqA9wE22uBcVpgZrx8%2Fimage.png?alt=media&#x26;token=a93036ab-e1ae-42ba-ad83-ec696b007063" alt=""><figcaption></figcaption></figure>

When reviewing the details of a streaming rule, you will be presented with a read-only view, which you can [edit](https://docs.korewireless.com/developers/how-to/event-streams/modify-my-streaming-rule).

{% hint style="info" %}
Clicking on the destination name will take you to the [details of that destination](https://docs.korewireless.com/developers/event-streams/destinations).
{% endhint %}

<figure><img src="https://2506474853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ydryXnnBZcpfzlfF36e%2Fuploads%2FXR4y1POxEUb8Jy0uPkqu%2Fimage.png?alt=media&#x26;token=0e4b7186-b94f-4706-a7c6-fa7695f12ee1" alt=""><figcaption><p>Click on the rule name to open the details</p></figcaption></figure>

<figure><img src="https://2506474853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ydryXnnBZcpfzlfF36e%2Fuploads%2F24bhk5A8P4xEYBeDPWW5%2Fimage.png?alt=media&#x26;token=c30a52fa-8da1-4875-b1ce-a9e0965c55e5" alt=""><figcaption><p>Read-only view of the rule</p></figcaption></figure>

## Streaming Rule Properties

Once created, a streaming rule has properties that help KORE understand, for example, what events you want to be sent and to where. These properties can be modified at any point.&#x20;

### Rule Status

When you create the rule, you can specify whether it will be enabled or disabled upon creation, which you can [change after](https://docs.korewireless.com/developers/how-to/event-streams/modify-my-streaming-rule#disable-enable-the-streaming-rule).&#x20;

<figure><img src="https://2506474853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ydryXnnBZcpfzlfF36e%2Fuploads%2F0gGxra0h5zboT9DE9wrf%2Fimage.png?alt=media&#x26;token=84be7322-935e-47e2-a6ac-bad1b08ca17b" alt="" width="375"><figcaption><p>Setting rule status when creating a new rule</p></figcaption></figure>

* **Enable** Status - Any events that trigger the streaming rule will be streamed to your destination
* **Disable** Status  - Any events that trigger the streaming rule will **not** be streamed to your destination

{% hint style="warning" %}
When you create your streaming rule with a status of `Enable`, KORE will start sending events to your destination, for which you may incur a cost from your cloud provider.

We encourage you to set the status as `Disable` if you are either not using the rule or are not ready to consume the events to minimize unnecessary costs by your cloud provider.
{% endhint %}

### Destination

The destination you specify in the streaming rule tells KORE where you want to receive the events.

When creating a rule, you must specify a destination, which you can [modify later](https://docs.korewireless.com/developers/how-to/event-streams/modify-my-streaming-rule#repoint-my-streaming-rule-to-a-new-destination).

Review our [destination docs](https://docs.korewireless.com/developers/event-streams/destinations) for more details.

<figure><img src="https://2506474853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ydryXnnBZcpfzlfF36e%2Fuploads%2Fphff2MacMEAwURRAUfoy%2Fimage.png?alt=media&#x26;token=923e1b63-ff04-4cd4-9997-334f54e812d7" alt="" width="375"><figcaption><p>Specifying destination on creation</p></figcaption></figure>

You can see all the streaming rules a destination has by reviewing the details of the [destination](https://docs.korewireless.com/developers/event-streams/destinations).

### Name

Each streaming rule has a name so that you can identify it quickly.

You are required to specify a name when creating the rule, which you can edit after.

<figure><img src="https://2506474853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ydryXnnBZcpfzlfF36e%2Fuploads%2Fj63Pgl8IqttTBKh8Yq6q%2Fimage.png?alt=media&#x26;token=aabbe0fd-6bfe-4638-90c4-930d0ca93247" alt="" width="375"><figcaption><p>Specify a name when creating a rule</p></figcaption></figure>

<figure><img src="https://2506474853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ydryXnnBZcpfzlfF36e%2Fuploads%2Fr9NEFO2DjRfcQw2IBtot%2Fimage.png?alt=media&#x26;token=c7343168-8afb-4d14-bead-e3a1605c8bce" alt=""><figcaption><p>Editing the rule name</p></figcaption></figure>

### Product Groups

The property group is a filter for you to go through all of the events KORE has available.

### Event Types

The event types are broken down by product, each with its own [event data schema](https://docs.korewireless.com/developers/events#event-data-schema) and schema version. You can apply the same schema version to all event types or select which events and their schema version you want.&#x20;

Selecting a schema version for an event triggers your rule to subscribe to those events. Your rule doesn't listen to that event if no schema is chosen. You can always edit the event types to which your rule is subscribed.

{% hint style="warning" %}
If you use 'Apply All' to apply the same schema to all event types, you will receive every event available for the product, which may incur additional costs.
{% endhint %}

You can view the event types available to subscribe to at the time of creation or when editing your streaming rule by either

* Clicking on the drop-down under 'Apply All,' or
* Clicking on the schema version drop-down for each event type.

<figure><img src="https://2506474853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ydryXnnBZcpfzlfF36e%2Fuploads%2FNkCl8wQbcoHYwXGxCHXA%2Fimage.png?alt=media&#x26;token=f09a3bf8-8ebb-4bf2-98e5-cb107d93e95f" alt=""><figcaption></figcaption></figure>
