管理实例集指标 - AWS IoT Core
管理实例集指标（控制台）管理实例集指标（CLI）授权对物联网资源进行标记

管理实例集指标

本主题介绍如何使用 AWS IoT 控制台和 AWS CLI 来管理您的实例集指标。

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

以下部分介绍如何使用 AWS IoT 控制台来管理您的实例集指标。在创建实例集指标之前，请确保您已使用关联的数据源和配置启用了实例集索引。

启用实例集索引

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

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

  1. 在 https://console.aws.amazon.com/iot/ 打开您的 AWS IoT 控制台。

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

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

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

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

    • 配置

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

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

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

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

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

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

创建实例集指标

  1. 在 https://console.aws.amazon.com/iot/ 打开您的 AWS IoT 控制台。

  2. 在 AWS 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）

以下部分介绍如何使用 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 资源名称（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

更新实例集指标命令不会产生任何输出。您可以使用描述实例集指标 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"

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

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

授权对物联网资源进行标记

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

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

有关标记资源的更多一般信息，请参阅标记 AWS IoT 资源。

IAM 策略示例

请参阅以下在创建实例集指标时授予标记权限的 IAM 策略示例：

JSON
{
	"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 的操作、资源和条件键。