IoT.kyoto VISの使い方

事前に準備するもの

IoTデバイス（計測する値を出力します）
AWSアカウント

[0] 概要説明

[0-1] IoT.kyoto VIS 構成例

[0-2] IoT.kyoto VIS を使用するために必要なデータ

たとえば、温度と照度を出力するIoTデバイスの場合に必要なデータ

IoTデバイスを識別するIDとタイムスタンプは必須です
下表の場合、temperatureとlightはIoTデバイスから出力される計測対象の値です
IoTデバイスで計測したこれらのデータは「[1] DynamoDB構築手順」でDynamoDBのテーブルを作成後、テーブルにデータを書き込みます。さらに、「[3] IoT.kyoto VIS ユーザー設定」で設定することで、リアルタイムでグラフ化することができます

deviceID	time	temperature	light
01	2016-03-04 10:17:44	25.6	103
02	2016-03-04 10:17:44	22.1	216
01	2016-03-04 10:17:45	25.8	98
02	2016-03-04 10:17:45	21.9	210

タイムスタンプは下記6種類のうちのいずれかをお使い下さい。画面表示時にUTCはJSTに自動変換されます。

[JST]
　YYYY-MM-DD hh:mm:ss
　YYYY/MM/DD hh:mm:ss
　YYYY-MM-DDThh:mm:ss.sss+0900
[UTC]
　YYYY-MM-DDThh:mm:ssZ
　UNIXタイムスタンプ(整数10桁)
　UNIXタイムスタンプ(整数13桁)

[0-3] DynamoDBにデータを書き込む方法

デバイスID／タイムスタンプ／計測値を下記のようにJSON形式で書き出します。csvは利用できません

{"light": 164, "ID": "id000", "time_sensor": "2016-03-28 15:16:48"}
{"light": 692, "ID": "id000", "time_sensor": "2016-03-28 15:16:49"}

下記のような方法でJSONをDynamoDBに書き込みます。実装例も参照して下さい
- APIを利用する
- 各種言語向けのSDKを利用する
- AWS CLIを利用する
- AWS IoTやLambdaなどのAWSのサービスを経由して書き込む
- fluentdなどのミドルウェアを利用する
- DataSpiderなどのETLツールを利用する(JSONでなくてもOK)
API/SDKついてはAWSの開発者用リソースを参照して下さい

[0-4] AWS IoTを使用する場合の設定

AWS IoTからDynamoDBにデータを書き込む場合、標準では下図のように「payload」キーに”humidity”や”light”などのキーがネストされて計測値が記録されます。「[3] IoT.kyoto VIS ユーザー設定」で「AWS IoT連携」にチェックを入れることで”humidity”や”light”などのキーを指定してグラフを描画することができます

データフォーマット(例)

{
  "thingName": "device001",
  "timestamp": "1450505098624",
  "payload": {
    "humidity": 40.64,
    "light": 487.52,
    "temperature": 29.9,
    "thingName": " device001"
  }
}

[1] DynamoDB構築手順

1. AWSにサインインします

左上のオレンジの立方体のアイコンをクリックしてください
[DynamoDB]のコンソールをクリックして開いてください

2. リージョンを確認します

特に他のリージョンを選ぶ理由がない場合は[アジアパシフィック(東京)]を選択してください

3. DynamoDB のコンソール画面で[デーブルの作成] をクリックしてください

4. テーブル名に任意の名前をつけてください

　
5. プライマリキーのパーティションキーに任意の名前をつけてください

データ型はIoTデバイスが出力する値に合わせて「文字列」または「数値」を選んでください
IoTデバイスの特定に分かりやすい名前を付けてください

6. [ソートキーの追加]のチェックボックスをクリックしてチェックを入れてください

7. プライマリキーのソートキーに任意の名前をつけてください

時間の特定に分かりやすい名前を付けてください
データ型はIoTデバイスが出力する値に合わせて「文字列」または「数値」を選んでください

8. テーブル設定の[デフォルト設定の使用]のチェックボックスをクリックしてチェックを外します

9. プロビジョニングされたキャパシティの[読み込み容量ユニット]と[書き込み容量ユニット]のテーブル数を設定してください

IoTデバイス2～3個までなら「読み込み容量ユニット」が5テーブル、「書き込み容量ユニット」が5テーブルで足ります

10. [作成]をクリックしてテーブル作成は完了です

[2] IAM Access Keyを取得する

1. Identity and Access Management(IAM)コンソールを開いてください

2. [ユーザー]をクリックして開き、[新規ユーザーの作成]をクリックし、任意の名前でユーザーを作成します

[ユーザーごとにアクセスキーを生成]のチェックボックスにチェックが入っているかどうかを確認してください
[作成]をクリックしてユーザーを作成します

3. [ユーザーのセキュリティ認証情報を非表示]をクリックして ID と Key を表示させます

表示されたアクセスキーID とシークレットアクセスキーを控えておいてください([認証情報のダウンロード]をクリックして保存してもよい)
[閉じる]をクリックして終了します

4. ユーザーの中から、作成したユーザー名をクリックします

5. [アクセス許可]をクリックして開き、[ポリシーのアタッチ]をクリックします

6. [AmazonDynamoDBReadOnlyAccess]のチェックボックスにチェックをいれ、[ポリシーのアタッチ]をクリックして、IAM の登録は完了です

IAMでReadOnlyAccessに設定することで、DynamoDBからデータを取得することが許可されます

[3] IoT.kyoto VIS ユーザー設定

1. メールアドレスとパスワードを入力し、[ログイン]をクリックしてください

下記エラーメッセージが表示されますので、[OK]をクリックします

2. [ユーザー設定]をクリックします

　
3. ユーザー情報設定を変更することができます

メールアドレスには、IoTデバイスから取得した計測値が閾値を超えた場合に通知メールが届きます
通知用メールアドレス欄が空欄の場合、ログインIDのメールアドレスに通知されます

　
4. AWSアクセス設定をします

AWSのアクセスキーIDとシークレットアクセスキーとリージョンのコードを入力してください

　
リージョンのコードは下図を参照にしてください。（2016/03/10時点）
最新のリージョンはリージョンとアベイラビリティーゾーンをご確認ください。

リージョンコード	リージョン名
us-east-1	US East (N. Virginia)
us-west-2	米国西部（オレゴン）
us-west-1	米国西部（北カリフォルニア）
eu-west-1	欧州（アイルランド）
eu-central-1	欧州（フランクフルト）
ap-southeast-1	アジアパシフィック（シンガポール）
ap-northeast-1	アジアパシフィック（東京）
ap-southeast-2	アジアパシフィック（シドニー）
ap-northeast-2	アジアパシフィック (ソウル)
sa-east-1	南米（サンパウロ）