プラットフォームドキュメント

/

主要用語集

この用語集では、NEQTO.aiで使われる用語を説明します。用語は分野ごとにまとめ、詳しい手順へのリンクを添えています。表の「用語」または「種類」の見出しをクリックすると、その表の行を並べ替えられます。バッジをクリックすると、その表が種類順に並びます。

アカウントとアクセス · デバイスとペイロード · アラートルールと通知 · 接続と異常 · ダッシュボードと値 · タグとデバイスの整理 · AIによる支援と分析 · ネットワークとアーキテクチャ

アカウントとアクセス

リソースの所有者と、ユーザーの権限が及ぶ範囲を理解します。

用語 種類 定義
アカウント プラットフォーム NEQTO.aiにおける組織の最上位の環境です。アカウントには、ユーザー、ロール、請求情報、デバイス、エンドポイント、アプリケーションが属します。アプリケーションは、そのアカウント内のリソースを選んで使います。この製品上の概念にはアカウントという語を使います。管理を参照してください。
アプリケーション プラットフォーム アカウントのデバイスとエンドポイントから選んだものを扱う、プロジェクトやチーム単位のビューです。独自のダッシュボード、アラート、システム、タグ、メンバーを持ちます。分析とレポートは、そのアプリケーションの範囲で動作します。エンドポイントを割り当てると、そのエンドポイントの現在と今後のデバイスがすべて含まれます。アプリケーションを参照してください。
プラン プラットフォーム アカウントが契約している内容です。プランによって、AIクレジットの上限、データの保存期間、ユーザー数とデバイス数の上限、メールやSMSによるアラートなどの付帯サービスが決まります。請求タブで確認できます。管理を参照してください。
ロールベースのアクセス制御(RBAC) プラットフォーム 特定の操作に対する権限をまとめたロールを通じて、アクセスを付与する仕組みです。アカウントロールはアカウント全体に、アプリケーションロールは特定のアプリケーション内に適用されます。1人のユーザーが両方を持つことができ、アプリケーションごとに異なるロールを持つこともできます。

デバイスとペイロード

測定値が送信されてから、デバイスが識別され、属性へとマッピングされるまでの流れをたどります。

用語 種類 定義
属性 プラットフォーム 温度、湿度、バッテリー残量など、デバイスが送る測定値の種類の1つです。NEQTO.aiは、対応している受信ペイロードの測定値を属性にマッピングします。最初のペイロードが処理された後に、得られた値と単位を確認してください。
自動解析 AI機能 対応している受信ペイロードをデバイスと属性にマッピングする処理です。柔軟なJSON形式のほか、対象のBLEおよびEnOceanデバイスのデータのデコードに対応しています。ペイロードをマッピングできない場合は、取り込みフィードバックを確認してください。ある形式に対応していても、任意の独自形式のバイト列をデコードできるわけではありません。
デバイス プラットフォーム センサー、ゲートウェイに接続された計測機器、シミュレーションのセンサーなど、識別された測定値の送信元です。恒久的な識別子を持つ有効なペイロードがエンドポイントを通じて処理されると、アカウントの上限に余裕がある限り、デバイスは自動的に登録されます。
device_id プラットフォーム デバイスの測定値を区別するための恒久的な識別子です。推奨されるJSONエンベロープではdevice_idフィールドに指定します。送信のたびに同じ値を使ってください。値を変えると、同一デバイスの測定履歴として継続されず、新規デバイスとして登録される場合があります。
エンドポイント プラットフォーム ハードウェアやソフトウェアがNEQTO.aiにデータを送るための、受信側の接続設定です。1つのエンドポイントで多数のデバイスから測定値を受け取れます。作成時にTLS対応のMQTT、HTTPS、WSSなどの接続タイプを選びます。タイプはあとから変更できません。
neqtoai-stdペイロード プラットフォーム デバイスの測定値に推奨されるJSONエンベロープです。payload_format: "neqtoai-std"、timestamp、device_idと、valueとunitのフィールドを明示した測定値を含むdataオブジェクトを使います。そのほかの対応しているJSON形式も受け付けます。例はエンドポイントとデバイスを参照してください。

名称についての補足:APIでは、属性をdata type、エンドポイントをdata sourceと呼びます。画面では属性とエンドポイントという名称を使います。

アラートルールと通知

条件を定義し、通知先を選び、発生したイベントを追跡します。

