入门教程

运行以下命令以启用机群索引并指定要搜索的数据源。

aws iot update-indexing-configuration \
--thing-indexing-configuration "thingIndexingMode=REGISTRY_AND_SHADOW,customFields=[{name=attributes.temperature,type=Number},{name=attributes.rackId,type=String},{name=attributes.stateNormal,type=Boolean}],thingConnectivityIndexingMode=STATUS" \

上述的 CLI 命令示例启用了实例集索引，以支持使用 AWS_Things 索引搜索注册表数据、影子数据和事物连接状态。

可能需要几分钟才能完成此配置更改。验证在创建实例集指标之前已启用实例集索引。

要检查您的机群索引是否已启用，请运行以下 CLI 命令：

aws --region us-east-1 iot describe-index --index-name "AWS_Things"

有关更多信息，请参阅启用事物索引。

运行以下 bash 脚本创建十个事物并对其进行描述。

# Bash script. Type `bash` before running in other shells.

Temperatures=(70 71 72 73 74 75 47 97 98 99)
Racks=(Rack1 Rack1 Rack2 Rack2 Rack3 Rack4 Rack5 Rack6 Rack6 Rack6)
IsNormal=(true true true true true true false false false false)

for ((i=0; i < 10; i++))
do
  thing=$(aws iot create-thing --thing-name "TempSensor$i" --attribute-payload attributes="{temperature=${Temperatures[@]:$i:1},rackId=${Racks[@]:$i:1},stateNormal=${IsNormal[@]:$i:1}}")
  aws iot describe-thing --thing-name "TempSensor$i"
done

这个脚本创建了十个事物来表示十个传感器。每个事物都有 temperature、rackId 和 stateNormal 属性如下表所述：

此脚本的输出包含十个 JSON 文件。其中一个 JSON 文件如下所示：

{
    "version": 1, 
    "thingName": "TempSensor0", 
    "defaultClientId": "TempSensor0", 
    "attributes": {
        "rackId": "Rack1", 
        "stateNormal": "true", 
        "temperature": "70"
    }, 
    "thingArn": "arn:aws:iot:region:account:thing/TempSensor0", 
    "thingId": "example-thing-id"
}

有关更多信息，请参阅创建事物。

运行以下命令创建名为high_temp_FM的机群指标：您可以创建队列指标来监控温度超过 80 华氏度的传感器的数量。 CloudWatch

aws iot create-fleet-metric --metric-name "high_temp_FM" --query-string "thingName:TempSensor* AND attributes.temperature >80" --period 60 --aggregation-field "attributes.temperature" --aggregation-type name=Statistics,values=count

指标名称

数据类型：字符串 --metric-name 参数指定机群指标名称。在此示例中，您正在创建名为 high_temp_FM的机群指标。

--查询-字符串

数据类型：字符串 --query-string参数指定查询字符串。在此示例中，查询字符串表示查询名称以华氏度开头TempSensor且温度高于 80 华氏度的所有内容。有关更多信息，请参阅查询语法。

--时期

数据类型：整数 --period参数指定检索聚合数据的时间（以秒为单位）。在此示例中，您指定要创建的机群指标每 60 秒检索一次聚合数据。

--字段-聚合

数据类型：字符串 --aggregation-field 参数指定要评估的属性。在此示例中，要评估温度属性。

--聚合-类型

--aggregation-type 参数指定要在机群指标中显示的统计摘要。对于监控任务，您可以为不同聚合类型自定义聚合查询属性（统计数据、基数和百分位)。在此示例中，您可以为聚合类型指定计数，并指定统计信息以返回属性与查询相匹配的设备计数，换句话说，返回名称以华氏度开头且温度高于 80 华氏度的设备的计数。TempSensor有关更多信息，请参阅查询聚合数据。

此命令的输出如下所示：

{
    "metricArn": "arn:aws:iot:region:111122223333:fleetmetric/high_temp_FM", 
    "metricName": "high_temp_FM"
}

要了解有关如何创建机群指标的更多信息，请参阅管理机群指标。

如果您无法创建机群指标，请阅读机群指标故障排查。

（可选）运行以下命令以描述名为 high_temp_FM 的机群指标：

aws iot describe-fleet-metric --metric-name "high_temp_FM"

此命令的输出如下所示：

{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625249775.834, 
    "queryString": "*", 
    "period": 60, 
    "metricArn": "arn:aws:iot:region:111122223333:fleetmetric/high_temp_FM", 
    "aggregationField": "registry.version", 
    "version": 1, 
    "aggregationType": {
        "values": [
            "count"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625249775.834, 
    "metricName": "high_temp_FM"
}

打开 CloudWatch 控制台，网址为 https://console.aws.amazon.com/cloudwatch/。

在左侧面板的 CloudWatch 菜单上，选择指标以展开子菜单，然后选择所有指标。这将打开上半部分的页面显示图表，下半部分包含四个选项卡式部分。

第一个选项卡部分所有指标列出了您可以分组查看的所有指标，请选择 IoT FleetMetrics。这包含您的所有实例集指标。

在所有指标选项卡上的聚合类型部分，选择 Aggregation type（聚合类型）查看您创建的所有机群指标。

在 聚合类型左侧选择机群指标显示图片。您将在指标名称左侧看到值计数，这是您在本教程的创建实例集指标部分中指定的聚合类型的值。

选择所有指标选项卡右侧叫做图表化指标的第二个选项卡，查看从上一步中选择的机群指标。

您能够看到一张图表，显示温度高于 80 华氏度的传感器数量，如下所示：

（可选）您可以设置指标告警。