Edit a stream

The DataStream control panel lets you edit almost every part of your stream configurations. You can update the contract that you created the stream for, the name of your stream, the properties that you want to monitor, the parameters it logs, and the destinations where it makes the logs available.

You can view and compare all configuration versions within a stream, but you can only manage the activation status of the latest version. You also can't revert a stream to any previous version.

Version management

Every time you edit a stream, you create a new version. This lets you quickly adapt your existing streams to start collecting logs for different properties, modify data set parameters to monitor or change the destinations where they send logs.

While editing an active data stream, you create and activate a version that becomes the default version used by this stream. Once you activate the edited version, you can't revert to any previous version. For inactive streams, you can activate the stream upon activation, or save the configuration for later.

When you edit an inactive stream, you can activate it after saving by checking the Activate stream upon saving option, or leaving the box unchecked to save the stream to activate later.

You can keep track of changes to your stream in the Version history panel accessible from the DataStream control panel. On the DataStream main page, you can click Actions > History next to the relevant stream.

How to

  1. Log in to Control Center using a User ID and Password that have been configured for access to DataStream.

  2. Go to COMMON SERVICES > DataStream.

  3. On the DataStream page, find the stream that you want to edit, click · · · from the Action column, and choose Edit to open the Edit stream wizard. See View and manage versions.

🚧

Stream activation status

Pay attention to the activation status of the stream that you want to edit. When editing, DataStream creates and activates a version with the same the activation status as the edited version. For example, editing an active stream activates the new version.

  1. In Configuration, you can:
  • Edit the Name of your stream.

  • Edit the Contract ID for which you initially created the stream.

  • In Include properties, edit the properties that the stream monitors.

    You can select up to 100 properties. All properties that are part of streams that are changing their statuses, either being activated or deactivated, are grayed out, and you can't select them. You can also add up to three streams to one property. See Create a stream.

  1. Click Next to continue to the Data Sets tab:

    • In Data sets, edit the parameters that the stream collects. See Choose data parameters.

    • In Delivery, edit the destination where the stream sends logs and the delivery conditions for your log files. See Stream logs to a destination.

    • In Summary, review your changes and decide whether to activate the edited stream.

  2. Optional: Select Receive an email once activation is complete and provide a list of email addresses where you want to get notifications once the stream is active on the production network.

  3. If you're editing an active stream, click Save stream to activate the stream upon saving. For inactive streams, check the Activate stream upon saving box to activate the stream after clicking Save stream. If the box is unchecked, click Save stream to save the configuration and activate later.

    It takes about 60 minutes to activate a stream. After this time, your stream is active on the production network.

Next steps

If you activated an inactive version of a data stream, you may want to activate an entire stream in the control panel. See Activate or deactivate a stream.