Configure data tags

Activate Cloud Logging and set up a data source

This article assumes you’ve already set up a data source (including variables). View our corresponding guides if you haven’t yet.

The second step in Cloud Logging is to configure data tags. Data tags describe how you wish to log your variables. You can choose to log them at a static interval (100ms – 1hour), when their value changes, or on a custom trigger. Additionally, you define how long the data should be stored (retention policy).

Add data tags

It is possible to use the same variable for different data tags. You are free to add countless data tags.

  • Go to [Devices] in the main menu, select the concerning device, open its [Apps] tab, and [Open] the Cloud Logging app.
  • Press [Tags], select the concerning data source if you’ve configured more than one, and press the add data tag-icon .

You can choose to:

Manually add new data tags

When you press [Add new data tag] you’ll see the window that is depicted below.

  • Select the concerning variable, enter a tag name, and follow the steps below.
  • Select a “log on“-option and retention policy.

Log on …

You can log your variable at different intervals or events: 

  • static interval (200ms – 1hour). This is the most common choice.
  • When its value changes. Useful for values that don’t change often. This also prevents logging the same consecutive values (i.e. true, true, true, etc.) and thus prevents clutter.
  • When its value changes and each hour of unchanged value. Useful for values that rarely change, but where you still easily want to see its recent state in a status widget for example. Simply select “log on change” and the correct specification.
  • On custom trigger. You can configure your data tags to log when a custom trigger happens, which has multiple uses. Please view “Configure triggers” for more details and examples.
  • Apply a formula.

Formula

To have reliable and accurate data the x500 IoT gateway is constantly requesting the variables’ value. The edge aggregator processes this data between logging intervals. You can apply a formula to this data: mean, min, max, last.

  • Press [Add].

Duplicate

You can easily duplicate this data tag if you’re adding data tags that are only slightly different. This way you’ll only have to make small adjustments.

Temporary disconnect

After this next step, the config push, the device will temporarily disconnect to reconfigure its settings and will automatically reconnect. This may take a minute.

  • Finally, press [Push changes] in the config tab to complete the setup.

Next step

Now that you’ve added the data tags and started logging your data, you can start to visualize your data in data reports (historic data) or live monitors (live data).

Import data tags from a file (or device)

You can easily and effortlessly copy data tags from one device to another by exporting the concerning data tags (view the “Manage data tags” part of this article) and then importing them in your new device. Alternatively, you can manually prepare your data tags in the required CSV format to load them all at once into your cloud logger. The CSV file structure is explained in our “Import data tags: CSV file structure“-article.

When you press [Import from CSV-file], you’ll see a browse window.

  • Select a CSV file to import and press [Open].
  • When the file has been read, press [Add] to add all the data tags.

CSV file layout

If you created the CSV file yourself and are unsure about the layout, it is best you create a **template CSV file** by creating several temporary variables and exporting those as a CSV file (view the “Manage data tags” part of this article).

Temporary disconnect

After this next step, the config push, the device will temporarily disconnect to reconfigure its settings and will automatically reconnect. This may take a minute.

  • Finally, press [Push changes] in the config tab to complete the setup.

Next step

Now that you’ve added the data tags and started logging your data, you can start to visualize your data in data reports (historic data) or live monitors (live data).

Manage data tags

Select the data source under [Configuration]. You can view all defined data tags in a list view or table view.

Multiple data tags can be selected by pressing the  icon on the left. These can then be removed, duplicated, or exported to a CSV file.