Skip to main content

在 reTerminal DM 上集成 Historian 模块进行可视化

note

本文档由 AI 翻译。如您发现内容有误或有改进建议,欢迎通过页面下方的评论区,或在以下 Issue 页面中告诉我们:https://github.com/Seeed-Studio/wiki-documents/issues

简介

介绍 N3uron Historian:一个基于 MongoDB 构建的强大时间序列存储系统。它可以轻松配置以在 x64 位、x32 位和 ARM 架构中存储 MongoDB 数据。通过 Neuron Historian,您可以存储通过 N3uron Links 本地或远程收集的标签值。此外,它提供了一个方便的存储与转发功能,在通信中断期间保留数据。得益于高效的压缩和分区技术,它能够在不影响性能的情况下处理海量数据。例如,1GB 的存储空间可以容纳大约 1 亿个事件。让我们一步步了解如何设置它!

前置条件

硬件

软件

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

在 reTerminal DM 上安装 MongoDB

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

  • 步骤 1:整理文件

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

  • 步骤 2:导航到文件夹

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

cd your/folder/path
  • 步骤 3:运行安装脚本

执行 install.sh 文件以安装 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

创建 Historian 模块

  • 步骤 1:访问 N3uron 界面

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

  • 步骤 2:导航到配置

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

  • 步骤 3:配置模块

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

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

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

启用 Node History 模式

创建 Historian 标签

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

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

  • 步骤 3:启用模拟和历史记录

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

note

如果您没有标签的来源并希望模拟它,可以启用模拟(可选),或者赋予其读/写权限并手动为标签赋值。但如果您的标签来源设置为来自 AWS 的 MQTT,则来源是 AWS。因此,您必须禁用模拟。否则,您只会读取来自模拟的数据,而不是来自 AWS 的数据。因此,在这种情况下,模拟不适用,因为您正在将标签的来源设置为来自 MQTT。

将 Historian 标签配置为启用来源的标签

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

确保 History 已启用,模块名称设置为 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:将 Historian 数据集链接到图表

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

现在您将看到折线图。可以自定义样式以获得更好的可视化效果。

为了更深入地了解图表属性,建议参考提供的文章。N3uron 的 Web 界面提供了广泛的小部件和众多属性,因此查阅其文档对于优化用户体验和交互至关重要。探索其文档以获取详细的格式化指南和最大化 N3uron Web 界面潜力的见解。

使用 Historian 模块生成图表

在本任务中,我们将利用 Historian 模块加载数据。与之前从零开始的方法不同,这种方法提供了一种更简单的方式来以 CSV 格式检索数据,以便进行后续分析。

  • 步骤 1:添加按钮组件

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

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

在按钮的事件中选择 Mouse click(鼠标点击)。

  • 步骤 3:添加动作

选择鼠标点击事件后,点击 Add Action(添加动作)。

  • 步骤 4:选择 Open Historical

从动作列表中选择 Open Historical(打开历史数据)。

  • 步骤 5:配置动作属性

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

  • 步骤 6:保存动作
  • 步骤 7:进入 Open UI

导航到 Open UI 部分。

  • 步骤 8:点击按钮

点击您添加的按钮,Historian 模块将加载。为数据检索设置适当的时间间隔。按下 Apply(应用)以实施更改。随后,您将能够看到图表。

  • 步骤 9:启用自动重载

选择 Auto Reload(自动重载)并设置适当的时间间隔。

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

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

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

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

技术支持

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

Loading Comments...