Historianモジュールを統合してreTerminal DMで可視化する

note

この文書は AI によって翻訳されています。内容に不正確な点や改善すべき点がございましたら、文書下部のコメント欄または以下の Issue ページにてご報告ください。
https://github.com/Seeed-Studio/wiki-documents/issues

はじめに

N3uron Historianの紹介：MongoDB上に構築された強力な時系列データストレージシステムです。x64ビット、x32ビット、ARMアーキテクチャでMongoDBからデータを簡単に保存するように設定できます。Neuron Historianを使用すると、N3uron Linksを介してローカルまたはリモートで収集されたタグ値を保存できます。また、通信が途絶えた際のデータ保持のための便利なStore & Forward機能を提供します。効率的な圧縮とパーティショニングのおかげで、大量のデータをパフォーマンスを損なうことなく処理できます。参考までに、1GBのストレージで約1億件のイベントを保存できます。それでは、セットアップ手順を見ていきましょう！

前提条件

ハードウェア

reTerminal DM

今すぐ購入 🖱️

ソフトウェア

N3uronとAWS IoT Coreを接続する方法を学ぶことを強くお勧めします。このチュートリアルの後半では、Historianモジュールを使用してチャートを作成する方法を学びます。N3uronを初めて使用する場合は、N3uronのはじめにガイドから始めることをお勧めします。このガイドでは、N3uronのWebインターフェースの操作、Web UIやWeb Visionモジュールなどの概念の理解、タグの概念の把握、基本的なダッシュボードの作成について説明しています。これらの基本を最初に学ぶことをお勧めします。ガイドは提供されたリンクからアクセスできます。

reTerminal DMにMongoDBをインストールする方法

x32およびARMアーキテクチャでは、最初にMongoDBをインストールし、外部のMongoDBインスタンスにデータを保存するようにHistorianを構成する必要があります。

ステップ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シェルが開きます。

ステップ5: データベースを作成する

MongoDBシェル内で、次のコマンドを入力して、存在しない場合は「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インターフェースにアクセス

Webブラウザで http://localhost:8003 にアクセスしてください。

ステップ2: 設定に移動

ナビゲーションメニューで Config を選択し、次に Modules を選択します。三本線アイコンをクリックして New Module を選択し、Historian という名前の新しいモジュールを作成します。

ステップ3: モジュールを設定

Module type を Historian に設定し、設定を保存します。

ステップ4: データベースタイプを変更

作成したHistorianモジュールをクリックします。データベースタイプを External に変更します。プロトコルは mongodb、データベースは mongo と表示されます。Node History mode を有効にして設定を保存します。

Node Historyモードを有効化

Historianタグの作成

ステップ01: Explorerパネル内で Tags を選択します。
ステップ02: モデルメニューでフォルダーアイコンを右クリックし、New Tag を選択して名前を付けます。この例では TestVal を使用します。

ステップ3: シミュレーションと履歴を有効化

Simulation を Enabled に変更し、履歴が有効であることを確認し、モジュール名を Historian に設定します。設定を保存します。

note

タグのソースがなく、シミュレーションを行いたい場合は、シミュレーションを有効化することができます（オプション）。または、読み取り/書き込み権限を付与し、タグに手動で値を設定することも可能です。ただし、このタグのソースをAWSからのMQTTとして設定する場合、ソースはAWSになります。この場合、シミュレーションを無効にする必要があります。そうしないと、AWSからではなくシミュレーションからのデータのみを読み取ることになります。この場合、シミュレーションは適用されません。タグのソースをMQTTとして設定しているためです。

Historianタグをソース有効タグに設定

AWS IoT CoreトピックにサブスクライブされたタグにHistorianタグを埋め込むには、Subscribed_value 設定を以下のように変更します：

History が Enabled であることを確認し、モジュール名を 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インターフェースの可能性を最大限に活用するための洞察については、ドキュメントを探索してください。