用語 種類 定義
アラート履歴 プラットフォーム デバイスについて発生したアラートイベントの記録です。デバイス、イベントの時刻、条件、測定値を確認し、新規、進行中、保留中、完了、却下のステータスで対応状況を管理します。アラートを参照してください。
通知グループ プラットフォーム アプリケーション内で再利用できる、通知先の集まりです。ユーザーや、メールまたはSMSの宛先を持つ外部の連絡先を含められます。関係するアラートにグループを割り当てると、通知先の一覧を1か所で管理できます。
未対応のアラートイベント プラットフォーム ステータスが新規、進行中、保留中のいずれかのアラートイベントです。デバイスとシステムの行には、未対応のイベントの件数が赤で表示されます。件数をクリックすると、アラート履歴でそのイベントを確認できます。アラートを参照してください。
閾値アラート プラットフォーム デバイスの属性を、「温度が30 °Cより大きい」のように自分で定義した条件と照らし合わせるアラートです。1つのルールには最大10個の条件を設定でき、AND、OR、NORで組み合わせ、条件ごとに否定を指定できます。ANDはすべての条件を満たす場合、ORはいずれかの条件を満たす場合、NORはどの条件も満たさない場合に成立します。
解除条件 プラットフォーム 発生した閾値アラートが、いつ再び発生できるようになるかを決める設定です。経過時間か、別のデータ条件を使えます。テスト用の測定値を繰り返し送ってもアラートイベントが再び発生しない場合は、解除条件を確認してください。

接続と異常

データの送信が途絶えた状態と、測定値が想定範囲を外れた状態を区別します。

用語 種類 定義
異常検知アラート プラットフォーム 測定値が該当する異常検知の範囲を外れたときに発生するアラートです。統計的な範囲はデバイスの過去の測定値から求められ、ウォームアップに十分なデータが必要です。物理的な範囲は、これとは別にチェックされます。該当するアラートを有効にして通知アクションを設定し、アラート履歴でイベントを確認してください。設定と通知の動作についてはアラートを参照してください。
異常検知 AI機能 対応している物理的な範囲と、統計的に学習した範囲に照らして測定値をチェックする機能です。統計的なチェックはデバイスの履歴から学習し、ウォームアップの完了に十分な測定値が必要です。統計的な検知をテストする前に、デバイスの異常検知設定で属性のウォームアップの状態と、現在学習されている範囲を確認してください。
接続アラート プラットフォーム デバイスからのデータ送信が、そのデバイスのオフラインタイムアウトより長く途絶えたときのアラートです。デバイスの接続監視タブで設定します。接続状態は届いたデータに基づいて判断されるため、送信の想定間隔より長いタイムアウトを選んでください。
オフラインタイムアウト プラットフォーム デバイスがオフラインと見なされるまでに許容される、データ送信の間隔です。デバイスごとに分単位の整数で設定し、最小値は10です。タイムアウトを超えたときに通知を受け取るには、接続監視とその通知設定を構成してください。
シグマ乗数 プラットフォーム 平均値を中心に学習される統計的な異常検知範囲の幅を決める、1〜5の設定値です。デフォルト値は2です。2.5のように0.1刻みで指定できます。値を大きくすると範囲が広がって検知の感度が下がり、小さくすると範囲が狭まります。精度や信頼度を保証するスコアではありません。

ダッシュボードと値

測定値や計算結果をダッシュボードにどう表示するかを選びます。

用語 種類 定義
ダッシュボード プラットフォーム ウィジェットを配置して、デバイスのデータやアラートを表示する、アプリケーションのビューです。チャート、ゲージ、表などの種類のウィジェットを使って、選んだデータを監視します。複数のダッシュボードをタブとして開けます。ダッシュボードごとに、ダッシュボード設定で独自の外観を設定できます。ダッシュボードを参照してください。
スペーサー プラットフォーム ダッシュボードのグリッド上に配置する視覚的な区切りです。現在値のウィジェットと履歴のチャートのように、ウィジェットのグループを分けるのに使います。スペーサーはレイアウトを整えるもので、デバイスの測定値は表示しません。
集計値 プラットフォーム 一定の時間枠の測定値を、チャート用の1つの値にまとめる計算です。選択肢は最大値、最小値、平均値、合計値、絶対値の最大値、絶対値の最小値の6つです。チャートに表示する値の意味に合わせて、計算を選んでください。
ウィジェット プラットフォーム ダッシュボード上の表示部品です。選んだデバイスの属性や計算値を表示するように設定します。種類には、チャート、ゲージ、ラベル、表、マップ、プログレスバー、スイッチ、円グラフ・ドーナツグラフがあります。計算した値についてはウィジェットの計算を参照してください。

タグとデバイスの整理

デバイスにラベルを付けて、必要なデバイスを見つけ、絞り込めるようにします。

用語 種類 定義
インテリジェントタギング AI機能 タグを用いてデバイスの特徴や用途を分類・識別し、容易に検索・抽出できるようにする機能です。タグは手動で割り当てることも、Atollaの助けを借りることもできます。タグの変更案を自然な文章で依頼し、対象のデバイスとタグを確認してから変更を確定します。対応している操作の流れはタグを参照してください。
タグ プラットフォーム floor:3やLocation:Los Angelesのような、デバイスに割り当てる再利用可能なkey:value形式のラベルです。タグ管理で作成し、該当するデバイスに付けて、デバイス一覧の絞り込みに使います。タグに親子の階層はありません。
タグ管理 プラットフォーム タグを作成、編集、削除する画面です。アカウントレベルのタグはすべてのアプリケーションで使え、アプリケーションのタグはそのアプリケーション内で使えます。タグを管理したい範囲でタグ管理を開いてください。

