管理機群指標

本主題說明如何使用主 AWS IoT 控台 AWS CLI 以及管理叢集指標。

主題

管理機群指標 (主控台)
管理機群指標 (CLI)
授權對 IoT 資源進行標記

管理機群指標 (主控台)

以下各節說明如何使用主 AWS IoT 控台來管理叢集指標。在建立機群指標之前，請確保已啟用機群索引與相關資料來源和組態。

啟用機群索引

如果已啟用機群索引，請略過此區段。

如果尚未啟用機群索引，請依照下列指示進行。

請在以下位置開啟 AWS IoT 主機：https://console.aws.amazon.com/iot/。
在 AWS IoT 功能表上，選擇 [設定]。
若要檢視詳細設定，請在 Settings (設定) 頁面向下捲動到 Fleet indexing (機群索引) 區段。
若要更新機群索引設定，請在 Fleet indexing (機群索引) 區段的右側，選取 Manage indexing (管理索引)。
在 Manage fleet indexing (管理機群索引) 頁面上，根據需求更新機群索引設定。
- 組態
  
  若要開啟物件索引，請將 Thing indexing (物件索引) 開啟，然後選取要從中建立索引的資料來源。
  
  若要開啟物件群組索引，請將 Thing group indexing (物件群組索引) 開啟。
- Custom fields for aggregation - optional (彙總的自訂欄位 – 選用)
  
  自訂欄位是欄位名稱和欄位類型對的清單。
  
  若要新增自訂欄位配對，請選擇 Add new field (新增欄位)。請輸入自訂欄位名稱 (例如 attributes.temperature)，然後從 Field type (欄位類型) 選單中選取欄位類型。請注意，自訂欄位名稱開頭為 attributes. 並會儲存為屬性，以執行物件彙總查詢。
  
  若要更新並儲存設定，請選擇 Update (更新)。

建立機群指標

請在以下位置開啟 AWS IoT 主機：https://console.aws.amazon.com/iot/。
在 AWS IoT 功能表上選擇 [管理]，然後選擇 [叢集量度]。
在 Fleet metrics (機群指標) 頁面中，選擇 Create fleet metric (建立機群指標) 並完成建立步驟。
在步驟 1 中設定機群指標
- 在 Query (查詢) 區段中輸入查詢字串，指定要執行彙總搜尋的物件或事物群組。查詢字串由屬性和值組成。對於 Properties (屬性)，選擇所需屬性；如果所需屬性未顯示在清單中，請在欄位中輸入屬性。輸入 : 後面的值。範例查詢字串可以是 thingName:TempSensor*。每輸入一個查詢字串，就按一次鍵盤上的 Enter 鍵。如果輸入多個查詢字串，請選取 and (和)、or (或)、and not (而非) 或 or not (或非) 來指定其關係。
- 在 Report properties (報告屬性) 中，從其各自的清單中選擇 Index name (索引名稱)、Aggregation type (彙總類型) 以及 Aggregation field (彙總欄位)。接下來，在 Select data (選取資料) 中選取要彙總的資料，可以在其中選取多個資料值。
- 選擇下一步。
在步驟 2 中指定機群指標屬性
- 在 Fleet metric name (機群指標名稱) 欄位中，為要建立的機群指標輸入名稱。
- 在 Description - optional (描述 – 選用) 欄位中，為要建立的機群指標輸入描述。此欄位為選用欄位。
- 在小時和分鐘欄位中，輸入要叢集測量結果發送資料的時間（多久）。 CloudWatch
- 選擇下一步。
在步驟 3 中檢閱和建立
- 檢閱步驟 1 和步驟 2 的設定。若要編輯設定，請選擇 Edit (編輯)。
- 選擇 Create fleet metric (建立機群指標)。

成功建立之後，機群指標會列示在 Fleet metric (機群指標) 頁面上。

更新機群指標

