翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# フリートインデックス作成の準備
AWS IoT フリートインデックス作成では、予約された名前付きシャドウ () を使用してデータを検索および集計できます`$package`。 AWS IoT およびモノの[予約済みの名前付きシャドウ](preparing-to-use-software-package-catalog.md#reserved-named-shadow)[動的グループをクエリすることで、モノ](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html)をグループ化することもできます。たとえば、特定のパッケージバージョンを使用しているモノ、特定のパッケージバージョンがインストールされていないモノ、またはパッケージバージョンがインストールされていない AWS IoT モノに関する情報を確認できます。属性を組み合わせることで、さらに詳しいインサイトを得ることができます。例えば、特定のバージョンで特定のタイプのもの (バージョン 1.0.0 や pump\$1sensor のモノのタイプなど) を識別します。詳細については、「[フリートインデックス作成](https://docs.aws.amazon.com/iot/latest/developerguide/iot-indexing.html)」を参照してください。
## `$package` シャドウをデータソースとして設定する
Software Package Catalog でフリートインデックス作成を使用するには、フリートインデックス作成を有効にし、名前付きシャドウをデータソースとして設定して、名前付きシャドウフィルターとして `$package` を定義する必要があります。フリートインデックス作成をまだ有効にしていない場合は、このプロセス内で有効にできます。コンソールの [AWS IoT Core](https://console.aws.amazon.com/iot/home) から **[設定]** を開き、**[インデックス作成の管理]**、**[名前付きシャドウの追加]**、**[デバイスソフトウェアパッケージとバージョンの追加]**、**[更新]** の順に選択します。詳細については、「[モノのインデックス作成の管理](https://docs.aws.amazon.com/iot/latest/developerguide/managing-fleet-index.html#thing-index)」を参照してください。
または、最初のパッケージを作成するときにフリートインデックス作成を有効にすることもできます。**[パッケージ管理の依存関係を有効にする]** ダイアログボックスが表示されたら、デバイスソフトウェアのパッケージとバージョンをデータソースとしてフリートインデックス作成に追加するオプションを選択します。このオプションを選択すると、フリートインデックス作成も有効になります。
**注記**
Software Package Catalog のフリートインデックス作成を有効にすると、標準のサービスコストが発生します。詳細については、「[AWS IoT Device Management, Pricing](https://aws.amazon.com/iot-device-management/pricing/)」(、料金) を参照してください。
## コンソールに表示されるメトリクス
![\[標準メトリクスのイメージ\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/package-catalog-discovery-metrics.png)
AWS IoT コンソールソフトウェアパッケージの詳細ページでは、**検出**パネルにシャ`$package`ドウを介して取り込まれた標準メトリクスが表示されます。
+ **現行バージョンのディストリビューション**チャートには、このソフトウェアパッケージに関連付けられているすべてのデバイスの AWS IoT モノに関連付けられている最新のパッケージバージョン 10 のデバイス数と割合が表示されます。**注:** ソフトウェアパッケージに含まれるパッケージバージョンが、グラフに表示されているバージョンよりも多い場合は、**その他**にグループ分けして表示できます。
+ **履歴グラフ**には、指定した期間における選択したパッケージバージョンに関連するデバイスの数が表示されます。最大 5 つのパッケージバージョンを選択し、日付範囲と時間間隔を定義するまで、最初はグラフは空です。グラフのパラメータを選択するには、**[設定]** を選択します。**[履歴グラフ]** に表示されるデータは、表示されるパッケージバージョンの数が異なることと、**[履歴グラフ]** で分析するパッケージバージョンを選択できるため、**[現在のバージョン分布]** グラフと異なる場合があります。**注:** 視覚化するパッケージバージョンを選択すると、そのバージョンはフリートメトリクスの最大数制限にカウントされます。クォータと制限の詳細については、「[フリートインデックス作成の制限とクォータ](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#fleet-indexing-limits)」を参照してください。
パッケージバージョン分布を収集する方法についてインサイトを得る別の方法については、「[Collecting package version distribution through `getBucketsAggregation`](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-fleet-indexing.html#package-version-distribution)」(によるパッケージバージョン配布の収集) を参照してください。
## クエリパターン
Software Package Catalog によるフリートのインデックス作成では、標準的にサポートされている大抵の機能 (用語、フレーズ、検索フィールドなど) を使用します。ただし、予約済みの名前付きシャドウ (`$package`) `version` キーでは、比較演算子 (小なり「`<`」や、大なり「`>`」など) と `range` クエリは使用できません。ただし、`attributes` キーではこれらのクエリを使用できます。詳細については、「[クエリ構文](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html)」を参照してください。
### サンプルデータ
**注:** 予約済みの名前付きシャドウとその構造については、「[予約済みの名前付きシャドウ](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-to-use-software-package-catalog.html#reserved-named-shadow)」を参照してください。
この例では、最初のデバイスに `AnyThing` という名前が付けられ、次のパッケージがインストールされています。
+ ソフトウェアパッケージ: `SamplePackage`
パッケージバージョン: `1.0.0`
パッケージ ID: `1111`
シャドウは次のようになります。
```
{
"state": {
"reported": {
"SamplePackage": {
"version": "1.0.0",
"attributes": {
"s3UrlForSamplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile1",
"packageID": "1111"
}
}
}
}
}
```
2 番目のデバイスには `AnotherThing` という名前が付けられ、次のパッケージがインストールされています。
+ ソフトウェアパッケージ: `SamplePackage`
パッケージバージョン: `1.0.0`
パッケージ ID: `1111`
+ ソフトウェアパッケージ: `OtherPackage`
パッケージバージョン: `1.2.5`
パッケージ ID: `2222`
シャドウは次のようになります。
```
{
"state": {
"reported": {
"SamplePackage": {
"version": "1.0.0",
"attributes": {
"s3UrlForSamplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile1",
"packageID": "1111"
}
},
"OtherPackage": {
"version": "1.2.5",
"attributes": {
"s3UrlForOtherPackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile2",
"packageID": "2222"
}
},
}
}
}
```
### サンプルクエリ
次の表は、`AnyThing` および `AnotherThing` のデバイスシャドウの例に基づいたクエリの例を示しています。詳細については、「[モノのクエリの例](https://docs.aws.amazon.com/iot/latest/developerguide/example-queries.html)」を参照してください。
**AWS IoT Device Tester for FreeRTOS の最新バージョン**
| **リクエストされた情報** | **クエリ** | **結果** |
| --- | --- | --- |
| 特定のパッケージバージョンがインストールされているモノ | `shadow.name.$package.reported.SamplePackage.version:1.0.0` | `AnyThing`, `OtherThing` |
| 特定のパッケージバージョンがインストールされていないモノ | `NOT shadow.name.$package.reported.OtherPackage.version:1.2.5` | `AnyThing` |
| パッケージ ID が 1500 を超えるパッケージバージョンを使用するすべてのデバイス | `shadow.name.$package.reported.*.attributes.packageID>1500"` | `OtherThing` |
| 特定のパッケージがインストールされていて、複数のパッケージがインストールされているモノ | `shadow.name.$package.reported.SamplePackage.version:1.0.0 AND shadow.name.$package.reported.totalCount:2` | `OtherThing` |
## `getBucketsAggregation` によるパッケージバージョン配布の収集
AWS IoT コンソール内の **Discovery** パネルに加えて、 [https://docs.aws.amazon.com/iot/latest/apireference/API_GetBucketsAggregation.html](https://docs.aws.amazon.com/iot/latest/apireference/API_GetBucketsAggregation.html) API オペレーションを使用してパッケージバージョンのディストリビューション情報を取得することもできます。パッケージバージョンの配布情報を取得するには、以下を実行する必要があります。
+ 各ソフトウェアパッケージのフリートインデックス作成内のカスタムフィールドを定義します。**注:** カスタムフィールドの作成は、[AWS IoT フリートインデックス作成のサービスクォータ](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#fleet-indexing-limits)にカウントされます。
+ カスタムフィールドを次のようにフォーマットします。
`shadow.name.$package.reported..version`
詳細については、 AWS IoT フリートインデックス作成の[「カスタムフィールド](https://docs.aws.amazon.com/iot/latest/developerguide/managing-fleet-index.html#custom-field)」セクションを参照してください。