管理机群指标 - Amazon IoT Core
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

管理机群指标

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

管理机群指标 (控制台)

在创建机群指标之前,请确保您已使用关联的数据源和配置启用了机群索引。

启用机群索引

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

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

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

  2. 在 Amazon IoT 菜单上,选择 Settings (设置)。

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

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

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

    • 配置

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

      要启用事物组索引,请打开事物组索引

    • 聚合的自定义字段 - 可选

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

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

      要更新和保存设置,请选择 Update(更新)。

创建机群指标

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

  2. 在 Amazon IoT 菜单中,选择Manage(管理),然后选择 Fleet metrics(机群指标)。

  3. 机群指标页面上,选择 Create fleet metric(创建机群指标)然后完成创建步骤。

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

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

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

    • 选择 Next (下一步)

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

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

    • 说明-可选在段中,输入要创建机群指标的描述。此字段为可选项。

    • 小时分钟字段中,输入您希望机群指标向 CloudWatch 发送数据的时间(频率)。

    • 选择 Next (下一步)

  6. 步骤 3:审核并创建

    • 查看步骤 1 和步骤 2 的设置。要编辑设置,请选择 Edit(编辑)。

    • 选择创建机群指标

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

更新机群指标

  1. 机群指标页面上,选择要更新的机群指标。

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

  3. 完成更新机群指标后,选择 Update fleet metric(更新机群指标)。

删除机群指标

  1. Fleet metric(机群指标)页面上,选择要删除的机群。

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

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

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

管理机群指标 (CLI)

以下部分介绍如何使用 Amazon CLI 来管理您的机群指标。在创建机群指标之前,请确保您已使用关联的数据源和配置启用了机群索引。要为您的事物或事物组启用机群索引,请按照管理事物索引管理事物组索引中的说明操作。

创建机群指标

您可以使用创建机群指标 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" }

列出机群指标

您可以使用列表机群指标 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" } ] }

描述机群指标

您可以使用描述船队指标 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" }

更新机群指标

您可以使用更新机群指标 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" }

删除机群指标

您可以使用删除机群指标 CLI 命令删除机群指标。

aws iot delete-fleet-metric --metric-name "YourFleetMetricName"

如果删除成功或者您指定的机群指标不存在,此命令将不产生任何输出。

有关更多信息,请参阅机群指标故障排除