Table of Contents

Stream Host

A Stream Host is an application that can either be installed as a Docker container, a Windows Service, or a Console Application. Stream Hosts enable Data Streams to run and execute actions and are also responsible for getting the configurations of Non-Virtual Agents.

Note

It is recommended that you read the article listed below to improve your understanding of Stream Host.

How to Install a Stream Host

The recommended Stream Host deployment is as a Docker container - see the Docker instructions.

For installation instructions, see Install Stream Host.

Logs

How to Check Logs

To check the logs for a Steam Host, follow the steps below:

  1. Open the Collection page.
  2. Select the Collection.
  3. Click the Stream Hosts button.
  4. Select the desired Stream Host.

Stream Host Logs

How to Set the Log Level

You can change the Log level to either Info or Trace. To change the Log Level, follow the steps below:

  1. Open the Collection page.
  2. Select the Collection.
  3. Click the Stream Hosts button.
  4. Select the desired Stream Host.

Stream Host Log Level

5. Click on Set Log level.
6. From the dropdown, select either Info or Trace.

Stream Host Log Level Select

7. Click on OK.

Stream Host Log Level OK

How to Filter Log Levels

You can filter and narrow down the errors and messages that have already been logged in the table. For example, if you filter for Info errors, only info level errors will be displayed. To filter the log level for a Steam Host, follow the steps below:

  1. Open the Collection page.
  2. Select the Collection.
  3. Click the Stream Hosts button.
  4. Select the desired Stream Host.

Stream Host Filter Logs

5. Click the icon next to the Level column.
6. Select the Log Level.
7. Click OK.

Stream Host Filter Logs Select

How to Clean the Logs

To clean the logs for a Steam Host, follow the steps below:

  1. Open the Collection page.
  2. Select the Collection.
  3. Click the Stream Hosts button.
  4. Select the desired Stream Host.

Stream Host Clean Logs

5. Click the Delete Logs button.
6. Confirm your action.

Stream Host Clean Logs Confirm

How to Export Logs

To export the logs for a Steam Host, follow the steps below:

  1. Open the Collection page.
  2. Select the Collection.
  3. Click the Stream Hosts button.
  4. Select the desired Stream Host.
  5. Click the "three dots" button.
  6. Click Export all data or Export Selected rows.

Stream Host Export Logs

How to Find Online Hosts

To find online Stream Hosts, follow the steps below:

  1. Open the Collection page.
  2. Select the Collection.
  3. Click the Stream Hosts button.

Stream Host Find Online

How to Override Variables

Although each Stream Host in a given Collection downloads the same definition of a Data Stream, the Variables defined in Data Stream Designer can be overridden by the individual Stream Host to provide the unique configuration e.g. per Asset, site, or OPC IP Address.

The options to override variables for a Stream Host are:

In practice you'd use one or the other, but it may be helpful that the Stream Host

The Stream Host retrieves variable values in the following order:

  1. Environment Variable, if no match then...
  2. Variables.xv File, if no match then...
  3. Variables (i.e. as detailed in Using a Variable)

Using Environment Variables

v4.4.2

This option can be applied to any Stream Host install scenario, although it is better suited for when running Stream Host on Docker.

Create an environment variable that is applied to a running Stream Host instance, prefixing the name of the variable that should be overridden with xmvariable__

xmvariable__NameOfVariable1=foo
xmvariable__NameOfVariable2=bar
xmvariable__NameOfVariable3=noop

Using Variables.xv files

Note

This option is not supported when running Stream Host on Docker.

  1. Open the Collection page.
  2. Select the Collection.
  3. Hover on More.
  4. Click Variables.
  5. Click Select file and upload the encrypted variables.xv file, found in the Data folder of the Stream Host's installation directory e.g. "C:\Program Files\XMPro Stream Host\Data".
  6. You can enter overrides for any Variables.
  7. Click Download to get the updated file.
  8. Replace the original file in your Stream Host folder with the new one.
  9. Restart your Stream Host to load the updated variables.

Stream Host Variables 1

Stream Host Variables 2


Last modified: July 16, 2025