Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon IoT Greengrass Version 12023 年 6 月 30 日进入延长寿命阶段。有关更多信息，请参阅Amazon IoT Greengrass V1维护政策。在此日期之后，将Amazon IoT Greengrass V1不会发布提供功能、增强功能、错误修复或安全补丁的更新。运行的设备Amazon IoT Greengrass V1不会中断，将继续运行并连接到云端。我们强烈建议您迁移到 Amazon IoT Greengrass Version 2，这增加了重要的新功能并支持其他平台。

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

CloudWatch 指标连接器

这些区域有： CloudWatch 指标连接器将 Greengrass 设备中的自定义指标发布到亚马逊 CloudWatch. 该连接器为发布提供了一个集中的基础架构 CloudWatch 指标，您可以使用它来监控和分析 Greengrass 核心环境，以及处理本地事件。有关更多信息，请参阅 。使用 Amazon CloudWatch 指标中的亚马逊 CloudWatch 用户指南.

此连接器以 MQTT 消息形式接收指标数据。连接器对同一命名空间中的指标进行批处理，并将这些指标发布到 CloudWatch 定期。

此连接器具有以下版本。

有关版本更改的信息，请参阅更改日志。

要求

此连接器具有以下要求：

Version 3 - 5

• Amazon IoT Greengrass Core 软件 v1.9.3 版或更高版本。

• Python3.7 或 3.8 版安装在核心设备上并添加到 PATH 环境变量中。

  注意

  要使用 Python 3.8，请运行以下命令以创建从默认 Python 3.7 安装文件夹到已安装的 Python 3.8 二进制文件的符号链接。

  sudo ln -s path-to-python-3.8/python3.8 /usr/bin/python3.7

  这会将设备配置为满足 Amazon IoT Greengrass 的 Python 要求。

• 这些区域有：Greengrass 组角色配置为允许cloudwatch:PutMetricData操作，如以下示例所示Amazon Identity and Access Management(IAM) 策略。

  {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Sid": "Stmt1528133056761",
              "Action": [
                  "cloudwatch:PutMetricData"
              ],
              "Effect": "Allow",
              "Resource": "*"
          }
      ]
  }

  对于组角色要求，您必须将角色配置为授予所需权限，并确保角色已添加到组中。有关更多信息，请参阅 管理 Greengrass 组角色（控制台） 或 管理 Greengrass 组角色 (CLI)。

  有关 的更多信息 CloudWatch 权限，请参阅亚马逊 CloudWatch 权限参考中的IAM 用户指南.

Versions 1 - 2

• Amazon IoT Greengrass核心软件版本 v1.7 版或更高版本。

• Python安装在核心设备上并添加到 PATH 环境变量中的 2.7 版。

• 这些区域有：Greengrass 组角色配置为允许cloudwatch:PutMetricData操作，如以下示例所示Amazon Identity and Access Management(IAM) 策略。

  {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Sid": "Stmt1528133056761",
              "Action": [
                  "cloudwatch:PutMetricData"
              ],
              "Effect": "Allow",
              "Resource": "*"
          }
      ]
  }

  对于组角色要求，您必须将角色配置为授予所需权限，并确保角色已添加到组中。有关更多信息，请参阅 管理 Greengrass 组角色（控制台） 或 管理 Greengrass 组角色 (CLI)。

  有关 的更多信息 CloudWatch 权限，请参阅亚马逊 CloudWatch 权限参考中的IAM 用户指南.

连接器参数

该连接器提供以下参数：

Versions 4 - 5

PublishInterval

发布给定命名空间的批处理指标之前等待的最长秒数。最大值为 900。要将连接器配置为一收到指标便发布（而不进行批处理），请指定 0。

连接器发布到 CloudWatch 在同一命名空间中或在经过指定间隔收到 20 个指标之后收到。

注意

连接器不保证发布事件的顺序。

显示名称Amazon IoT控制台：发布间隔

必需：true

类型：string

有效值：0 - 900

有效模式：[0-9]|[1-9]\d|[1-9]\d\d|900

PublishRegion

这些区域有：Amazon Web Services 区域来发布 CloudWatch 指标。该值会覆盖默认 Greengrass 指标区域。该值仅在发布跨区域指标时是必需的。

显示名称Amazon IoT控制台：发布区域

必需：false

类型：string

有效模式：^$|([a-z]{2}-[a-z]+-\d{1})

MemorySize

要分配给连接器的内存 (KB)。

显示名称Amazon IoT控制台：内存大小

必需：true

类型：string

有效模式：^[0-9]+$

MaxMetricsToRetain

替换为新指标之前所有命名空间内可在内存中保存的指标的最大数量。最小值为 2000。

此限制适用于没有 Internet 连接并且连接器稍后开始缓冲要发布的指标的情况。当缓冲区已满时，最旧的指标将被新的指标所替换。给定命名空间中的指标仅被同一命名空间中的指标所替换。

