Examples

Retrieving data using WebUI

In this example, historized data will be monitored using WebUI.

Figure 5: Tags used for this example

• Step 1: Add a new module in the “Modules” section, choose a name, and select “Historian” as the “Module type”.
• Step 2: Configure the Logger and API settings for the Historian module. In this example, the default configuration is left unedited since, in most cases, this is a valid configuration. 
• Step 3: Configure the module. For this example, the configuration was left as per default.

Figure 6: Module configuration

• Step 4: Configure the Tags History section.

Figure 7: Tag configuration

• Step 5: In the Data/Historical section, navigate to Tag list three to drag and drop the tags that will be historized to Selected tags, configure data retrieval parameters (Date mode, Interval, and Mode) and apply historization. In this example, the chosen parameters are Current for Date mode (other available options are: Absolute and Relative), 1 hour for Interval and Raw for Mode (other available options are: Aggregated, Delta, and Filter).

Figure 8: Data visualization configuration

Result:

Figure 9: Chart of historical data

Storing data using an external MongoDB engine

In this example, data will be stored and monitored in an external MongoDB engine. The GUI (graphical user interface) for MongoDB used for this example is MongoDB Compass.

• Step 1: Add a new module in the “Modules” section, choose a name and select “Historian” as the “Module type”.
• Step 2: Configure the Logger and API settings for the Historian module. In this example, the default configuration is left unedited since, in most cases, this is a valid configuration. 
• Step 3: Configure the module by disabling the Embedded DB engine and configure the rest of the parameters.

Figure 10: Historian module configuration

• Step 4: Configure the MongoDB client and connect it to N3uron’s Historian.

Figure 11: MongoDB compass configuration

Result: A database named “n3uron” (as configured previously in the module configuration section) is automatically created by Historian. This database contains the following collections: Tags collection, Samples collection (everyday a new collection is created), and Alarms collection (everyday a new collection is created).

Figure 12: Databases created in compass

Figure 13: Collections inside the database

Figure 14: 2021-07-09 samples collection

Figure 15: Tags collection

Historian Full Product Details