FIWAREシステム内の短期履歴の管理 (Managing Short Term History within FIWARE Systems)

1. FIWAREシステム内の短期履歴の管理
(Managing Short Term History within FIWARE Systems)
Jason Fox, Senior Technical Evangelist
FIWARE Foundation
Translated to Japanese by Kazuhito Suda, FIWARE Evangelist

2. 学習目標
▪ 短期履歴 (Short Term History) とは何ですか？ スマート・アプリ
ケーション内の短期履歴はどのように関連していますか？
▪ 短期履歴を処理するために利用できる FIWARE コンポーネント
はどれですか？
▪ トレンド・グラフを作成するにはどうすればよいですか？
▪ どのようなオプションがありますか？
▪ NGSI-LD temporal インターフェースをどのように使用できます
か？
1

3. 前提条件
▪ Docker
▪ Docker Compose
▪ Git
▪ Postman
▪ Cygwin for Windows
▪ MongoDB Compass
2
git clone https://github.com/FIWARE/tutorials.Step-
by-Step.git
cd tutorials.Step-by-Step/
git submodule update --init --recursive
▪ https://www.docker.com/
▪ https://docs.docker.com/compose/install/
▪ https://git-scm.com/downloads
▪ https://www.getpostman.com/downloads/
▪ https://www.cygwin.com/install.html
▪ https://www.mongodb.com/download-
center/compass

4. FIWARE Catalogue
33
Data/APIManagement
PublicationMonetization
Core Context Management
(Context Broker)
Context
Processing, Analysis, Visualization
Interface to
IoT, Robotics and third party systems
Deploymenttools
3
Development of
Context-aware applications
(Orion, Orion-LD, Scorpio,
STH-Comet, Cygnus,
QuantumLeap, Draco)
Connection to the
Internet of Things
(IDAS, OpenMTC)
Real-time
processing of
context events
(Perseo)
Handling authorization
and access control to
APIs
(Keyrock, Wilma,
AuthZForce, APInf )
Publication and
Monetization of Context
Information
(CKAN extensions, Data/API
Biz Framework, IDRA)
Creation of
Application Dashboards
(Wirecloud)
Real-time
Processing of media
streams
(Kurento)
Business Intelligence
(Knowage)
Connection to robots
(FIROS, Fast RTPS,Micro XRCE-DDS)
Big Data
Context Analysis
(Cosmos)
Cloud Edge
(FogFlow)
Documents exchange
(Domibus)

5. STH-Comet
▪ 迅速なプロトタイピングのためのシンプルな
セットアップです
▪ 簡単にスケールできないません
▪ STH-Comet は古い NGSI v1 サブスクリ
プション・エンドポイントをリッスンします
"attrsFormat": "legacy"
▪ すべてのタイムスタンプは、
notifiedAt 属性に基づいています
▪ STH-Comet は、 MongoDB へのデータベ
ースの読み取りと書き込みの両方を担当
4

6. STH-Comet が Context Broker にサブスクライブする方法
5
フィルタリング
● id または idPattern
● type または typePattern
Conditions ブロックを使用して
クエリをさらに絞り込む :
○ q
○ attrs
通知 (Notification)
● http.url は、STH-Comet への通
知先
● luminosity をパスするだけ
● NGSI v1形式で渡されるデータには、
attrsFormat: legacy が必要
頻繁に変化する値に throttling を使用
curl -L -X POST 'http://localhost:1026/v2/subscriptions/'
-H 'Content-Type: application/json'
-H 'fiware-service: openiot'
-H 'fiware-servicepath: /'
--data-raw '{
"description": "Notify STH-Comet to sample Lamp",
"subject": {
"entities": [
{"idPattern": "Lamp.*"}
],
"condition": {
"attrs": ["luminosity"]
}
},
"notification": {
"http": {
"url": "http://sth-comet:8666/notify"
},
"attrs": ["luminosity"],
"attrsFormat": "legacy"
},
"throttling": 5
}'

7. Cygnus 経由の STH-Comet
6
▪ 本番システムのためのより複雑なソリューション
▪ スケーリングが向上します
▪ Cygnus は NGSI v2 サブスクリプションエン
ド・ポイントをリッスンします
▪ Cygnus は MongoDB へのデータベース書き
込みを担当します
▪ STH-Comet は MongoDB へのデータベース
読み取りを担当します
▪ すべてのタイムスタンプは、
notifiedAt 属性に基づきます

8. Cygnus が Context Broker にサブスクライブする方法
7
通知 (Notification)
● http.url は Cygnus への通知先
で、Cygnus 標準のポート 5051
● データは NGSI v2 形式で渡されま
す
● ジオフェンスなし、メタデータなし
luminosity のみがわたされます
curl -L -X POST 'http://localhost:1026/v2/subscriptions/'
-H 'Content-Type: application/json'
-H 'fiware-service: openiot'
-H 'fiware-servicepath: /'
--data-raw '{
"description": "Notify Cygnus to sample Lamp",
"subject": {
"entities": [
{ "idPattern": "Lamp.*" }
],
"condition": {
"attrs": ["luminosity"]
}
},
"notification": {
"http": {
"url": "http://cygnus:5051/notify"
},
"attrs": ["luminosity"]
},
"throttling": 5
}'

