本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 管理实例集指标
本主题介绍如何使用 AWS IoT 控制台和管理 AWS CLI 您的队列指标。
**Topics**
+ [管理实例集指标（控制台）](#managing-fleet-metrics-console)
+ [管理实例集指标（CLI）](#managing-fleet-metrics-cli)
+ [授权对 IoT 资源进行标记](#managing-fleet-metrics-policy)
## 管理实例集指标（控制台）
以下各节介绍如何使用 AWS IoT 控制台管理队列指标。在创建机群指标之前，请确保您已使用关联的数据源和配置启用了机群索引。
### 启用实例集索引
如果您已经启用了实例集索引，请跳过此部分。
如果还没有启用实例集索引，请按照以下说明操作。
1. 在以下位置打开您的 AWS IoT 主机[https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/)。
1. 在 AWS IoT 菜单上，选择**设置**。
1. 要查看详细设置，请在**设置**页面，向下滚动到**实例集索引**部分。
1. 要更新您的实例集索引设置，请在**实例集索引**部分右侧选择**管理索引**。
1. 在**管理实例集索引**页面上，根据您的需求更新实例集索引设置。
+ **配置**
要打开事物索引，请开启**事物索引**，然后选择要从中索引的数据源。
要启用事物组索引，请打开**事物组索引**。
+ **Custom fields for aggregation - *optional***（聚合的自定义字段 - 可选）
自定义字段是字段名称和字段类型对的列表。
要添加自定义字段对，请选择 **Add new field**（添加新字段）。输入自定义字段名称，如 `attributes.temperature`，然后从**字段类型**菜单选择一个字段类型。请注意，自定义以 `attributes.` 开头的字段名称并将保存为属性来运行[事物聚合查询](https://docs.aws.amazon.com/iot/latest/developerguide/index-aggregate.html)。
要更新和保存设置，请选择 **Update**（更新）。
### 创建机群指标
1. 在以下位置打开您的 AWS IoT 主机[https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/)。
1. 在 AWS IoT 菜单上，选择**管理**，然后选择**队列指标**。
1. 在**实例集指标**页面上，选择**创建实例集指标**然后完成创建步骤。
1. 在步骤 1 中**配置机群指标**
+ 在**查询**部分中，输入查询字符串以指定要执行聚合搜索的事物或事物组。查询由属性和值组成的字符串。对于**属性**，选择所需的属性，或，如果该属性没有出现在列表中，则在字段中输入属性。在 `:` 之后输入值。一个查询字符串示例可以是 `thingName:TempSensor*`。对于输入的每个查询字符串，请按键盘上的**输入**。如果输入多个查询字符串，请通过选择 **and**、**or**、**and not** 或 **or not** 指定他们之间的关系。
+ 在**报告属性**中，从各自的列表中选择 **Index name**、**Aggregation type** 和 **Aggregation field**。接下来，在**选择数据**中选择您想要聚合的数据，您可以在其中选择多个数据值。
+ 选择**下一步**。
1. 在步骤 2 中**指定实例集指标属性**
+ 在**实例集指标名称**字段中，输入要创建实例集指标的名称。
+ 在**说明 - *可选***在段中，输入要创建实例集指标的描述。该字段是可选的。
+ 在**小时**和**分钟**字段中，输入您希望舰队指标向其发送数据的时间（频率）。 CloudWatch
+ 选择**下一步**。
1. 步骤 3：**审核并创建**
+ 查看步骤 1 和步骤 2 的设置。要编辑设置，请选择 **Edit**（编辑）。
+ 选择**创建实例集指标**。
成功创建后，**实例集指标**页面会列出实例集指标。
### 更新机群指标
1. 在**实例集指标**页面上，选择要更新的实例集指标。
1. 在实例集指标**详细信息**选项卡上，选择**编辑**。这将打开创建步骤，您可以在这三个步骤中的任何一个步骤中更新实例集指标。
1. 完成更新实例集指标后，选择**更新实例集指标**。
### 删除机群指标
1. 在**实例集指标**页面上，选择要删除的实例集指标。
1. 在显示实例集指标详细信息的下一页上，选择**删除**。
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 资源名称（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 命令不会生成任何输出。您可以使用 C describe-fleet-metric LI 命令查看结果。
```
{
"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"
}
```
### 删除机群指标
使用 C delete-fleet-metric LI 命令删除队列指标。
```
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)。