管理实例集指标 - Amazon IoT Core
管理实例集指标（控制台）管理实例集指标（CLI）授权对 IoT 资源进行标记
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

管理实例集指标

本主题介绍如何使用Amazon IoT控制台和管理Amazon CLI您的队列指标。

管理实例集指标（控制台）

以下各节介绍如何使用Amazon IoT控制台管理您的队列指标。在创建机群指标之前，请确保您已使用关联的数据源和配置启用了机群索引。

启用实例集索引

如果您已经启用了实例集索引，请跳过此部分。

如果还没有启用实例集索引，请按照以下说明操作。

  1. 在以下位置打开您的Amazon IoT主机https://console.aws.amazon.com/iot/。

  2. 在Amazon IoT菜单上，选择设置。

  3. 要查看详细设置，请在设置页面，向下滚动到实例集索引部分。

  4. 要更新您的实例集索引设置，请在实例集索引部分右侧选择管理索引。

  5. 在管理实例集索引页面上，根据您的需求更新实例集索引设置。

    • 配置

      要打开事物索引，请开启事物索引，然后选择要从中索引的数据源。

      要启用事物组索引，请打开事物组索引。

    • Custom fields for aggregation - optional（聚合的自定义字段 - 可选）

      自定义字段是字段名称和字段类型对的列表。

      要添加自定义字段对，请选择 Add new field（添加新字段）。输入自定义字段名称，如 attributes.temperature，然后从字段类型菜单选择一个字段类型。请注意，自定义以 attributes. 开头的字段名称并将保存为属性来运行事物聚合查询。

      要更新和保存设置，请选择 Update（更新）。

创建机群指标

  1. 在以下位置打开您的Amazon IoT主机https://console.aws.amazon.com/iot/。

  2. 在Amazon IoT菜单上，选择管理，然后选择队列指标。

  3. 在实例集指标页面上，选择创建实例集指标然后完成创建步骤。

  4. 在步骤 1 中配置机群指标

    • 在查询部分中，输入查询字符串以指定要执行聚合搜索的事物或事物组。查询由属性和值组成的字符串。对于属性，选择所需的属性，或，如果该属性没有出现在列表中，则在字段中输入属性。在 : 之后输入值。一个查询字符串示例可以是 thingName:TempSensor*。对于输入的每个查询字符串，请按键盘上的输入。如果输入多个查询字符串，请通过选择 and、or、and not 或 or not 指定他们之间的关系。

    • 在报告属性中，从各自的列表中选择 Index name、Aggregation type 和 Aggregation field。接下来，在选择数据中选择您想要聚合的数据，您可以在其中选择多个数据值。

    • 选择下一步。

  5. 在步骤 2 中指定实例集指标属性

    • 在实例集指标名称字段中，输入要创建实例集指标的名称。

    • 在说明 - 可选在段中，输入要创建实例集指标的描述。该字段是可选的。

    • 在小时和分钟字段中，输入您希望舰队指标向其发送数据的时间（频率）。 CloudWatch

    • 选择下一步。

  6. 步骤 3：审核并创建

    • 查看步骤 1 和步骤 2 的设置。要编辑设置，请选择 Edit（编辑）。

    • 选择创建实例集指标。

成功创建后，实例集指标页面会列出实例集指标。

更新机群指标

  1. 在实例集指标页面上，选择要更新的实例集指标。

  2. 在实例集指标详细信息选项卡上，选择编辑。这将打开创建步骤，您可以在这三个步骤中的任何一个步骤中更新实例集指标。

  3. 完成更新实例集指标后，选择更新实例集指标。

删除机群指标

  1. 在实例集指标页面上，选择要删除的实例集指标。

  2. 在显示实例集指标详细信息的下一页上，选择删除。

  3. 在对话框中，输入实例集指标的名称确认删除。

  4. 选择删除。此步骤将永久删除您的实例集指标。

管理实例集指标（CLI）

以下各节介绍如何使用Amazon 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 资源名称（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"

如果删除成功或者您指定的实例集指标不存在，此命令将不产生任何输出。

有关更多信息，请参阅实例集指标故障排除。

授权对 IoT 资源进行标记

为了更好地控制您可以创建、修改或使用的实例集指标，可以在实例集指标上附加标签。

要标记使用Amazon Web Services 管理控制台或创建的队列指标Amazon CLI，您必须在 IAM 策略中包含该iot:TagResource操作以授予用户权限。如果您的 IAM 策略不包含 iot:TagResource，则创建带有标签的实例集指标的任何操作都将返回 AccessDeniedException 错误。

有关标记资源的更多一般信息，请参阅标记 Amazon 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/*"
			]
		}
	]
}

有关更多信息，请参阅 Amazon IoT的操作、资源和条件键。