终止支持通知：2026 年 10 月 7 日，AWS将停止对的支持。AWS IoT Greengrass Version 1 2026 年 10 月 7 日之后，您将无法再访问这些AWS IoT Greengrass V1资源。如需了解更多信息，请访问迁移自AWS IoT Greengrass Version 1。

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

CloudWatch 指标连接器

CloudWatch 指标连接器将来自 Greengrass 设备的自定义指标发布到亚马逊。 CloudWatch该连接器提供了一个用于发布 CloudWatch 指标的集中式基础架构，您可以使用该基础架构来监控和分析 Greengrass 核心环境，并对本地事件采取行动。有关更多信息，请参阅亚马逊 CloudWatch 用户指南中的使用亚马逊 CloudWatch 指标。

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

此连接器具有以下版本。

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

要求

此连接器具有以下要求：

Version 3 - 5

• AWS IoT Greengrass 核心软件 v1.9.3 或更高版本。

• Python 版本 3.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

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

• Greengrass 组角色，配置为允许执行 cloudwatch:PutMetricData 操作，如以下示例 AWS Identity and Access Management IAM policy 中所示。

  JSON

  JSON

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

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

  有关 CloudWatch 权限的更多信息，请参阅 IA M 用户指南中的 A mazon CloudWatch 权限参考。

Versions 1 - 2

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

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

• Greengrass 组角色，配置为允许执行 cloudwatch:PutMetricData 操作，如以下示例 AWS Identity and Access Management IAM policy 中所示。

  JSON

  JSON

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

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

  有关 CloudWatch 权限的更多信息，请参阅 IA M 用户指南中的 A mazon CloudWatch 权限参考。

连接器参数

该连接器提供以下参数：

Versions 4 - 5

PublishInterval

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

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

注意

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

AWS IoT 控制台中的显示名称：发布间隔

必需：true

类型：string

有效值：0 - 900

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

PublishRegion

AWS 区域 要向其发布 CloudWatch 指标的。该值会覆盖默认 Greengrass 指标区域。该值仅在发布跨区域指标时是必需的。

AWS IoT 控制台中的显示名称：发布区域

必需：false

类型：string

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

MemorySize

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

AWS IoT 控制台中的显示名称：内存大小

必需：true

类型：string

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

MaxMetricsToRetain

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

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

注意

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

AWS IoT 控制台中的显示名称：要保留的最大指标

必需：true

类型：string

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

IsolationMode

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

注意

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

AWS IoT 控制台中的显示名称：容器隔离模式

必需：false

类型：string

有效值：GreengrassContainer 或 NoContainer

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

Versions 1 - 3

PublishInterval

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

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

注意

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

AWS IoT 控制台中的显示名称：发布间隔

必需：true

类型：string

有效值：0 - 900

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

PublishRegion

AWS 区域 要向其发布 CloudWatch 指标的。该值会覆盖默认 Greengrass 指标区域。该值仅在发布跨区域指标时是必需的。

AWS IoT 控制台中的显示名称：发布区域

必需：false

类型：string

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

MemorySize

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

AWS IoT 控制台中的显示名称：内存大小

必需：true

类型：string

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

MaxMetricsToRetain

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

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

注意

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

AWS IoT 控制台中的显示名称：要保留的最大指标

必需：true

类型：string

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

创建连接器示例 (AWS CLI)

以下 CLI 命令ConnectorDefinition使用包含 Metr CloudWatch ics 连接器的初始版本创建一个。

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"
            }
        }
    ]
}'

在 AWS IoT Greengrass 控制台中，您可以从群组的 “连接器” 页面添加连接器。有关更多信息，请参阅 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 指标连接器包括以下第三方 software/licensing：

该连接器在 Greengrass Core 软件许可协议下发布。

更改日志

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

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

另请参阅