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

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

で 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 によるパッケージバージョン配布の収集

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

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