Activate Cloud Logging and set up a data source
This article assumes you've already activated Cloud Logging (or started the 30 day free trial) and have 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:
- A 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 (supported on the IXrouter3 in firmware 3.13 and up). 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 (supported on the IXrouter3 in firmware 3.11 and up). 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 IXrouter 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. The edge aggregator is supported on the IXrouter2 in firmware 2.11 and up, and on the IXrouter3 in firmware 3.7 and up.- Press [Add].
Duplicate
You can easily duplicate
Temporary disconnect
After this next step, the config push, the device will temporarily disconnect to reconfigure its Cloud Logging 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 Cloud Logging 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
.