フリートメトリクスの管理 (コンソール)フリートのメトリクスの管理 (CLI)IoT リソースのタグ付けを承認する

フリートのメトリクスの管理

このトピックでは、 AWS IoT コンソールと AWS CLI を使用してフリートメトリクスを管理する方法について説明します。

トピック

フリートメトリクスの管理 (コンソール)
フリートのメトリクスの管理 (CLI)
IoT リソースのタグ付けを承認する

フリートメトリクスの管理 (コンソール)

以下のセクションでは、 AWS IoT コンソールを使用してフリートメトリクスを管理する方法を示します。フリートメトリックスを作成する前に、関連するデータソースでフリートインデックス作成が有効になっていることを確認してください。

フリートインデックス作成を有効にする

フリートインデックス作成がすでに有効になっている場合は、このセクションをスキップしてください。

フリートのインデックス作成を有効にしていない場合は、次の手順に従ってください。

https://console.aws.amazon.com/iot/ で AWS IoT コンソールを開きます。
AWS IoT メニューで、設定を選択します。
詳細設定を表示するには、[Settings](設定)ページで、[Fleet indexing](フリートインデックスを作成する)セクションまでスクロールダウンします。
フリートインデックス作成設定を更新するには、[Fleet indexing](フリートインデックスの作成)セクションで、[Manage indexing](インデックス作成の管理)を選択します。
[Manage fleet indexing] (フリートインデックス作成の管理) ページで、必要に基づいてフリートインデックス作成の設定を更新します。
- 設定
  
  モノのインデックス作成を有効にするには、[Thing indexing](モノのインデックス作成)をオンにして、インデックスを作成するデータソースを選択します。
  
  モノグループのインデックス作成を有効にするには、[Thing group indexing](モノグループのインデックス作成)をオンに切り替えます。
- [Custom fields for aggregation - optional] (集計用のカスタムフィールド - オプション)
  
  カスタムフィールドは、フィールド名とフィールドタイプのペアのリストです。
  
  カスタムフィールドのペアを追加するには、[Add New field](新しいフィールドを追加)を選びます。attributes.temperature のようなカスタムフィールド名を入力してから、[Field type] (フィールドタイプ) メニューからフィールドタイプを選択します。カスタムフィールド名は attributes. で始まり、モノの集計クエリを実行するための属性として保存されることに注意してください。
  
  設定を更新して保存するには、[Update](更新)を選びます。

フリートメトリクスを作成します

https://console.aws.amazon.com/iot/ で AWS IoT コンソールを開きます。
AWS IoT メニューで の管理を選択し、フリートメトリクス を選択します。
[Fleet metrics] (フリートメトリクス) ページで, [Create fleet metric] (フリートメトリクスの作成) をクリックして、作成ステップを完了します。
ステップ 1で、[Configure fleet metrics](フリートメトリクス)を設定します。
- Query(クエリ)セクションで、集約検索を実行したいモノまたは、モノのグループを指定するクエリ文字列を入力します。クエリ文字列は、属性と値で構成されます。[Properties] (プロパティ) には、使用したい属性を選びます。あるいは、リストに属性が表示されていない場合は、フィールドに属性を入力します。:の後に値を入力してください。クエリ文字列の例として、thingName:TempSensor*があります。入力するクエリ文字列ごとに、キーボードのEnterを押します。複数のクエリ文字列を入力する場合は、それらの間に、and、or、and not、またはor notを選択してそれらの関係を指定します。
- [Report properties](レポートのプロパティ) で、それぞれのリストから[Index name]（インデックス名）、[Aggregation type](集計タイプ)、および[Aggregation field](集計フィールド)選びます。次に、[Select data](データの選択)で集計したいデータを選択します。そこでは、複数のデータ値を選択できます。
- [Next] (次へ) を選択します。
ステップ 2で、[Specify fleet metric properties](フリートメトリクスプロパティを指定)
- [Fleet metric name](フリートメトリクス)フィールドに、作成しているフリートメトリクスの名前を入力します。
- [Description-optional](説明 - オプション)フィールドに、作成しているフリートメトリクスの説明を入力します。このフィールドはオプションです。
- 時間と分フィールドに、フリートメトリクスがにデータを送信する時間 (頻度) を入力します CloudWatch。
- [次へ] を選択します。
ステップ3の [Review and create](確認と作成)
- ステップ 1 とステップ 2 の設定を確認します。設定を編集するには、[Edit](編集)を選びます。
- [Create fleet metric](フリートメトリクスの作成)を選びます。

作成に成功すると、[Fleet metric](フリートメトリクス)ページで、フリートメトリックスがリスト化されます。

フリートメトリクスを更新します

