入門チュートリアル

次のコマンドを実行して、フリートインデックス作成を有効にし、検索元のデータソースを指定します。

aws iot update-indexing-configuration \
--thing-indexing-configuration "thingIndexingMode=REGISTRY_AND_SHADOW,customFields=[{name=attributes.temperature,type=Number},{name=attributes.rackId,type=String},{name=attributes.stateNormal,type=Boolean}],thingConnectivityIndexingMode=STATUS" \

前の CLI コマンドの例は、AWS_Things インデックスを使用して、フリートインデックス作成に、レジストリーデータ、シャドウデータ、およびモノの接続ステータスの検索サポートをさせます。

設定の変更が完了するまで数分かかることがあります。フリートメトリクスを作成する前に、フリートインデックス作成が有効になっていることを確認してください。

フリートインデックスが有効になっているかどうかを確認するには、次の CLI コマンドを実行します：

aws --region us-east-1 iot describe-index --index-name "AWS_Things"

詳細については、「モノのインデックス作成を有効にする」をご覧ください。

次のbashスクリプトを実行して、10個のものを作成し、それらを記述します。

# Bash script. Type `bash` before running in other shells.

Temperatures=(70 71 72 73 74 75 47 97 98 99)
Racks=(Rack1 Rack1 Rack2 Rack2 Rack3 Rack4 Rack5 Rack6 Rack6 Rack6)
IsNormal=(true true true true true true false false false false)

for ((i=0; i < 10; i++))
do
  thing=$(aws iot create-thing --thing-name "TempSensor$i" --attribute-payload attributes="{temperature=${Temperatures[@]:$i:1},rackId=${Racks[@]:$i:1},stateNormal=${IsNormal[@]:$i:1}}")
  aws iot describe-thing --thing-name "TempSensor$i"
done

このスクリプトは、10 個のセンサーを表す 10 個のものを作成します。それぞれのモノは、次の表で説明されているようtemperature、rackId、 およびstateNormalの属性を持っています。

このスクリプトの出力には、10 個の JSON ファイルが含まれています。JSON ファイルのうちの 1 つが次のようになります。

{
    "version": 1, 
    "thingName": "TempSensor0", 
    "defaultClientId": "TempSensor0", 
    "attributes": {
        "rackId": "Rack1", 
        "stateNormal": "true", 
        "temperature": "70"
    }, 
    "thingArn": "arn:aws:iot:region:account:thing/TempSensor0", 
    "thingId": "example-thing-id"
}

詳細については、「モノの作成」を参照してください。

次のコマンドを実行して、high_temp_FMという名前のフリーメトリクスを作成します。フリートメトリクスを作成して、 で温度が華氏 80 度を超えるセンサーの数をモニタリングします CloudWatch。

aws iot create-fleet-metric --metric-name "high_temp_FM" --query-string "thingName:TempSensor* AND attributes.temperature >80" --period 60 --aggregation-field "attributes.temperature" --aggregation-type name=Statistics,values=count

–-メトリクス名

データ型 – 文字列 --metric-nameパラメーターは、フリートメトリクス名を指定します。この例では、high_temp_FMという名前のフリートメトリクス を作成しています。

--query <string>

データ型 – 文字列 --query-stringパラメーターは、クエリ文字列を指定します。この例では、クエリ文字列 は、名前が で始まり、温度が華氏 80 度を超えるすべてのモノTempSensorをクエリすることを意味します。詳細については、「クエリ構文」を参照してください。

–-期間

データ型: 整数 --periodパラメーターは、集計データを取得する時間を秒単位で指定します。この例では、作成するフリートメトリクスが 60 秒ごとに集計データを取得するように指定します。

–aggregation-field

データ型:文字列 --aggregation-fieldパラメーターは、評価する属性を指定します。この例では、温度属性を評価します。

–-aggregation-type

--aggregation-typeパラメーターは、フリートメトリクスに表示する統計概要を指定します。モニタリングタスクでは、異なる集計タイプ ([Statistics] (統計)、[Cardinality] (濃度)、および [Percentile] (パーセンタイル)の集計クエリプロパティをカスタマイズできます。この例では、集計タイプと統計の数を指定して、クエリに一致する属性を持つデバイスの数、つまり、温度が華氏 80 度TempSensorを超える名前で始まるデバイスの数を返します。詳細については、「集計データのクエリ」をご覧ください。

このコマンドの出力は以下のようになります。

{
    "metricArn": "arn:aws:iot:region:111122223333:fleetmetric/high_temp_FM", 
    "metricName": "high_temp_FM"
}

フリートメトリクスの作成方法については、「フリートメトリクスの管理」を参照してください。。

フリートメトリックスを作成できない場合は、「フリートメトリクスのトラブルシューティング」を参照してください。

(オプション) 次のコマンドを実行して、high_temp_FMという名前のフリートメトリクスを記述します。

aws iot describe-fleet-metric --metric-name "high_temp_FM"

このコマンドの出力は以下のようになります。

{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625249775.834, 
    "queryString": "*", 
    "period": 60, 
    "metricArn": "arn:aws:iot:region:111122223333:fleetmetric/high_temp_FM", 
    "aggregationField": "registry.version", 
    "version": 1, 
    "aggregationType": {
        "values": [
            "count"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625249775.834, 
    "metricName": "high_temp_FM"
}

https://console.aws.amazon.com/cloudwatch/ で CloudWatch コンソールを開きます。

左側のパネルの CloudWatch メニューで、メトリクス を選択してサブメニューを展開し、すべてのメトリクス を選択します。これにより、上半分はグラフが表示され、下半分は4つのタブ付きセクションが表示されたページが開きます。

最初のタブ付きセクション「すべてのメトリクス」には、グループで表示できるすべてのメトリクスが一覧表示され、「 IoTFleetMetrics」を選択します。これにはすべてのフリートメトリクスが含まれます。

[All metrics] (すべてのメトリクス) タブの [Aggregation type] (集計タイプ) セクションで、[Aggregation type] (集計タイプ) を選択して、作成したすべてのフリートメトリクスを表示します。

フリート指標を選択して、[Aggregation type](集計タイプ)セクションの左側にグラフを表示します。[メトリクス名] の左に、値　カウントが表示されます。これは、このチュートリアルの「フリートメトリクスを作成する」セクションで指定された集約タイプの値です。

[All metrics](すべてのメトリクス) タブの右にある[Graphed metrics](グラフ化したメトリクス）という名前の2番目のタブを選び、前のステップで選んだフリートメトリクスを表示します。

以下の通り、華氏 80 度以上の温度を持つセンサーの数を表示するグラフを確認できます。

（オプション）メトリクスアラームを設定できます。