注意

如果连接器的宿主进程中断，则不会保存指标。例如，在组部署或设备重新启动期间，可能会发生此中断。

显示名称Amazon IoT控制台：可保留的最大指标数

必需：true

类型：string

有效模式：^([2-9]\d{3}|[1-9]\d{4,})$

IsolationMode

此连接器的容器化模式。默认值为 GreengrassContainer，这意味着连接器在 Amazon IoT Greengrass 容器内的隔离运行时环境中运行。

注意

组的默认容器化设置不适用于连接器。

显示名称Amazon IoT控制台：容器隔离模式

必需：false

类型：string

有效值：GreengrassContainer 或 NoContainer

有效模式：^NoContainer$|^GreengrassContainer$

Versions 1 - 3

PublishInterval

发布给定命名空间的批处理指标之前等待的最长秒数。最大值为 900。要将连接器配置为一收到指标便发布（而不进行批处理），请指定 0。

连接器发布到 CloudWatch 在同一命名空间中或在经过指定间隔收到 20 个指标之后收到。

注意

连接器不保证发布事件的顺序。

显示名称Amazon IoT控制台：发布间隔

必需：true

类型：string

有效值：0 - 900

有效模式：[0-9]|[1-9]\d|[1-9]\d\d|900

PublishRegion

这些区域有：Amazon Web Services 区域来发布 CloudWatch 指标。该值会覆盖默认 Greengrass 指标区域。该值仅在发布跨区域指标时是必需的。

显示名称Amazon IoT控制台：发布区域

必需：false

类型：string

有效模式：^$|([a-z]{2}-[a-z]+-\d{1})

MemorySize

要分配给连接器的内存 (KB)。

显示名称Amazon IoT控制台：内存大小

必需：true

类型：string

有效模式：^[0-9]+$

MaxMetricsToRetain

替换为新指标之前所有命名空间内可在内存中保存的指标的最大数量。最小值为 2000。

此限制适用于没有 Internet 连接并且连接器稍后开始缓冲要发布的指标的情况。当缓冲区已满时，最旧的指标将被新的指标所替换。给定命名空间中的指标仅被同一命名空间中的指标所替换。

注意

如果连接器的宿主进程中断，则不会保存指标。例如，在组部署或设备重新启动期间，可能会发生此中断。

显示名称Amazon IoT控制台：最大可保留的指标的数量

必需：true

类型：string

有效模式：^([2-9]\d{3}|[1-9]\d{4,})$

创建连接器示例 (Amazon CLI）

以下 CLI 命令将创建一个ConnectorDefinition其初始版本包含 CloudWatch 指标连接器。

aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{
    "Connectors": [
        {
            "Id": "MyCloudWatchMetricsConnector",
            "ConnectorArn": "arn:aws:greengrass:region::/connectors/CloudWatchMetrics/versions/4",
            "Parameters": {
                "PublishInterval" : "600",
                "PublishRegion" : "us-west-2",
                "MemorySize" : "16",
                "MaxMetricsToRetain" : "2500",
                "IsolationMode" : "GreengrassContainer"
            }
        }
    ]
}'

在Amazon IoT Greengrassconsole，则可以从该组的连接器页. 有关更多信息，请参阅 Greengrass 连接器入门（控制台）。

输入数据

此连接器接受有关 MQTT 主题的指标，并将这些指标发布到 CloudWatch. 输入消息必须采用 JSON 格式。

输出数据

此连接器将状态信息发布为 MQTT 主题的输出数据。

用法示例

使用以下概括步骤设置可用于尝试连接器的示例 Python 3.7 Lambda 数。

示例

以下示例 Lambda 函数将输入消息发送到连接器。

import greengrasssdk
import time
import json

iot_client = greengrasssdk.client('iot-data')
send_topic = 'cloudwatch/metric/put'

def create_request_with_all_fields():
    return  {
        "request": {
            "namespace": "Greengrass_CW_Connector",
            "metricData": {
                "metricName": "Count1",
                "dimensions": [
                    {
                        "name": "test",
                        "value": "test"
                    }
                ],
                "value": 1,
                "unit": "Seconds",
                "timestamp": time.time()
            }
        }
    }

def publish_basic_message():
    messageToPublish = create_request_with_all_fields()
    print("Message To Publish: ", messageToPublish)
    iot_client.publish(topic=send_topic,
        payload=json.dumps(messageToPublish))

publish_basic_message()

def lambda_handler(event, context):
    return

许可证

这些区域有： CloudWatch 指标连接器包含以下第三方软件/许可：

此连接器在Greengrass 核心软件许可协议.

更改日志

下表介绍了连接器各个版本的更改。

Greengrass 组每次只能包含连接器的一个版本。有关升级连接器版本的信息，请参阅升级连接器版本。

另请参阅