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

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

管理机群指标

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

管理机群指标 (控制台)

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

启用机群索引

如果您已经启用了机群索引，请跳过此部分。

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

  1. 通过 https://console.aws.amazon.com/iot/ 打开你的 Amazon IoT 主机。

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

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

  4. 要更新您的机群索引设置，请在机群索引部分右侧选择 Manage indexing （管理索引）。

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

    • 配置

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

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

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

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

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

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

创建机群指标

  1. 通过 https://console.aws.amazon.com/iot/ 打开你的 Amazon IoT 主机。

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

  3. 在机群指标页面上，选择 Create fleet metric（创建机群指标）然后完成创建步骤。

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

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

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

    • 选择下一步。

  5. 在步骤 2 中指定机群指标属性

    • 在机群指标名称字段中，输入要创建机群指标的名称。

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

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

    • 选择下一步。

  6. 步骤 3：审核并创建

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

    • 选择创建机群指标。

成功创建后，机群指标页面会列出机群指标。

更新机群指标

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

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

  3. 完成更新机群指标后，选择 Update fleet metric（更新机群指标）。

删除机群指标

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

  2. 在显示机群指标详细信息的下一页上，选择 Delete（删除）。

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

  4. 选择 Delete （删除)。此步骤将永久删除您的机群指标。

管理机群指标 (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 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 命令不产生任何输出。您可以使用 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 Management Console 或创建的队列指标 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 的操作、资源和条件键。