在機群指標頁面上，選擇要更新的機群指標。
在機群指標 Details (詳細資訊) 頁面上，選擇 Edit (編輯)。此操作會開啟建立步驟，讓您可以在這三個步驟中的任一步驟更新機群指標。
完成機群指標的更新後，選擇 Update fleet metric (更新機群指標)。

刪除機群指標

在機群指標頁面上，選擇要刪除的機群指標。
在顯示機群指標詳細資訊的下一個頁面上，選擇 Delete (刪除)。
在對話方塊中，輸入機群指標的名稱以確認刪除。
選擇刪除。此步驟會永久刪除機群指標。

管理機群指標 (CLI)

以下各節說明如何使用 AWS CLI 來管理叢集指標。在建立機群指標之前，請確保已啟用機群索引與相關資料來源和組態。若要為物件或物件群組啟用機群索引，請遵循管理物件索引或者管理物件群組索引中的指示。

建立機群指標

您可以使用 create-fleet-metric CLI 命令建立叢集指標。


aws iot create-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 60 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum

此命令的輸出包含機群指標的名稱和 Amazon Resource Name (ARN)。輸出看起來如下：


{
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "metricName": "YourFleetMetricName"
}

清單機群指標

您可以使用 list-fleet-metric CLI 命令列出帳戶中的所有叢集指標。


aws iot list-fleet-metrics

此命令的輸出包含所有機群指標。輸出看起來如下：


{
    "fleetMetrics": [
        {
            "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric1", 
            "metricName": "YourFleetMetric1"
        }, 
        {
            "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric2", 
            "metricName": "YourFleetMetric2"
        }
    ]
}

描述機群指標

您可以使用 describe-fleet-metric CLI 命令來顯示有關叢集測量結果的更多詳細資訊。


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

此命令的輸出包含與指定機群指標相關的詳細資訊。輸出看起來如下：


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

更新機群指標

您可以使用 update-fleet-metric CLI 命令更新叢集指標。


aws iot update-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 120 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum,count --index-name AWS_Things

該 update-fleet-metric 命令不會產生任何輸出。您可以使用 describe-fleet-metric CLI 命令查看結果。


{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625792300.881, 
    "queryString": "*", 
    "period": 120, 
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "aggregationField": "registry.version", 
    "version": 2, 
    "aggregationType": {
        "values": [
            "sum", 
            "count"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625792300.881, 
    "metricName": "YourFleetMetricName"
}

刪除機群指標

使用 delete-fleet-metric CLI 命令刪除叢集測量結果。


aws iot delete-fleet-metric --metric-name "YourFleetMetricName"

如果刪除成功或指定機群指標不存在，則此命令不會產生任何輸出。

如需詳細資訊，請參閱針對機群指標進行疑難排解。

授權對 IoT 資源進行標記

為了更好地控制可以建立、修改或使用的叢集指標，您可以將標籤附加至叢集指標。

若要標記您使用 AWS Management Console 或建立的叢集指標 AWS CLI，您必須在 IAM 政策中包含iot:TagResource動作，才能授與使用者權限。如果您的 IAM 政策不包含iot:TagResource，任何使用標籤建立叢集指標的動作都會傳回錯AccessDeniedException誤。

有關標記資源的一般資訊，請參閱標記資 AWS IoT 源。

IAM 政策範例

建立叢集指標時，請參閱下列 IAM 政策範例授與標記權限：


{
	"Version": "2012-10-17",
	"Statement": [
		{
			"Action": [
				"iot:TagResource"
			],
			"Effect": "Allow",
			"Resource": [
				"arn:aws:iot:*:*:fleetmetric/*"
			]
		},
		{
			"Action": [
				"iot:CreateFleetMetric"
			],
			"Effect": "Allow",
			"Resource": [
				"arn:aws:iot:*:*:index/*",
				"arn:aws:iot:*:*:fleetmetric/*"
			]
		}
	]
}

如需詳細資訊，請參閱適用於 AWS IoT 的動作、資源和條件鍵。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

入門教學課程

MQTT 型檔案交付