AWS IoT Greengrass Version 1 於 2023 年 6 月 30 日進入延長壽命階段。如需詳細資訊，請參閱 AWS IoT Greengrass V1 維護政策 。在此日期之後， AWS IoT Greengrass V1 不會發佈提供功能、增強功能、錯誤修正或安全修補程式的更新。在 上執行的裝置 AWS IoT Greengrass V1 不會中斷，並會繼續運作和連線至雲端。我們強烈建議您遷移至 AWS IoT Greengrass Version 2，這會新增重要的新功能，並支援其他平台 。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

CloudWatch 公制連接器

CloudWatch 指標連接器會將自訂指標從 Greengrass 裝置發佈到 Amazon。 CloudWatch連接器提供用於發佈 CloudWatch 指標的集中式基礎結構，您可以使用這些基礎結構來監視和分析 Greengrass 核心環境，以及對本機事件採取行動。如需詳細資訊，請參閱 Amazon 使用者指南中的使 CloudWatch 用 Amazon 指 CloudWatch 標。

此連接器會接收指標資料當做 MQTT 訊息。連接器會批次處於相同命名空間中的量度，並定期將其發佈 CloudWatch 至。

此連接器具有下列版本。

如需版本變更的詳細資訊，請參閱 Changelog。

要求

此連接器有下列要求：

Version 3 - 5

• AWS IoT Greengrass 核心軟體 1.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 需求。

• 設定為允許cloudwatch:PutMetricData動作的 Greengrass 群組角色，如下列範例 AWS Identity and Access Management (IAM) 政策所示。

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

  針對群組角色要求，您必須設定角色以授與必要的許可，並確認已將角色新增至群組。如需詳細資訊，請參閱 管理 Greengrass 群組角色 (主控台) 或 管理 Greengrass 群組角色 (CLI) 。

  如需有關 CloudWatch 許可的詳細資訊，請參閱 IAM 使用者指南中的 Amazon CloudWatch 許可參考資料。

Versions 1 - 2

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

• Python 版本 2.7 安裝在核心設備上，並添加到 PATH 環境變量中。

• 設定為允許cloudwatch:PutMetricData動作的 Greengrass 群組角色，如下列範例 AWS Identity and Access Management (IAM) 政策所示。

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

  針對群組角色要求，您必須設定角色以授與必要的許可，並確認已將角色新增至群組。如需詳細資訊，請參閱 管理 Greengrass 群組角色 (主控台) 或 管理 Greengrass 群組角色 (CLI) 。

  如需有關 CloudWatch 許可的詳細資訊，請參閱 IAM 使用者指南中的 Amazon 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。

在沒有網際網路連線且連接器開始緩衝指標來稍後發佈時，就受此限制。當緩衝區已滿時，新指標會取代最舊指標。指定命名空間中的指標只會由相同命名空間中的指標取代。

注意

如果連接器的主機程序中斷，則不會儲存指標。例如，在群組部署或裝置重新啟動期間就可能發生這種中斷情況。

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。

在沒有網際網路連線且連接器開始緩衝指標來稍後發佈時，就受此限制。當緩衝區已滿時，新指標會取代最舊指標。指定命名空間中的指標只會由相同命名空間中的指標取代。

注意

如果連接器的主機程序中斷，則不會儲存指標。例如，在群組部署或裝置重新啟動期間就可能發生這種中斷情況。

AWS IoT主控台中的顯示名稱：要保留的測量結果上限

需要：true

類型：string

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

建立範例連接器 (AWS 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"
            }
        }
    ]
}'

在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 指標連接器包括下列協力廠商軟體/授權：

此連接器是根據 Greengrass 核心軟體授權合約發行的。

變更記錄

下表說明每個版本連接器的變更。

Greengrass 群組一次只能包含一個版本的連接器。若要取得有關升級連接器版本的資訊，請參閱升級連接器版本。

另請參閱