翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# フリートのメトリクスの管理
このトピックでは、 AWS IoT コンソールと AWS CLI を使用してフリートメトリクスを管理する方法について説明します。
**Topics**
+ [フリートメトリクスの管理 (コンソール)](#managing-fleet-metrics-console)
+ [フリートのメトリクスの管理 (CLI)](#managing-fleet-metrics-cli)
+ [IoT リソースのタグ付けを承認する](#managing-fleet-metrics-policy)
## フリートメトリクスの管理 (コンソール)
以下のセクションでは、 AWS IoT コンソールを使用してフリートメトリクスを管理する方法を示します。フリートメトリックスを作成する前に、関連するデータソースでフリートインデックス作成が有効になっていることを確認してください。
### フリートインデックス作成を有効にする
フリートインデックス作成がすでに有効になっている場合は、このセクションをスキップしてください。
フリートのインデックス作成を有効にしていない場合は、次の手順に従ってください。
1. [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/) で AWS IoT コンソールを開きます。
1. AWS IoT メニューで、**設定** を選択します。
1. 詳細設定を表示するには、[**Settings**](設定)ページで、[**Fleet indexing**](フリートインデックスを作成する)セクションまでスクロールダウンします。
1. フリートインデックス作成設定を更新するには、[**Fleet indexing**](フリートインデックスの作成)セクションで、[**Manage indexing**](インデックス作成の管理)を選択します。
1. [**Manage fleet indexing**] (フリートインデックス作成の管理) ページで、必要に基づいてフリートインデックス作成の設定を更新します。
+ **設定**
モノのインデックス作成を有効にするには、[**Thing indexing]**(モノのインデックス作成)をオンにして、インデックスを作成するデータソースを選択します。
モノグループのインデックス作成を有効にするには、[**Thing group indexing**](モノグループのインデックス作成)をオンに切り替えます。
+ **集約のカスタムフィールド - *オプション***
カスタムフィールドは、フィールド名とフィールドタイプのペアのリストです。
カスタムフィールドのペアを追加するには、**[Add New field**](新しいフィールドを追加)を選びます。`attributes.temperature` のようなカスタムフィールド名を入力してから、[**Field type**] (フィールドタイプ) メニューからフィールドタイプを選択します。カスタムフィールド名は `attributes.` で始まり、[モノの集計クエリ](https://docs.aws.amazon.com/iot/latest/developerguide/index-aggregate.html)を実行するための属性として保存されることに注意してください。
設定を更新して保存するには、[**Update**](更新)を選びます。
### フリートメトリクスを作成します
1. [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/) で AWS IoT コンソールを開きます。
1. AWS IoT メニューで、**管理**を選択し、**フリートメトリクス**を選択します。
1. [**Fleet metrics**] (フリートメトリクス) ページで, [**Create fleet metric**] (フリートメトリクスの作成) をクリックして、作成ステップを完了します。
1. ステップ 1で、[**Configure fleet metrics**](フリートメトリクス)を設定します。
+ **Query**(クエリ)セクションで、集約検索を実行したいモノまたは、モノのグループを指定するクエリ文字列を入力します。クエリ文字列は、属性と値で構成されます。[**Properties**] (プロパティ) には、使用したい属性を選びます。あるいは、リストに属性が表示されていない場合は、フィールドに属性を入力します。`:`の後に値を入力してください。クエリ文字列の例として、`thingName:TempSensor*`があります。入力するクエリ文字列ごとに、キーボードの**Enter**を押します。複数のクエリ文字列を入力する場合は、それらの間に、**and**、**or**、**and not**、または **or not** を選択してそれらの関係を指定します。
+ **[レポートのプロパティ]** で、**[インデックス名]**、**[集計タイプ]**、**[集計フィールド]** をそれぞれのリストから選択します。次に、[**Select data**](データの選択)で集計したいデータを選択します。そこでは、複数のデータ値を選択できます。
+ **[Next]** (次へ) を選択します。
1. ステップ 2で、[**Specify fleet metric properties**](フリートメトリクスプロパティを指定)
+ [**Fleet metric name**](フリートメトリクス)フィールドに、作成しているフリートメトリクスの名前を入力します。
+ [**Description-*optional***](説明 - オプション)フィールドに、作成しているフリートメトリクスの説明を入力します。このフィールドはオプションです。
+ [**Hours**](時間)および[**Minutes**](分)フィールドに、フリートメトリクスがCloudWatchにデータを送信する時間（頻度）を入力します。
+ [**次へ**] を選択します。
1. ステップ3の [**Review and create**](確認と作成)
+ ステップ 1 とステップ 2 の設定を確認します。設定を編集するには、[**Edit**](編集)を選びます。
+ [**Create fleet metric**](フリートメトリクスの作成)を選びます。
作成に成功すると、[**Fleet metric**](フリートメトリクス)ページで、フリートメトリックスがリスト化されます。
### フリートメトリクスを更新します
1. [**フリートメトリクス**] ページで、更新したいフリートメトリクスを選択します。
1. [**Fleet Details**](フリートの詳細) タブで、[**Edit**]（編集）を選びます。これにより、作成ステップが開き、3 つのステップのいずれかでフリートメトリクスを更新する事ができます。
1. フリートメトリクスの更新が完了したら、[**Update fleet metric**](フリートメトリクスの更新)を選択します。
### フリートメトリクスを削除する
1. [**フリートメトリクス**] ページで、削除したいフリートメトリクスを選びます。
1. フリートメトリクスの詳細を表示する次のページで、[**Delete**](削除)を選びます。
1. ダイアログボックスで、削除を確認するフリートメトリクスの名前を入力します。
1. [**Delete**](削除) を選びます。このステップは、フリートメトリクスを永続的に削除します。
## フリートのメトリクスの管理 (CLI)
以下のセクションでは、 を使用してフリートメトリクス AWS CLI を管理する方法を示します。フリートメトリクスを作成する前に、関連するデータソースおよび設定と一緒に、フリートインデックス作成が有効になっていることを確認してください。モノまたはモノのグループのフリートのインデックス作成を有効にするために、[[Managing thing indexing](managing-index.md#enable-index)](モノのインデックス化管理)または[[Managing thing group indexing](thinggroup-index.md#enable-group-index)](モノのグループインデックス化管理)の手順に従ってください。
### フリートメトリクスを作成します
フリートメトリクスを作成するには、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-メトリクスコマンドは、出力を生成しません。describe-fleet-メトリクス 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"
```
このコマンドは、削除が成功した場合、または存在しないフリートメトリクスを指定した場合、出力を生成しません。
詳細については、「[フリートメトリクスのトラブルシューティング](fleet-indexing-troubleshooting.md#fleet-metrics-troubleshooting)」をご覧ください。
## IoT リソースのタグ付けを承認する
作成、変更、または使用できるフリートメトリクスをより適切に制御するために、フリートメトリクスにタグをアタッチすることができます。
AWS マネジメントコンソール または を使用して作成したフリートメトリクスにタグを付けるには AWS CLI、IAM ポリシーに `iot:TagResource`アクションを含めて、ユーザーアクセス許可を付与する必要があります。IAM ポリシーに `iot:TagResource` が含まれていない場合、タグを使用してフリートメトリクスを作成するアクションは `AccessDeniedException` エラーを返します。
リソースへのタグ付けに関する一般情報については、「[AWS IoT リソースのタグ付け](https://docs.aws.amazon.com//iot/latest/developerguide/tagging-iot.html)」を参照してください。
### 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のアクション、リソース、および条件キー](https://docs.aws.amazon.com//service-authorization/latest/reference/list_awsiot.html)を参照してください。