9. QuantumLeap
▪ QuantumLeap は NGSI v2 サブ
スクリプション・エンドポイントをリッスン
します
▪ QuantumLeap は特定の時系列
(time-series) データベースへの読
み取りと書き込みの両方を担当します
▪ タイムスタンプはメタデータ属性に基づ
いています 例 dateModified
▪ QuantumLeap API を使用するか、
代わりに API を使用して Crate-DB
に直接クエリを作成できます
▪ Grafana などの外部ツールとうまく統
合できます
8

10. QuantumLeap が Context Brokerにサブスクライブする方法
9
通知 (Notification)
● http.url は、QuantumLeap へ
の通知先
● データは、NGSI v2 形式で渡され
ます
● サブスクリプションは luminosity
と location の両方を渡します –
GeoFencing クエリを作成できます
● メタデータも必要です –
notificationsAt ではなく
dateModified を使用します
curl -L -X POST 'http://localhost:1026/v2/subscriptions/'
-H 'Content-Type: application/json'
-H 'fiware-service: openiot'
-H 'fiware-servicepath: /'
--data-raw '{
"description": "Notify QuantumLeap to sample Lamp",
"subject": {
"entities": [{"idPattern": "Lamp.*"}],
"condition": {
"attrs": ["luminosity", "location"]
}
},
"notification": {
"http": {
"url": "http://quantumleap:8668/v2/notify"
},
"attrs": ["luminosity", "location"],
"metadata": ["dateCreated","dateModified"]
},
"throttling": 5
}'

11. 時系列データ (Time-series Data) の取得
▪ STH Comet API
• Swagger 仕様
https://raw.githubusercontent.com/FIWARE/specifications/master/OpenAPI
/context.STH.Comet/STH.Comet-openapi.json
▪ QuantumLeap API
• Swagger 仕様
https://raw.githubusercontent.com/FIWARE/specifications/master/OpenAPI
/quantumLeap/quantumleap.yml
▪ Crate-DB HTTP エンドポイント:
• https://crate.io/docs/crate/reference/en/latest/interfaces/http.html
▪ ダイレクト SQL ステートメント
• SQL 文法
https://crate.io/docs/crate/reference/en/latest/sql/index.html
10

12. 時系列データ (Time-series Data) の表示
● 自作 (Build-your-own)
○ コンポーネントへの HTTP クエリ作成を使用
○ 既存のグラフ作成ライブラリを使用
■ Chart.js, Highcharts framework, eCharts など.
○ スクリプトを使用して JSON ペイロードを正しい形式に変換
● Grafana
○ SQL クエリを使用して時系列データベースにアクセス
○ 表示を修正するための設定可能なツール
● Wirecloud Widgets
○ QuantumLeap source ウィジェットを使用
○ オペレータまたは画面表示のウィジェットへのワイヤーリング
11

13. “XとYの間のエンティティのすべての値を取得”
NGSI-LD Temporal インタフェース
NGSI-LD 仕様: https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.02.01_60/gs_cim009v010201p.pdf
12
curl -G -X GET
'http://localhost:1026/ngsi-ld/temporal/entities/
urn:ngsi-ld:Vehicle:B9211’
-H 'Link: <http://fiware.org/ngsi-ld/my-
context.jsonld>; rel="http://www.w3.org/ns/json-
ld#context"; type="application/ld+json"'
-H 'Accept: application/ld+json'
-d 'attrs=speed,brandName'
-d 'timerel=between'
-d 'time=2018-08-01:12:00:00Z'
-d 'endTime=2018-08-01:13:00:00Z’
{
"id": "urn:ngsi-ld:Vehicle:B9211",
"type": "Vehicle",
"brandName": [
{
"type": "Property",
"value": "Volvo"
}
],
"speed": [
{
"type": "Property",
"value": 120,
"observedAt": "2018-08-01T12:03:00Z"
},
{
"type": "Property",
"value": 80,
"observedAt": "2018-08-01T12:05:00Z"
}
],
"@context": "http://fiware.org/ngsi-ld/my-context.jsonld"
}
▪ オプションの NGSI-LD インターフェイス
▪ デフォルトは observedAt を使用
▪ 範囲のみ、まだ集約はできない…
▪ Key-Value 形式でも利用可能

14. サマリ : 短期履歴 (Short-Term History)
▪ 短期履歴 (Short Term History) により、ユーザは一定期間に発生する傾向を発見
できます:
• Maxima, Minima, Sums Averages etc.
▪ FIWAREカタログには、短期履歴を処理する2つのコンポーネントが
含まれています
• STH-Comet
• QuantumLeap
▪ 各コンポーネントは時系列データのバケットをデータベースに配置し、
APIを介して取得を提供します
▪ 任意のグラフ作成ツールを使用して結果を表示します
▪ NGSI-LD temporal interface を使用して、observedAt プロパティまたは
その他の DateTime プロパティに基づいて範囲データを返すことができます
13

15. Thank you!
http://fiware.org
Follow @FIWARE on Twitter
14