AIによる支援と分析

Atollaを使うときや、AI分析レポートを読むときに出てくる用語です。

用語 種類 定義
エージェント型AI AI機能 ツールを使って作業の一部を実行できるAIです。NEQTO.aiでは、Atollaが情報を取得したり、アラートの下書きなど対応している変更を準備したりできます。その場合も、ユーザーの権限と、その操作の確認・確定の手順は適用されます。
AI分析レポート AI機能 選んだ期間について、1つのアプリケーションの状況をAIがまとめた要約です。集計されたデバイスの測定値とアラートの状況をもとに、アプリケーション概況、センサーの健全性、アラート状況を説明します。レポートとその裏付けとなるデータは分析で確認してください。
AIクレジット プラットフォーム Atollaとのチャットのメッセージ、下書き、分析のインサイト、ダッシュボードの計画、レポートの実行にかかるコストを測る単位です。上限と更新周期はプランで決まります。プランでAIクレジットを使用する場合、AI操作の実行前に消費されるクレジット数またはその目安が表示されます。利用できるクレジットでコストをまかなえない場合、リクエストは停止します。残高と更新日については管理を参照してください。
アラート状況 AI機能 AI分析レポートのうち、選んだ期間のアラートの状況をまとめた部分です。どのアラートが、どのくらいの頻度で、どの重要度で発生したかを含みます。どのイベントを調査すべきかを判断するのに役立ちます。
Atolla AI機能 NEQTO.aiに組み込まれたアシスタントです。Atollaに質問で開き、センサーの値、期間中の最大値、アラートの状況の説明を尋ねたり、ウィジェット、アラート、タグの変更、シミュレーションの下書きや、ウィジェットやダッシュボードの外観の変更を依頼したりできます。各種フォームでは、自然な文章で説明した内容をもとに入力欄を自動入力します。扱えるのは自分の権限で見られるデータだけで、提案された内容は、確定、適用、保存のいずれかをするまで保存されません。利用できる操作の流れはAtollaに質問を参照してください。
大規模言語モデル(LLM) AI機能 言語を処理し、生成するように訓練されたモデルです。NEQTO.aiは、AtollaやAI分析レポートなどの機能で言語モデルを使い、リクエストとそのタスクで利用できるデータや文脈を組み合わせます。
検索拡張生成(RAG) AI機能 言語モデルが質問に答える前に、関連する情報を取得する手法です。たとえば、Atollaはドキュメントの該当箇所を取得し、それを使ってNEQTO.aiの機能の仕組みを説明できます。
センサーの健全性 AI機能 AI分析レポートのうち、選んだ期間にアプリケーションのデバイスと測定値がどのように推移したかをまとめた部分です。説明されている状態は、裏付けとなる測定値とイベントを使って調査してください。

ネットワークとアーキテクチャ

接続されたデバイス、通信、共有サービスを表す一般的な用語です。

用語 種類 定義
Internet of Things(IoT) 業界用語 ネットワークを通じてデータを収集したり交換したりする物理的なデバイスです。たとえば温度センサーは、ゲートウェイを通じて測定値を送り、アプリケーションでの表示やアラートの発生に使われます。
MQTT(Message Queuing Telemetry Transport) 業界用語 センサーやゲートウェイでよく使われる、パブリッシュ/サブスクライブ型のメッセージングプロトコルです。送信側はブローカー上の名前付きトピックにメッセージをパブリッシュし、サブスクライバーはサブスクライブしているトピックのメッセージを受信します。TLS対応のMQTTは接続を暗号化します。
マルチテナンシー アーキテクチャ 顧客組織などの複数のテナントが1つのサービスを共有しつつ、アクセスとデータは分離されるソフトウェアアーキテクチャです。NEQTO.aiでユーザーのアクセス範囲を理解するには、ドキュメントで説明しているアカウント、アプリケーション、ロールの仕組みを参照してください。
プロトコル 業界用語 2つのシステムがメッセージをやり取りするための規則です。MQTT、HTTP、WebSocketがその例です。送信側とエンドポイントは、互換性のある接続設定とメッセージ形式を使う必要があります。
WebSocket(WSS) 業界用語 WebSocketは接続を維持し、やり取りのたびに新しいリクエストを始めなくても、クライアントとサーバーのどちらからでもメッセージを送信できるようにします。WSSはTLS上のWebSocketです。デバイス、アプリケーション、サーバーの間の継続的な通信に使われます。