入門教學課程

執行下列命令來啟用機群索引，並指定要從中搜尋的資料來源。

aws iot update-indexing-configuration \
--thing-indexing-configuration "thingIndexingMode=REGISTRY_AND_SHADOW,customFields=[{name=attributes.temperature,type=Number},{name=attributes.rackId,type=String},{name=attributes.stateNormal,type=Boolean}],thingConnectivityIndexingMode=STATUS" \

上述的 CLI 命令範例可啟用機群索引，支援使用 AWS_Things 索引來搜尋登錄檔資料、影子資料和物件連線狀態。

組態變更可能需要幾分鐘時間才能完成。在建立機群指標之前，請驗證是否已啟用機群索引。

若要檢查機群索引是否已啟用，請執行下列 CLI 命令：

aws --region us-east-1 iot describe-index --index-name "AWS_Things"

如需詳細資訊，請參閱啟用物件索引。

執行以下 Bash 指令碼來建立十個物件並提供相應描述。

# Bash script. Type `bash` before running in other shells.

Temperatures=(70 71 72 73 74 75 47 97 98 99)
Racks=(Rack1 Rack1 Rack2 Rack2 Rack3 Rack4 Rack5 Rack6 Rack6 Rack6)
IsNormal=(true true true true true true false false false false)

for ((i=0; i < 10; i++))
do
  thing=$(aws iot create-thing --thing-name "TempSensor$i" --attribute-payload attributes="{temperature=${Temperatures[@]:$i:1},rackId=${Racks[@]:$i:1},stateNormal=${IsNormal[@]:$i:1}}")
  aws iot describe-thing --thing-name "TempSensor$i"
done

這個指令碼建立了十個物件來表示十個感應器。如下表所述，每個物件都有 temperature、rackId 以及 stateNormal 屬性：

此指令碼的輸出包含十個 JSON 檔案。其中一個 JSON 檔案如下所示：

{
    "version": 1, 
    "thingName": "TempSensor0", 
    "defaultClientId": "TempSensor0", 
    "attributes": {
        "rackId": "Rack1", 
        "stateNormal": "true", 
        "temperature": "70"
    }, 
    "thingArn": "arn:aws:iot:region:account:thing/TempSensor0", 
    "thingId": "example-thing-id"
}

如需詳細資訊，請參閱建立物件。

執行下列命令建立名為 high_temp_FM 的機群指標。您可以建立機群指標，以此監控 CloudWatch 中華氏溫度超過 80 度的感應器數量。

aws iot create-fleet-metric --metric-name "high_temp_FM" --query-string "thingName:TempSensor* AND attributes.temperature >80" --period 60 --aggregation-field "attributes.temperature" --aggregation-type name=Statistics,values=count

--metric-name

資料類型：字串。此 --metric-name 參數會指定機群指標名稱。在此範例中，您建立的是名為 high_temp_FM 的機群指標。

--query-string

資料類型：字串。此 --query-string 參數會指定查詢字串。在這個範例中，查詢字串意味著查詢名稱開頭為 TempSensor 和溫度高於華氏 80 度的所有物件。如需詳細資訊，請參閱查詢語法。

--period

資料類型：整數。此 --period 參數會指定彙總資料的擷取時間 (以秒為單位)。在此範例中，您指定要建立的機群指標每 60 秒擷取一次彙總資料。

--aggregation-field

資料類型：字串。此 --aggregation-field 參數會指定要評估的屬性。在此範例中，要評估的是溫度屬性。

--aggregation-type

此 --aggregation-type 參數指定要在機群指標中顯示的統計摘要。您可以為監控任務自訂以下彙總類型的彙總查詢屬性：Statistics (統計數字)、Cardinality (基數) 以及 Percentile (百分位數)。在此範例中，您可以針對彙總類型和統計資料指定計數，以傳回具有與查詢相符之屬性的裝置計數，也就是傳回名稱開頭為 TempSensor 和溫度高於華氏 80 度的裝置計數。如需詳細資訊，請參閱查詢彙總資料。

此令命的輸出結果如下所示：

{
    "metricArn": "arn:aws:iot:region:111122223333:fleetmetric/high_temp_FM", 
    "metricName": "high_temp_FM"
}

若要進一步了解如何建立機群指標，請參閱管理機群指標。

如果無法建立機群指標，請參閱機群指標故障診斷。

(選用) 執行下列命令來描述名為 high_temp_FM 的機群指標：

aws iot describe-fleet-metric --metric-name "high_temp_FM"

此令命的輸出結果如下所示：

{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625249775.834, 
    "queryString": "*", 
    "period": 60, 
    "metricArn": "arn:aws:iot:region:111122223333:fleetmetric/high_temp_FM", 
    "aggregationField": "registry.version", 
    "version": 1, 
    "aggregationType": {
        "values": [
            "count"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625249775.834, 
    "metricName": "high_temp_FM"
}

透過 https://console.aws.amazon.com/cloudwatch/ 開啟 CloudWatch 主控台。

在左側面板的 CloudWatch 功能表上，選擇指標來展開子功能表，然後選擇所有指標。此操作會開啟頁面，其中上半部分會顯示圖形，下半部分則包含四個標籤式區段。

第一個標籤式區段所有指標會列出可以在群組中檢視的所有指標。請選擇 IoTFleetMetrics。這包含您的所有機群指標。

在 All metrics (所有指標) 索引標籤的 Aggregation type (彙總類型) 區段，選擇 Aggregation type (彙總類型) 檢視建立的所有機群指標。

選擇機群指標，在 Aggregation type (彙總類型) 區段的左側顯示圖表。您會看到指標名稱左側的值 count，這是您在本教學課程的建立機群指標區段中指定的彙總類型值。

選擇位於 All metrics (所有指標) 索引標籤右側的名為 Graphed metrics (圖表化指標) 的第二個索引標籤，檢視從上一步中選擇的機群指標。

您應該可以看到如下所示的圖表，其中顯示溫度高於華氏 80 度的感應器數量：

(選用) 您可以設定指標警示。