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

集計データのクエリ

AWS IoT にはGetStatistics、デバイスフリートで集計データを検索GetBucketsAggregationできる 4 つの APIs (GetCardinality、GetPercentiles、、) が用意されています。

GetStatistics

GetStatistics API および get-statistics CLI コマンドは、指定された集計フィールドのカウント、平均、合計、最小、最大、平方和、分散、および標準偏差を返します。

get-statistics CLI コマンドでは、以下のパラメータを使用します。

集計フィールドのタイプは、返される統計に影響します。

文字列値を使用した GetStatistics

文字列フィールドを集計する場合、GetStatistics を呼び出すと、クエリに一致する属性を持つデバイスの数が返されます。以下に例を示します。

aws iot get-statistics --aggregation-field 'attributes.stringAttribute'
            --query-string '*'

このコマンドは、stringAttribute という名前の属性を含むデバイスの数を返します。

{
  "statistics": {
    "count": 3
  }
}

ブール値を使用した GetStatistics

ブール値の集計フィールドを使用して GetStatistics を呼び出すと、次のようになります。

数値を使用した GetStatistics

GetStatistics を呼び出してタイプ Number の集計フィールドを指定すると、GetStatistics は次の値を返します。

次の例は、数値カスタムフィールドを使用して get-statistics を呼び出す方法を示しています。

aws iot get-statistics --aggregation-field 'attributes.numericAttribute2'
            --query-string '*'

{
  "statistics": {
    "count": 3,
    "average": 33.333333333333336,
    "sum": 100.0,
    "minimum": -125.0,
    "maximum": 150.0,
    "sumOfSquares": 43750.0,
    "variance": 13472.22222222222,
    "stdDeviation": 116.06990230986766
  }
}

数値集計フィールドの場合、フィールド値が最大倍精度値を超えた場合、統計値は空です。

GetCardinality

GetCardinality API および get-cardinality CLI コマンドは、クエリに一致する一意の値の概算数を返します。たとえば、バッテリー残量が 50% 未満のデバイスの数を調べるとします。

aws iot get-cardinality --index-name AWS_Things --query-string "batterylevel
          > 50" --aggregation-field "shadow.reported.batterylevel"

このコマンドは、バッテリー残量が 50% を超えるものの数を返します。

{
    "cardinality": 100
}

cardinality は、一致するフィールドがない場合でも、常に get-cardinality によって返されます。以下に例を示します。

aws iot get-cardinality --query-string "thingName:Non-existent*"
          --aggregation-field "attributes.customField_STR"

{
    "cardinality": 0
}

get-cardinality CLI コマンドでは、以下のパラメータを使用します。

GetPercentiles

GetPercentiles API および get-percentiles CLI コマンドは、クエリに一致する集計値をパーセンタイルグループにグループ化します。デフォルトのパーセンタイルのグループ化は 1,5,25,50,75,95,99 ですが、GetPercentiles を呼び出すときに独自のグループを指定することもできます。この関数は、指定された各パーセンタイルグループ (またはデフォルトのパーセンタイルグループ) の値を返します。パーセンタイルグループ「1」には、クエリに一致する値の約 1% に含まれる集計フィールド値が含まれます。パーセンタイルグループ「5」には、クエリに一致する値の約 5% で発生する集計フィールド値が含まれます。結果は近似値になります。クエリに一致する値が多いほど、パーセンタイルの値が正確になります。

次に、get-percentiles CLI コマンドを呼び出す例を示します。

aws iot get-percentiles --query-string "thingName:*" --aggregation-field
          "attributes.customField_NUM" --percents 10 20 30 40 50 60 70 80 90 99

{
    "percentiles": [
        {
            "value": 3.0,
            "percent": 80.0
        },
        {
            "value": 2.5999999999999996,
            "percent": 70.0
        },
        {
            "value": 3.0,
            "percent": 90.0
        },
        {
            "value": 2.0,
            "percent": 50.0
        },
        {
            "value": 2.0,
            "percent": 60.0
        },
        {
            "value": 1.0,
            "percent": 10.0
        },
        {
            "value": 2.0,
            "percent": 40.0
        },
        {
            "value": 1.0,
            "percent": 20.0
        },
        {
            "value": 1.4,
            "percent": 30.0
        },
        {
            "value": 3.0,
            "percent": 99.0
        }
    ]
}

次のコマンドは、一致するドキュメントがない場合に get-percentiles から返される出力を示します。

aws iot get-percentiles --query-string "thingName:Non-existent*"
          --aggregation-field "attributes.customField_NUM"

{
    "percentiles": []
}

get-percentile CLI コマンドでは、以下のパラメータを使用します。

GetBucketsAggregation

GetBucketsAggregationAPI およびget-buckets-aggregationCLIコマンドは、バケットのリストとクエリ文字列条件に一致するものの合計数を返します。

以下の例は、get-buckets-aggregation CLIコマンドの呼び出し方を示しています。

aws iot get-buckets-aggregation --query-string '*' --index-name AWS_Things --aggregation-field 'shadow.reported.batterylevelpercent' --buckets-aggregation-type 'termsAggregation={maxBuckets=5}'

このコマンドは、次のサンプル出力を返します。

{
    "totalCount": 20,
    "buckets": [
        {
            "keyValue": "100",
            "count": 12
        },
        {
            "keyValue": "90",
            "count": 5
        },
        {
            "keyValue": "75",
            "count": 3
        }
    ]
}

get-buckets-aggregation CLI コマンドでは、以下のパラメータを使用します。

Authorization

次のように、 AWS IoT ポリシーアクションでモノのグループのインデックスをリソース ARN として指定できます。