在 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 亿个事件。让我们一步步了解如何设置它！

前置条件

硬件

reTerminal DM

立即购买 🖱️

软件

我们强烈建议先学习如何连接 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。