[フリートメトリクス] ページで、更新したいフリートメトリクスを選択します。
[Fleet Details](フリートの詳細) タブで、[Edit]（編集）を選びます。これにより、作成ステップが開き、3 つのステップのいずれかでフリートメトリクスを更新する事ができます。
フリートメトリクスの更新が完了したら、[Update fleet metric](フリートメトリクスの更新)を選択します。

フリートメトリクスを削除する

[フリートメトリクス] ページで、削除したいフリートメトリクスを選びます。
フリートメトリクスの詳細を表示する次のページで、[Delete](削除)を選びます。
ダイアログボックスで、削除を確認するフリートメトリクスの名前を入力します。
[Delete](削除) を選びます。このステップは、フリートメトリクスを永続的に削除します。

フリートのメトリクスの管理 (CLI)

以下のセクションでは、を使用してフリートメトリクス AWS CLI を管理する方法を示します。フリートメトリクスを作成する前に、関連するデータソースおよび設定と一緒に、フリートインデックス作成が有効になっていることを確認してください。モノまたはモノのグループのフリートのインデックス作成を有効にするために、[Managing thing indexing](モノのインデックス化管理)または[Managing thing group indexing](モノのグループインデックス化管理)の手順に従ってください。

フリートメトリクスを作成します

create-fleet-metric CLI コマンドを使用してフリートメトリクスを作成できます。


aws iot create-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 60 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum

このコマンドの出力には、フリートメトリクスの名前と Amazon リソースネーム (ARN) が含まれます。出力は次のようになります。


{
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "metricName": "YourFleetMetricName"
}

フリートメトリクスを一覧表示します

list-fleet-metric CLI コマンドを使用して、アカウント内のすべてのフリートメトリクスを一覧表示できます。


aws iot list-fleet-metrics

このコマンドの出力には、すべてのフリートのメトリクスが含まれます。出力は次のようになります。


{
    "fleetMetrics": [
        {
            "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric1", 
            "metricName": "YourFleetMetric1"
        }, 
        {
            "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric2", 
            "metricName": "YourFleetMetric2"
        }
    ]
}

フリートのメトリクスを説明する

describe-fleet-metric CLI コマンドを使用して、フリートメトリクスに関するより詳細な情報を表示できます。


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

コマンドの出力には、指定されたフリートメトリクスに関する詳細情報が含まれます。出力は次のようになります。


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

フリートメトリクスを更新します

update-fleet-metric CLI コマンドを使用してフリートメトリクスを更新できます。


aws iot update-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 120 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum,count --index-name AWS_Things

update-fleet-metric コマンドは出力を生成しません。 describe-fleet-metric CLI コマンドを使用して結果を表示できます。


{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625792300.881, 
    "queryString": "*", 
    "period": 120, 
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "aggregationField": "registry.version", 
    "version": 2, 
    "aggregationType": {
        "values": [
            "sum", 
            "count"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625792300.881, 
    "metricName": "YourFleetMetricName"
}

フリートメトリクスを削除する

delete-fleet-metric CLI コマンドを使用して、フリートメトリクスを削除します。


aws iot delete-fleet-metric --metric-name "YourFleetMetricName"

このコマンドは、削除が成功した場合、または存在しないフリートメトリクスを指定した場合、出力を生成しません。

詳細については、「フリートメトリクスのトラブルシューティング」をご覧ください。

IoT リソースのタグ付けを承認する

作成、変更、または使用できるフリートメトリクスをより適切に制御するために、フリートメトリクスにタグをアタッチできます。

AWS Management Console またはを使用して作成したフリートメトリクスにタグを付けるには AWS CLI、IAM ポリシーに iot:TagResourceアクションを含めて、ユーザーアクセス許可を付与する必要があります。IAM ポリシーにが含まれていない場合iot:TagResource、タグを使用してフリートメトリクスを作成するアクションはAccessDeniedExceptionエラーを返します。

リソースのタグ付けに関する一般的な情報については、「リソースの AWS IoT タグ付け」を参照してください。

IAM ポリシーの例

フリートメトリクスを作成するときにタグ付け許可を付与する次の IAM ポリシーの例を参照してください。


{
	"Version": "2012-10-17",
	"Statement": [
		{
			"Action": [
				"iot:TagResource"
			],
			"Effect": "Allow",
			"Resource": [
				"arn:aws:iot:*:*:fleetmetric/*"
			]
		},
		{
			"Action": [
				"iot:CreateFleetMetric"
			],
			"Effect": "Allow",
			"Resource": [
				"arn:aws:iot:*:*:index/*",
				"arn:aws:iot:*:*:fleetmetric/*"
			]
		}
	]
}

詳細については、「AWS IoT のアクション、リソース、および条件キー」を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

入門チュートリアル

MQTT ベースのファイル配信