Skip to main content

在 reTerminal DM 上集成历史数据模块进行可视化

介绍

介绍 N3uron Historian:一个基于 MongoDB 构建的强大时间序列存储系统。可以轻松配置它在 x64 位、x32 位和 ARM 架构上存储来自 MongoDB 的数据。使用 Neuron Historian,您可以存储本地或通过 N3uron Links 远程收集的标签值。此外,它还提供了便捷的存储和转发功能,用于在通信中断期间保留数据。得益于高效的压缩和分区技术,它可以处理海量数据而不会出现性能损失。作为参考,1GB 的存储空间可以容纳大约 1 亿个事件。让我们逐步深入了解如何设置它!

先决条件

硬件

软件

我们强烈建议学习如何将 N3uron 与 AWS IoT Core 连接。在本教程的后续部分,您将学习如何使用历史数据模块创建图表。如果您是 N3uron 的新手,我们建议从N3uron 入门指南开始。该指南涵盖了 N3uron Web 界面导航、理解 Web UI 和 Web Vision 模块等概念、掌握标签概念以及创建基本仪表板。建议在继续之前先探索这些基础知识。您可以通过提供的链接访问该指南。

在您的 reTerminal DM 上安装 MongoDB

在 x32 和 ARM 架构中,用户需要首先安装 MongoDB 并配置历史数据模块以将数据存储在外部 MongoDB 实例中。

  • 步骤 1:整理文件

将提供的文件(install.sh、uninstall.sh、libcryto.so.1.1 和 libssl.so1.1)放置在您的 reTerminal DM 桌面或任何其他首选位置的单独文件夹中。

  • 步骤 2:导航到文件夹

打开终端并导航到包含文件的文件夹。

cd your/folder/path
  • Step 3: Run Installation Script

Execute the install.sh file to install MongoDB.

./install.sh

在安装过程中,您可能会被提示输入您的 sudo 密码。

  • 步骤 4:验证安装

安装完成后,输入以下命令来访问 MongoDB:

mongo

这将打开 MongoDB shell。

  • 步骤 5:创建数据库

在 MongoDB shell 中,输入以下命令来创建一个名为 "mongo" 的数据库(如果不存在的话):

use mongo

现在,MongoDB 已安装在您的 reTerminal DM 上,并且您已创建了一个名为 "mongo" 的数据库。

  • 步骤 6:如果您的发行版不提供这些库,请将 libcryto.so.1.1 和 libssl.so1.1 分别放置在 /usr/lib 和 /lib 文件夹中。 使用以下命令来完成此操作
sudo cp /path/to/your/folder/libcryto.so.1.1 /usr/lib
sudo cp /path/to/your/folder/libcryto.so.1.1 /lib

sudo cp /path/to/your/folder/ libssl.so1.1 /usr/lib
sudo cp /path/to/your/folder/ libssl.so1.1 /lib

创建历史记录模块

  • 步骤 1:访问 N3uron 界面

在您的网页浏览器中访问 http://localhost:8003

  • 步骤 2:导航到配置

在导航菜单下,选择 Config,然后选择 Modules。点击三条横线图标并选择 New Module 来创建一个名为 Historian 的新模块。

  • 步骤 3:配置模块

选择 Module type 为 Historian 并保存配置。

  • 步骤 4:更改数据库类型

点击您刚创建的 Historian 模块。将数据库类型更改为 External。您将看到协议为 mongodb,数据库为 mongo。启用 Node History 模式并保存设置。

启用 Node History 模式

创建历史记录标签

  • 步骤 01:在 Explorer panel 中,选择 Tags

  • 步骤 02:在 Model 菜单中,右键点击文件夹图标,选择 New Tag 并为其命名。在此示例中,我们将使用 TestVal

  • 步骤 3:启用仿真和历史记录

Simulation 更改为 Enabled,确保历史记录已启用,并将模块名称设置为 Historian保存 设置。

note

如果您的标签没有数据源并且想要模拟它,您可以启用仿真(可选),或者给它读/写权限并手动为标签提供值。但是如果您将此标签的源设置为来自 AWS 的 MQTT,那么源就是 Aws。因此您必须禁用仿真。否则您只是在读取来自仿真的数据,而不是来自 AWS 的数据。所以在这种情况下仿真不适用,因为您正在设置标签的源来自 MQTT。

配置历史记录标签到源启用标签

要将历史记录标签嵌入到之前创建的订阅 AWS IoT Core 主题的标签中,请按如下方式修改 Subscribed_value 设置:

确保 HistoryEnabled,模块名称设置为 Historian

可视化

如果您已经创建了 WebVision 模块,您可以按照以下步骤操作:

步骤 1:导航到 WebVision

转到 Config 部分并点击 Open Designer。使用您的管理员凭据登录。

步骤 2:使用现有的主容器

由于我们在上一个教程中创建了主容器,我们在这里也将使用它。

步骤 3:添加图表组件

New component 部分下,添加一个 Chart 并为其命名。

步骤 4:创建历史数据集

在图表中,找到数据集。点击三个点并选择 New Dataset,然后选择 HistoricalDataSet

步骤 5:配置历史数据集

通过选择标签为 Subscribed_value(订阅 AWS IoT Core 主题)来配置历史数据集。将模式设置为 raw,日期模式设置为 current,启用自动重新加载,并将间隔设置为 5。将日期偏移设置为 1 分钟。

步骤 6:添加图表系列

在图表下,选择 New chartSeries 来添加新的图表系列。

步骤 7:将历史记录数据集链接到图表

要将历史记录数据集链接到图表,选择 Link dataset 并选择您刚创建的历史记录数据集。

您现在将看到折线图。自定义样式以获得更好的可见性。

为了更深入地了解图表属性,建议参考提供的文章。N3uron 的 Web 界面提供了具有众多属性的各种小部件,因此必须查阅其文档以获得最佳的用户体验和交互。探索他们的文档以获得详细的格式指南和最大化 N3uron Web 界面潜力的见解。

使用历史记录模块生成图表

对于这个任务,我们将利用历史记录模块来加载数据。与之前从头开始的方法不同,这种方法提供了一种更简单的方式来检索CSV格式的数据以供将来分析。

  • 步骤 1:添加按钮组件

向您的UI添加一个按钮组件。

  • 步骤 2:选择鼠标点击事件

在按钮的事件下选择鼠标点击

  • 步骤 3:添加动作

选择鼠标点击事件后,点击添加动作

  • 步骤 4:选择打开历史记录

从动作列表中选择打开历史记录

  • 步骤 5:配置动作属性

在这一步中,您需要根据您的要求配置动作的属性。您需要选择标签,启用重新加载,设置日期模式、模式和日期偏移。根据需要调整这些设置,以确保动作按预期运行。

  • 步骤 6:保存动作
  • 步骤 7:转到打开UI

导航到打开UI部分。

  • 步骤 8:点击按钮

点击您添加的按钮,历史记录模块将加载。为数据检索设置适当的间隔。按应用来实施更改。然后您将能够看到图表。

  • 步骤 9:启用自动重新加载

选择自动重新加载并设置适当的时间间隔。

  • 步骤 10:以表格方式查看数据

选择以表格方式查看数据的选项。

  • 步骤 11:以CSV格式下载数据

按下提供的按钮以CSV格式下载数据。

技术支持

感谢您选择我们的产品!我们在这里为您提供不同的支持,以确保您使用我们产品的体验尽可能顺畅。我们提供多种沟通渠道,以满足不同的偏好和需求。

Loading Comments...