Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

Manage Data Streams

Use this topic to add, edit, and delete data streams destinations that you have configured for streaming Routing Director's operational data.

A data stream defines how a specific data category is exported. The streaming rules you configure establishes the association between the data type, the configured destination, and the Kafka topic used for publishing. You can manage streaming configurations associated with a Kafka destination.

Export Manager GUI supports streaming of multiple Routing Director operational data categories such as Device and Underlay KPIs, Syslogs, alerts, and so on. For more information, see Export Manager Overview.

Streaming configurations are validated before activation. A stream cannot be enabled if required parameters are missing or invalid.

Once data streaming is enabled, Routing Director publishes the selected data to the configured external Kafka destination based on the defined stream settings.

Note:

Routing Director supports only Device and Underlay KPIs and Syslogs data category for this release.

Add a Data Stream

You can add a data stream by configuring streaming rules and start streaming operational data to external Kafka destination.

To add a data stream in Routing Director:

  1. Click Management > Export Manager.

    The Export Manager page is displayed.

  2. Click the Add Stream button.

    The Add Stream page is displayed.

  3. Configure the fields as described in Table 1.

    Note:

    Fields marked with an asterisk (*) are mandatory.

  4. Click Save to stream data to the configured destination.

    A confirmation message appears stating that the data stream has been successfully created. All data streams that you created is published to the destination you configured.

    Alternatively, you can click Cancel to discard your changes.

Edit Data Streams

You can edit the data streams you have configured.

To edit streams:

  1. Click Management > Export Manager.

    The Export Manager page is displayed.

  2. Select the data stream, and click the Edit (pencil) icon.

    The Edit Stream page is displayed.

  3. Edit the Kafka topic name and the data export functionality.

  4. Click Save.

    The Edit Destination page closes, and a confirmation message is displayed stating that the stream has been successfully updated.

    Alternatively, you can click Cancel to discard your changes.

Table 1: Fields on the Add Streams Page
Field Description

General

Data to Export*

Select the type of data that you want to stream from Routing Director to external Kafka system.

The selected data category determines which operational or observability data is included in the data stream.

Routing Director supports only Device and Underlay KPIs and Syslogs data category for this release.

Kafka Topic Name*

Enter the Kafka topic name where the selected data is published.

Enter the name of the Kafka topic where the selected data is published. A Kafka topic is a logical channel used to organize and store messages in a Kafka cluster.

The topic must exist on the external Kafka broker before enabling the stream.

Syslog

Select the system log severity level to export streams to the Kafka destination. Only logs at this level and higher are published. The list displays:

0 (Emergency)—System is unusable.

1 (Alert)—Immediate action required. 

2 (Critical)—Critical conditions.

3 (Error)—Error conditions.

4 (Warning)—Warning conditions.

5 (Notice)—Normal but significant condition.

6 (Informational)—Informational messages.

7 (Debug)—Debug-level messages.

Choose 7(Debug) to export all syslog messages.

Selecting a lower severity level increases the volume of exported logs.

Note:

Syslog field is displayed only when you select Syslog from the Data to Export field.

Destination Name

Displays the Kafka destination associated with the stream.

The name is inherited from the selected destination configuration and cannot be modified when creating the stream.

Type

Displays the destination system type.

Currently, Routing Director supports only Kafka destination type.

Export 

Enable or disable data export for this stream. When enabled, the streams send data to the configured destination, and when disabled, data export is paused without deleting the stream.

Related Documentation