本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 管理機群指標
本主題說明如何使用 AWS IoT 主控台和 AWS CLI 來管理您的機群指標。
**Topics**
+ [管理機群指標 (主控台)](#managing-fleet-metrics-console)
+ [管理機群指標 (CLI)](#managing-fleet-metrics-cli)
+ [授權對 IoT 資源進行標記](#managing-fleet-metrics-policy)
## 管理機群指標 (主控台)
下列各節說明如何使用 AWS IoT 主控台來管理您的機群指標。在建立機群指標之前，請確保已啟用機群索引與相關資料來源和組態。
### 啟用機群索引
如果已啟用機群索引，請略過此區段。
如果尚未啟用機群索引，請依照下列指示進行。
1. 在 https：//[https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/) 開啟您的 AWS IoT 主控台。
1. 在 AWS IoT 功能表中，選擇**設定**。
1. 若要檢視詳細設定，請在 **Settings** (設定) 頁面向下捲動到 **Fleet indexing** (機群索引) 區段。
1. 若要更新機群索引設定，請在 **Fleet indexing** (機群索引) 區段的右側，選取 **Manage indexing** (管理索引)。
1. 在 **Manage fleet indexing** (管理機群索引) 頁面上，根據需求更新機群索引設定。
+ **組態**
若要開啟物件索引，請將 **Thing indexing** (物件索引) 開啟，然後選取要從中建立索引的資料來源。
若要開啟物件群組索引，請將 **Thing group indexing** (物件群組索引) 開啟。
+ **Custom fields for aggregation - *optional*** (彙總的自訂欄位 – 選用)
自訂欄位是欄位名稱和欄位類型對的清單。
若要新增自訂欄位配對，請選擇 **Add new field** (新增欄位)。請輸入自訂欄位名稱 (例如 `attributes.temperature`)，然後從 **Field type** (欄位類型) 選單中選取欄位類型。請注意，自訂欄位名稱開頭為 `attributes.` 並會儲存為屬性，以執行[物件彙總查詢](https://docs.aws.amazon.com/iot/latest/developerguide/index-aggregate.html)。
若要更新並儲存設定，請選擇 **Update** (更新)。
### 建立機群指標
1. 在 https：//[https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/) 開啟您的 AWS IoT 主控台。
1. 在 AWS IoT 功能表中，選擇**管理**，然後選擇**機群指標**。
1. 在 **Fleet metrics** (機群指標) 頁面中，選擇 **Create fleet metric** (建立機群指標) 並完成建立步驟。
1. 在步驟 1 中**設定機群指標**
+ 在 **Query** (查詢) 區段中輸入查詢字串，指定要執行彙總搜尋的物件或事物群組。查詢字串由屬性和值組成。對於 **Properties** (屬性)，選擇所需屬性；如果所需屬性未顯示在清單中，請在欄位中輸入屬性。輸入 `:` 後面的值。範例查詢字串可以是 `thingName:TempSensor*`。每輸入一個查詢字串，就按一次鍵盤上的 **Enter** 鍵。如果輸入多個查詢字串，請選取 **and** (和)、**or** (或)、**and not** (而非) 或 **or not** (或非) 來指定其關係。
+ 在 **Report properties** (報告屬性) 中，從其各自的清單中選擇 **Index name** (索引名稱)、**Aggregation type** (彙總類型) 以及 **Aggregation field** (彙總欄位)。接下來，在 **Select data** (選取資料) 中選取要彙總的資料，可以在其中選取多個資料值。
+ 選擇**下一步**。
1. 在步驟 2 中**指定機群指標屬性**
+ 在 **Fleet metric name** (機群指標名稱) 欄位中，為要建立的機群指標輸入名稱。
+ 在 **Description - *optional*** (描述 – 選用) 欄位中，為要建立的機群指標輸入描述。此欄位為選用欄位。
+ 在 **Hours** (小時) 和 **Minutes** (分鐘) 欄位中，輸入希望機群指標向 CloudWatch 發送資料的時間 (頻率)。
+ 選擇**下一步**。
1. 在步驟 3 中**檢閱和建立**
+ 檢閱步驟 1 和步驟 2 的設定。若要編輯設定，請選擇 **Edit** (編輯)。
+ 選擇 **Create fleet metric** (建立機群指標)。
成功建立之後，機群指標會列示在 **Fleet metric** (機群指標) 頁面上。
### 更新機群指標
1. 在**機群指標**頁面上，選擇要更新的機群指標。
1. 在機群指標 **Details** (詳細資訊) 頁面上，選擇 **Edit** (編輯)。此操作會開啟建立步驟，讓您可以在這三個步驟中的任一步驟更新機群指標。
1. 完成機群指標的更新後，選擇 **Update fleet metric** (更新機群指標)。
### 刪除機群指標
1. 在**機群指標**頁面上，選擇要刪除的機群指標。
1. 在顯示機群指標詳細資訊的下一個頁面上，選擇 **Delete** (刪除)。
1. 在對話方塊中，輸入機群指標的名稱以確認刪除。
1. 選擇 **刪除**。此步驟會永久刪除機群指標。
## 管理機群指標 (CLI)
下列各節說明如何使用 AWS CLI 來管理您的機群指標。在建立機群指標之前，請確保已啟用機群索引與相關資料來源和組態。若要為物件或物件群組啟用機群索引，請遵循[管理物件索引](managing-index.md#enable-index)或者[管理物件群組索引](thinggroup-index.md#enable-group-index)中的指示。
### 建立機群指標
您可以使用 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"
```
如果刪除成功或指定機群指標不存在，則此命令不會產生任何輸出。
如需詳細資訊，請參閱[針對機群指標進行疑難排解](fleet-indexing-troubleshooting.md#fleet-metrics-troubleshooting)。
## 授權對 IoT 資源進行標記
為了更好地控制您可以建立、修改或使用的機群指標，您可以將標籤連接到機群指標。
若要標記您使用 AWS 管理主控台 或 建立的機群指標 AWS CLI，您必須在 IAM 政策中包含 `iot:TagResource`動作，以授予使用者許可。如果您的 IAM 政策不包含 `iot:TagResource`，使用標籤建立機群指標的任何動作都會傳回`AccessDeniedException`錯誤。
如需標記資源的一般資訊，請參閱[標記資源 AWS IoT](https://docs.aws.amazon.com//iot/latest/developerguide/tagging-iot.html)。
### 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的動作、資源和條件鍵](https://docs.aws.amazon.com//service-authorization/latest/reference/list_awsiot.html)。