---
title: "Historian | Examples | N3uron KB V1.21"
slug: "historian-examples"
description: "Historian is a N3uron module designed to provide a high-performance time-series storage system based on a MongoDB database. In x64 bit systems…"
updated: 2023-04-21T13:55:51Z
published: 2023-04-21T13:55:51Z
canonical: "docs.n3uron.com/historian-examples"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.n3uron.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Examples

## Retrieving data using WebUI

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

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/Figure%209-Tags-used-for-this-example.png)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 1 - Historian parameters](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/Figure%201%20-%20Historian%20parameters.png)

Figure 6: Module configuration

- **Step 4:** Configure the Tags History section.

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/Figure%2011-Tag-configuration.png)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).

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/Figure%2012-%20Data%20visualization%20configuration.png)Figure 8: Data visualization configuration

**Result****:**

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/Figure%2013-%20Chart%20of%20historical%20data.png)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 bis 2 - Historian module configuration](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/Figure%2010%20bis%202%20-%20Historian%20module%20configuration.png)Figure 10: Historian module configuration

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

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/Figure%2015-MondoDB-compass-configuration.png)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).

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/Figure%2016-Databases-created-in-compass.png)Figure 12: Databases created in compass

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/Figure%2017-Collections-inside-the-database.png)Figure 13: Collections inside the database

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/Figure%2018-2021-07-09-samples-collection.png)Figure 14: 2021-07-09 samples collection

![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/Figure%2019-Tags-collection.png)Figure 15: Tags collection

[Historian Full Product Details](https://n3uron.com/iiot-platform-modules/historian/)