翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

フリートインデックス作成の準備

AWS IoT フリートインデックス作成では、予約された名前付きシャドウ () を使用してデータを検索および集計できます$package。予約済みの名前付きシャドウ および のモノの動的グループ をクエリ AWS IoT することで、モノをグループ化することもできます。 https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html例えば、特定のパッケージバージョンを使用するもの、特定のパッケージバージョンがインストールされていないもの、またはパッケージバージョンがインストールされていない AWS IoT ものに関する情報を確認できます。属性を組み合わせることで、さらに詳しいインサイトを得ることができます。例えば、特定のバージョンがあり、特定のモノのタイプ (バージョン 1.0.0 や Pump_sensor のモノのタイプなど) であるモノを特定するとします。詳細については、「フリートインデックス作成」を参照してください。

$package シャドウをデータソースとして設定する

Software Package Catalog でフリートインデックス作成を使用するには、フリートインデックス作成を有効にし、名前付きシャドウをデータソースとして設定して、名前付きシャドウフィルターとして $package を定義する必要があります。フリートインデックス作成をまだ有効にしていない場合は、このプロセス内で有効にできます。コンソールの AWS IoT Core から [設定] を開き、[インデックス作成の管理]、[名前付きシャドウの追加]、[デバイスソフトウェアパッケージとバージョンの追加]、[更新] の順に選択します。詳細については、「モノのインデックス作成の管理」を参照してください。

または、最初のパッケージを作成するときにフリートインデックス作成を有効にすることもできます。[パッケージ管理の依存関係を有効にする] ダイアログボックスが表示されたら、デバイスソフトウェアのパッケージとバージョンをデータソースとしてフリートインデックス作成に追加するオプションを選択します。このオプションを選択すると、フリートインデックス作成も有効になります。

コンソールに表示されるメトリクス

AWS IoT コンソールソフトウェアパッケージの詳細ページに、検出パネルにシャ$packageドウを介して取り込まれた標準メトリクスが表示されます。

パッケージバージョン分布を収集する方法についてインサイトを得る別の方法については、「Collecting package version distribution through getBucketsAggregation」(によるパッケージバージョン配布の収集) を参照してください。

クエリパターン

Software Package Catalog によるフリートインデックス作成では、フリートインデックス作成の標準としてサポートされている機能 (用語やフレーズ、検索フィールドなど) のほとんどを使用します。例外は、予約済みの名前付きシャドウ ($package) version キーに対して comparison および range クエリを使用できないことです。ただし、attributes キーにはこれらのクエリを使用できます。詳細については、「クエリ構文」を参照してください。

データの例

注: 予約済みの名前付きシャドウとその構造については、「予約済みの名前付きシャドウ」を参照してください。

この例では、最初のデバイスに AnyThing という名前が付けられ、次のパッケージがインストールされています。

シャドウは次のようになります。

{
    "state": {
        "reported": {
            "SamplePackage": {
                "version": "1.0.0",
                "attributes": {
                    "s3UrlForSamplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile1",
                    "packageID": "1111"
                    }
            }
        }
    }
}

2 番目のデバイスには AnotherThing という名前が付けられ、次のパッケージがインストールされています。

シャドウは次のようになります。

{
    "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 のデバイスシャドウの例に基づいたクエリの例を示しています。詳細については、「モノのクエリの例」を参照してください。

getBucketsAggregation によるパッケージバージョン配布の収集

AWS IoT コンソール内の Discovery パネルに加えて、 GetBucketsAggregationAPIオペレーションを使用してパッケージバージョンのディストリビューション情報を取得することもできます。パッケージバージョンの配布情報を取得するには、以下を実行する必要があります。

詳細については、フリー AWS IoT トインデックス作成のカスタムフィールドセクションを参照してください。