IoT Agents をデバッグする方法 - FIWARE WednesdayWebinars

1. IoT Agents をデバッグする方法
(How to debug IoT Agents)
Jason Fox, Senior Technical Evangelist
FIWARE Foundation
Translated to Japanese by Kazuhito Suda, FIWARE Evangelist

2. 学習目標
 一般的な問題を診断する方法
 単独でサービスをテストする方法
 デバッグの設定方法と解釈方法
 IoT Agent の設定 :
• 設定はどこで説明および定義されているか？
• どうすればそれらをオーバーライドできるか？
 診断デバッグを追加
 どこで助けやアドバイスを探すべきか？
1

3. FIWARE Catalogue
22
Data/APIManagement
PublicationMonetization
Core Context Management
(Context Broker)
Context
Processing, Analysis, Visualization
Interface to
IoT, Robotics and third party systems
Deploymenttools
2
Development of
Context-aware applications
(Orion, 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
(Fast RTPS, Micro XRCE-DDS, FIROS)
Big Data
Context Analysis
(Cosmos)
Cloud Edge
(FogFlow)
Documents exchange
(Domibus)

4. 一般的なシナリオ : FIWARE コンテキスト・データに対する IoT センサー
3
 共通のプロトコルを使用して、デバイスからデータを受信
するために IoT Agent を使用します
 IoT Agent は、データを解釈し、Context Broker で
NGSI データ・エンティティを作成および変更する必要が
あります
 システムは状態の変化に反応しなければなりません。こ
の例では、Cygnus を使用してデータ・エンティティの状
態の変更を何らかの形でデータベースに永続化する必要
がありますが、同様に何らかの処理 (processing) また
は視覚化 (visualization) を行うこともできます
 実用的なシステムでは、トラスポートを修正したりセキュリ
ティを追加したりすることが可能です

5. 何が問題になる可能性がありますか？
 間違ったポート/リソースパス/プロトコルをリッスン
 チェック・データはチェーンの各部分で受信されます
 FIWARE service ヘッダに注意を払わない
 受け取った測定値を誤って解釈
 文字列 (Strings) を数値 (Numbers) として読み取り
 コンテナ環境での localhost の誤用
 サブスクリプションの設定が狭すぎる
 プロビジョニング・サービスとデバイスが正しくない
 非推奨インターフェースの使用 (NGSI v1)
 古いバージョンまたは互換性のない Generic Enabler を使用
4

6. 設定とプロビジョニング
 config.js
• 各 Generic Enabler のルートにある基本構成ファイル
• コメント付き
• ほとんどのオプションはオフになっています
 Docker を使うと、次のことができます :
• 自分の config.js を設定
• 一般的な ENVs を上書き
• 特定の ENVs を上書き
 グループとデバイスのプロビジョニング
• さらなる上書きオプション
5

7. デバッグ設定
デバッグ・オプションはコンポーネント間でかなり異なります :
 Orion:
 IoT Agents:
 Cygnus:
 Keyrock:
 PEP Proxy:
6
-logLevel DEBUG -noCache -logForHumans
IOTA_LOG_LEVEL=DEBUG
CYGNUS_LOG_LEVEL=DEBUG
DEBUG=idm:*
log_config.json ファイルを直接修正します

8. デバッグの実行
 実行中のサービスを確認
 ログを確認
 PM2 モニタリング
 MQTT トラフィックをリッスン
 ダミー の MQTT データを送信
7
docker ps
docker logs -f fiware-iot-agent
docker exec -it fiware-iot-agent pm2
monit
docker run -it --rm --name mqtt-
subscriber --network fiware_default
efrecon/mqtt-client sub -h mosquitto -t
"/#"
docker run -it --rm --name mqtt-publisher
--network fiware_default efrecon/mqtt-
client pub -h mosquitto -m "c|1" -t
"/TEF/motion001/attrs"

9. 健全性チェック
 各コンポーネントの指定されたバージョンに常に従います
 /version エンドポイントを使用して確認します
• リリースに対してコンポーネントのバージョンを確認します
 データを取得しているかどうかを確認するには、デバッグを読み取ります
 最初は “idPattern” を使用 : サブスクリプション内の ".*"
 timesSent などの通知 (notification) 詳細を確認してください
 IOTA_CB_NGSI_VERSION と IOTA_AUTOCAST が設定されていることを確
認してください
 プロビジョニングされたデバイスでマッピングされた属性 (attributes) を確認してく
ださい 8

10. ソースを修正して診断デバッグを追加します
 git clone - エラーメッセージのソースコードを grep します
 git clone - ソースコードの修正 - デバッグの追加 - ソースから直接イメージを作
成 - Dockerfile の修正
docker build -t iot-agent .
 フォークしたソースコードと修正 - フォークからイメージを作成
docker build -t iot-agent .
--build-arg GITHUB_ACCOUNT=<your account>
--build-arg GITHUB_REPOSITORY=<your repo>
--build-arg SOURCE_BRANCH=<your branch>
 すべての FIWARE プロジェクトはオープンソースです - PR (Pull Request) は
受け入れられます
9

11. どこでヘルプが得られますか？
 ドキュメントを読みます
• https://www.fiware.org/developers/catalogue
 GitHub ソースコードを見つけます
• https://github.com/FIWARE/catalogue
• Generic Enablers で Issues をあげます
 Stack Overflow で開発に関する質問をします
• https://stackoverflow.com/questions/tagged/fiware
• 常に質問に fiware タグと関連するタグをつけます
• Stack Overflow はサードパーティのサイトです。サイトのルールに従ってください:
• 開発に関する質問に限られます
• あなたのデバッグのログ/証拠を提供します
 FIWARE Q+A を使うともできます
• https://ask.fiware.org/questions
• 開発以外の質問も可能です
10

12. サマリ
 最初に基本的な健全性チェックを実行することで単純な問題を避けます
• 実際の問題を診断するためにチェーン内の各リンクをテストします
• デバッグの設定はコンポーネントごとに異なります。詳細については常にドキュメントを確認してください
 IoT Agents はさまざまな方法で設定でき、それを上書きできます :
• ベースの config.js, 追加設定を含む config.js, Docker ENV のよるオーバーライド
• デバイス固有のプロビジョニング
 ReadTheDocs のドキュメントを読みます
 それでも問題が解決しない場合は、ソースコードを修正してローカル・イメージを
実行して診断デバッグを追加してください
 Ask, Stack Overflow でさらなるヘルプを見つけることができます。または、
GitHub で Issues をあげてください
11

13. Thank you!
http://fiware.org
Follow @FIWARE on Twitter
12