版本 Type 作業系統要求相依性 Configuration 輸入資料輸出資料授權本機日誌檔案變更記錄另請參閱

CloudWatch 指標

Amazon CloudWatch 指標元件 (aws.greengrass.Cloudwatch) 會將自訂指標從 Greengrass 核心裝置發佈至 Amazon CloudWatch。元件可讓元件發佈 CloudWatch 指標，您可以用來監控和分析 Greengrass 核心裝置的環境。如需詳細資訊，請參閱《Amazon CloudWatch 使用者指南》中的使用 Amazon CloudWatch 指標。 Amazon CloudWatch

若要使用此元件發佈 CloudWatch 指標，請將訊息發佈至此元件訂閱的主題。根據預設，此元件會訂閱cloudwatch/metric/put本機發佈/訂閱主題。您可以在部署此元件時指定其他主題，包括 AWS IoT Core MQTT 主題。

此元件會批次處理位於相同命名空間中的指標，並定期將其發佈至 CloudWatch。

注意

此元件提供與 AWS IoT Greengrass V1 中 CloudWatch 指標連接器類似的功能。如需詳細資訊，請參閱《AWS IoT Greengrass V1 開發人員指南》中的 CloudWatch 指標連接器。

版本

此元件具有下列版本：

4.0.x
3.2.x
3.1.x 版本
3.0.x
2.1.x
2.0.x

如需有關每個元件版本變更的資訊，請參閱變更日誌。

Type

如需詳細資訊，請參閱元件類型。

作業系統

要求

此元件有下列需求：

v4.x - v3.x

安裝在核心裝置上並新增至 PATH 環境變數的 Python 3.7 版。
必須安裝下列 Python 程式庫，包括任何相依性，並可供執行元件的使用者使用：
- AWS IoT Device SDK 適用於 Python 的 v2
- 適用於 Python (Boto3) 的 AWS SDK
注意
您可以將UseInstaller組態設定為 true，將這些程式庫自動安裝到提供的 Python 環境中。
Greengrass 裝置角色必須允許 cloudwatch:PutMetricData動作，如下列範例 IAM 政策所示。
JSON
JSON
{ "Version":"2012-10-17", "Statement": [ { "Action": [ "cloudwatch:PutMetricData" ], "Effect": "Allow", "Resource": "*" } ] }
如需詳細資訊，請參閱《Amazon CloudWatch 使用者指南》中的 Amazon CloudWatch 許可參考。 Amazon CloudWatch

2.x

您的核心裝置必須符合執行 Lambda 函數的要求。如果您希望核心裝置執行容器化 Lambda 函數，則裝置必須符合執行此作業的要求。如需詳細資訊，請參閱Lambda 函數需求。
安裝在核心裝置上並新增至 PATH 環境變數的 Python 3.7 版。
Greengrass 裝置角色必須允許 cloudwatch:PutMetricData動作，如下列範例 IAM 政策所示。
JSON
JSON
{ "Version":"2012-10-17", "Statement": [ { "Action": [ "cloudwatch:PutMetricData" ], "Effect": "Allow", "Resource": "*" } ] }
如需詳細資訊，請參閱《Amazon CloudWatch 使用者指南》中的 Amazon CloudWatch 許可參考。 Amazon CloudWatch
若要從此元件接收輸出資料，您必須在部署此元件時合併舊版訂閱路由器元件 (aws.greengrass.LegacySubscriptionRouter) 的下列組態更新。此組態會指定此元件發佈回應的主題。
Legacy subscription router v2.1.xLegacy subscription router v2.0.x
Legacy subscription router v2.1.x
```
{
  "subscriptions": {
    "aws-greengrass-cloudwatch": {
      "id": "aws-greengrass-cloudwatch",
      "source": "component:aws.greengrass.Cloudwatch",
      "subject": "cloudwatch/metric/put/status",
      "target": "cloud"
    }
  }
}
```
Legacy subscription router v2.0.x
```
{
  "subscriptions": {
    "aws-greengrass-cloudwatch": {
      "id": "aws-greengrass-cloudwatch",
      "source": "arn:aws:lambda:region:aws:function:aws-greengrass-cloudwatch:version",
      "subject": "cloudwatch/metric/put/status",
      "target": "cloud"
    }
  }
}
```
以您使用 AWS 區域的取代區域。

以此元件執行的 Lambda 函數版本取代版本。若要尋找 Lambda 函數版本，您必須檢視要部署之此元件版本的配方。在AWS IoT Greengrass 主控台中開啟此元件的詳細資訊頁面，並尋找 Lambda 函數鍵值對。此鍵/值對包含 Lambda 函數的名稱和版本。
重要
每次部署此元件時，都必須更新舊版訂閱路由器上的 Lambda 函數版本。這可確保您為部署的元件版本使用正確的 Lambda 函數版本。
如需詳細資訊，請參閱建立部署。

端點和連接埠

除了基本操作所需的端點和連接埠之外，此元件還必須能夠對下列端點和連接埠執行傳出請求。如需詳細資訊，請參閱允許透過代理或防火牆的裝置流量。

Endpoint	站點	必要	Description
`monitoring.region.amazonaws.com`	443	是	上傳 CloudWatch 指標。

相依性

當您部署元件時， AWS IoT Greengrass 也會部署其相依性的相容版本。這表示您必須符合元件及其所有相依性的要求，才能成功部署元件。本節列出此元件發行版本的相依性，以及為每個相依性定義元件版本的語意版本限制。您也可以在 AWS IoT Greengrass 主控台中檢視每個版本元件的相依性。在元件詳細資訊頁面上，尋找相依性清單。

相依性	相容版本	相依性類型
Greengrass 核	>=2.0.0 <3.0.0	軟式
權杖交換服務	>=0.0.0	硬式

相依性	相容版本	相依性類型
Greengrass 核	>=2.0.0 <3.0.0	硬式
Lambda 啟動器	^2.0.0	硬式
Lambda 執行階段	^2.0.0	軟式
字符交換服務	^2.0.0	硬式

相依性	相容版本	相依性類型
Greengrass 核	>=2.0.0 <3.0.0	硬式
Lambda 啟動器	^2.0.0	硬式
Lambda 執行階段	^2.0.0	軟式
權杖交換服務	^2.0.0	硬式

相依性	相容版本	相依性類型
Greengrass 核	>=2.0.0 <2.8.0	硬式
Lambda 啟動器	^2.0.0	硬式
Lambda 執行階段	^2.0.0	軟式
權杖交換服務	^2.0.0	硬式

相依性	相容版本	相依性類型
Greengrass 核	>=2.0.0 <2.7.0	硬式
Lambda 啟動器	^2.0.0	硬式
Lambda 執行階段	^2.0.0	軟式
字符交換服務	^2.0.0	硬式

相依性	相容版本	相依性類型
Greengrass 核	>=2.0.0 <2.6.0	硬式
Lambda 啟動器	^2.0.0	硬式
Lambda 執行階段	^2.0.0	軟式
權杖交換服務	^2.0.0	硬式

相依性	相容版本	相依性類型
Greengrass 核	>=2.0.0 <2.5.0	硬式
Lambda 啟動器	^2.0.0	硬式
Lambda 執行階段	^2.0.0	軟式
權杖交換服務	^2.0.0	硬式

相依性	相容版本	相依性類型
Greengrass 核	>=2.0.0 <2.4.0	硬式
Lambda 啟動器	^2.0.0	硬式
Lambda 執行階段	^2.0.0	軟式
權杖交換服務	^2.0.0	硬式

相依性	相容版本	相依性類型
Greengrass 核	>=2.0.0 <2.3.0	硬式
Lambda 啟動器	^2.0.0	硬式
Lambda 執行階段	^2.0.0	軟式
字符交換服務	^2.0.0	硬式

相依性	相容版本	相依性類型
Greengrass 核	>=2.0.0 <2.2.0	硬式
Lambda 啟動器	^2.0.0	硬式
Lambda 執行階段	^2.0.0	軟式
權杖交換服務	^2.0.0	硬式

相依性	相容版本	相依性類型
Greengrass 核	>=2.0.3 <2.1.0	硬式
Lambda 啟動器	>=1.0.0	硬式
Lambda 執行階段	>=1.0.0	軟式
字符交換服務	>=1.0.0	硬式

如需元件相依性的詳細資訊，請參閱元件配方參考。

Configuration

此元件提供下列組態參數，您可以在部署元件時自訂這些參數。

v4.x

PublishInterval

（選用）在元件發佈指定命名空間的批次指標之前等待的秒數上限。若要設定元件在接收指標時發佈指標，這表示無需批次處理，請指定 0。

元件在相同命名空間中收到 20 個指標後，或在您指定的間隔後，會發佈至 CloudWatch。

注意

元件不會指定事件發佈的順序。

此值最多可達 900 秒。

預設：10 秒

MaxMetricsToRetain

（選用）元件將指標取代為較新的指標之前，所有命名空間中要儲存在記憶體中的指標數量上限。

當核心裝置沒有網際網路連線時，就會套用此限制，因此元件會緩衝稍後發佈的指標。當緩衝區已滿時，元件會將最舊的指標取代為較新的指標。指定命名空間中的指標只會取代相同命名空間中的指標。

注意

如果元件的主機程序中斷，則元件不會儲存指標。例如，這可能會在部署期間或核心裝置重新啟動時發生。

此值必須至少為 2，000 個指標。

預設：5，000 個指標

InputTopic

（選用）元件訂閱接收訊息的主題。如果您true為指定 PubSubToIoTCore，則可以在本主題中使用 MQTT 萬用字元 (+ 和 #)。

預設：cloudwatch/metric/put

OutputTopic

（選用）元件發佈狀態回應的主題。

預設：cloudwatch/metric/put/status

PubSubToIoTCore

（選用）字串值，定義是否發佈和訂閱 AWS IoT Core MQTT 主題。支援的值為 true 和 false。

預設：false

LogLevel

（選用）元件的記錄層級。從下列日誌層級中進行選擇，此處依層級順序列出：

DEBUG
INFO
WARNING
ERROR
CRITICAL

預設：INFO

UseInstaller

（選用）布林值，定義是否使用安裝程式指令碼，將此元件的 Python 相依性安裝到提供的 Python 環境中。

將此值設定為 true，以自動安裝此元件的 Python 相依性。設為時false，您必須安裝下列程式庫，包括任何相依性，並將其提供給執行元件的使用者的 Python 環境。

預設：false

PublishRegion

（選用）要發佈 CloudWatch 指標 AWS 區域的。此值會覆寫核心裝置的預設區域。只有跨區域指標需要此參數。

accessControl

（選用）包含授權政策的物件，允許元件發佈和訂閱指定的主題。如果您為 InputTopic和指定自訂值OutputTopic，則必須更新此物件中的資源值。

預設：


{
  "aws.greengrass.ipc.pubsub": {
    "aws.greengrass.Cloudwatch:pubsub:1": {
      "policyDescription": "Allows access to subscribe to input topics.",
      "operations": [
        "aws.greengrass#SubscribeToTopic"
      ],
      "resources": [
        "cloudwatch/metric/put"
      ]
    },
    "aws.greengrass.Cloudwatch:pubsub:2": {
      "policyDescription": "Allows access to publish to output topics.",
      "operations": [
        "aws.greengrass#PublishToTopic"
      ],
      "resources": [
        "cloudwatch/metric/put/status"
      ]
    }
  },
  "aws.greengrass.ipc.mqttproxy": {
    "aws.greengrass.Cloudwatch:mqttproxy:1": {
      "policyDescription": "Allows access to subscribe to input topics.",
      "operations": [
        "aws.greengrass#SubscribeToIoTCore"
      ],
      "resources": [
        "cloudwatch/metric/put"
      ]
    },
    "aws.greengrass.Cloudwatch:mqttproxy:2": {
      "policyDescription": "Allows access to publish to output topics.",
      "operations": [
        "aws.greengrass#PublishToIoTCore"
      ],
      "resources": [
        "cloudwatch/metric/put/status"
      ]
    }
  }
}

範例範例：組態合併更新


{
  "PublishInterval": 0,
  "PubSubToIoTCore": true
}

v3.x

PublishInterval

（選用）在元件發佈指定命名空間的批次指標之前等待的秒數上限。若要設定元件在接收指標時發佈指標，這表示無需批次處理，請指定 0。

元件在相同命名空間中收到 20 個指標後，或在您指定的間隔後，會發佈至 CloudWatch。

注意

元件不會指定事件發佈的順序。

此值最多可達 900 秒。

預設：10 秒

MaxMetricsToRetain

（選用）元件將指標取代為較新的指標之前，所有命名空間中要儲存在記憶體中的指標數量上限。

注意

如果元件的主機程序中斷，則元件不會儲存指標。例如，這可能會在部署期間或核心裝置重新啟動時發生。

此值必須至少為 2，000 個指標。

預設：5，000 個指標

InputTopic

（選用）元件訂閱接收訊息的主題。如果您true為指定 PubSubToIoTCore，則可以在本主題中使用 MQTT 萬用字元 (+ 和 #)。

預設：cloudwatch/metric/put

OutputTopic

（選用）元件發佈狀態回應的主題。

預設：cloudwatch/metric/put/status

PubSubToIoTCore

（選用）字串值，定義是否發佈和訂閱 AWS IoT Core MQTT 主題。支援的值為 true 和 false。

預設：false

LogLevel

（選用）元件的記錄層級。從下列日誌層級中進行選擇，此處依層級順序列出：

DEBUG
INFO
WARNING
ERROR
CRITICAL

預設：INFO

UseInstaller

（選用）布林值，定義是否使用安裝程式指令碼，將此元件的 Python 相依性安裝到提供的 Python 環境中。

將此值設定為 false，以使用自訂指令碼或手動安裝相依性。設定為時false，您必須安裝下列程式庫，包括任何相依性，並將其提供給執行元件的使用者的 Python 環境。

預設：true

PublishRegion

（選用）要發佈 CloudWatch 指標 AWS 區域的。此值會覆寫核心裝置的預設區域。只有跨區域指標需要此參數。

accessControl

（選用）包含授權政策的物件，允許元件發佈和訂閱指定的主題。如果您為 InputTopic和指定自訂值OutputTopic，則必須更新此物件中的資源值。

預設：


{
  "aws.greengrass.ipc.pubsub": {
    "aws.greengrass.Cloudwatch:pubsub:1": {
      "policyDescription": "Allows access to subscribe to input topics.",
      "operations": [
        "aws.greengrass#SubscribeToTopic"
      ],
      "resources": [
        "cloudwatch/metric/put"
      ]
    },
    "aws.greengrass.Cloudwatch:pubsub:2": {
      "policyDescription": "Allows access to publish to output topics.",
      "operations": [
        "aws.greengrass#PublishToTopic"
      ],
      "resources": [
        "cloudwatch/metric/put/status"
      ]
    }
  },
  "aws.greengrass.ipc.mqttproxy": {
    "aws.greengrass.Cloudwatch:mqttproxy:1": {
      "policyDescription": "Allows access to subscribe to input topics.",
      "operations": [
        "aws.greengrass#SubscribeToIoTCore"
      ],
      "resources": [
        "cloudwatch/metric/put"
      ]
    },
    "aws.greengrass.Cloudwatch:mqttproxy:2": {
      "policyDescription": "Allows access to publish to output topics.",
      "operations": [
        "aws.greengrass#PublishToIoTCore"
      ],
      "resources": [
        "cloudwatch/metric/put/status"
      ]
    }
  }
}

範例範例：組態合併更新


{
  "PublishInterval": 0,
  "PubSubToIoTCore": true
}

v2.x

注意

此元件的預設組態包含 Lambda 函數參數。建議您只編輯下列參數，以在裝置上設定此元件。

lambdaParams

包含此元件 Lambda 函數參數的物件。此物件包含下列資訊：

EnvironmentVariables

包含 Lambda 函數參數的物件。此物件包含下列資訊：

PUBLISH_INTERVAL

（選用）在元件發佈指定命名空間的批次指標之前等待的秒數上限。若要設定元件在接收指標時發佈指標，這表示無需批次處理，請指定 0。

在相同命名空間中收到 20 個指標或您指定的間隔之後，元件會發佈到 CloudWatch。

注意

元件不保證事件發佈的順序。

此值最多可達 900 秒。

預設：10 秒

MAX_METRICS_TO_RETAIN

（選用）在元件將指標取代為較新的指標之前，所有命名空間中要儲存在記憶體中的指標數量上限。

注意

如果元件的主機程序中斷，則元件不會儲存指標。例如，這可能會在部署期間或核心裝置重新啟動時發生。

此值必須至少為 2，000 個指標。

預設：5，000 個指標

PUBLISH_REGION

（選用）要發佈 CloudWatch 指標 AWS 區域的。此值會覆寫核心裝置的預設區域。只有跨區域指標需要此參數。

containerMode

（選用）此元件的容器化模式。您可以從以下選項中選擇：

NoContainer – 元件不會在隔離的執行時間環境中執行。
GreengrassContainer – 元件會在 AWS IoT Greengrass 容器內的隔離執行時間環境中執行。

預設：GreengrassContainer

containerParams

（選用）包含此元件容器參數的物件。如果您GreengrassContainer為指定，元件會使用這些參數containerMode。

此物件包含下列資訊：

memorySize

（選用）要配置給元件的記憶體量（以 KB 為單位）。

預設為 64 MB (65，535 KB)。

pubsubTopics

（選用）物件，其中包含元件訂閱接收訊息的主題。您可以指定每個主題，以及元件是從訂閱 MQTT 主題 AWS IoT Core 或本機發佈/訂閱主題。

此物件包含下列資訊：

0 – 這是做為字串的陣列索引。

包含下列資訊的物件：

type

（選用）此元件用來訂閱訊息的發佈/訂閱訊息類型。您可以從以下選項中選擇：

PUB_SUB - 訂閱本機發佈/訂閱訊息。如果您選擇此選項，主題不能包含 MQTT 萬用字元。如需在指定此選項時如何從自訂元件傳送訊息的詳細資訊，請參閱發佈/訂閱本機訊息。
IOT_CORE – 訂閱 AWS IoT Core MQTT 訊息。如果您選擇此選項，主題可以包含 MQTT 萬用字元。如需在指定此選項時如何從自訂元件傳送訊息的詳細資訊，請參閱發佈/訂閱 AWS IoT Core MQTT 訊息。

預設：PUB_SUB

topic

（選用）元件訂閱接收訊息的主題。如果您IotCore為指定 type，則可以在本主題中使用 MQTT 萬用字元 (+ 和 #)。

範例範例：組態合併更新（容器模式）


{
  "containerMode": "GreengrassContainer"
}

範例範例：組態合併更新（無容器模式）


{
  "containerMode": "NoContainer"
}

輸入資料

此元件接受下列主題的指標，並將指標發佈至 CloudWatch。根據預設，此元件會訂閱本機發佈/訂閱訊息。如需如何從自訂元件發佈訊息至此元件的詳細資訊，請參閱發佈/訂閱本機訊息。

從元件版本 v3.0.0 開始，您可以選擇將此元件設定為訂閱 MQTT 主題，方法是將PubSubToIoTCore組態參數設定為 true。如需將訊息發佈至自訂元件中 MQTT 主題的詳細資訊，請參閱發佈/訂閱 AWS IoT Core MQTT 訊息。

預設主題： cloudwatch/metric/put

訊息接受下列屬性。輸入訊息必須是 JSON 格式。

request

此訊息中的指標。

請求物件包含要發佈至 CloudWatch 的指標資料。指標值必須符合 PutMetricData操作的規格。

類型：object包含下列資訊：

namespace

此請求中指標資料的使用者定義命名空間。CloudWatch 使用命名空間做為指標資料點的容器。

注意

您無法指定以預留字串開頭的命名空間AWS/。

類型：string

有效模式： [^:].*

metricData

指標的資料。

類型：object包含下列資訊：

metricName

指標的名稱

類型：string

value

指標的值。

注意

CloudWatch 會拒絕太小或太大的值。值必須介於 8.515920e-109和 1.174271e+108(Base 10) 或 2e-360和 2e360(Base 2) 之間。CloudWatch 不支援特殊值，例如 NaN、 +Infinity和 -Infinity。

類型：double

dimensions

（選用）指標的維度。維度提供指標及其資料的其他資訊。一個指標可以定義最多 10 個維度。

此元件會自動包含名為的維度coreName，其中值是核心裝置的名稱。

類型： array 的物件，每個物件都包含下列資訊：

name

（選用）維度名稱。

類型：string

value

（選用）維度值。

類型：string

timestamp

（選用）收到指標資料的時間，以秒為單位，以 Unix epoch 時間表示。

預設為元件接收訊息的時間。

類型：double

注意

如果您在此元件的 2.0.3 和 2.0.7 版之間使用，我們建議您從單一來源傳送多個指標時，分別擷取每個指標的時間戳記。請勿使用變數來存放時間戳記。

unit

（選用）指標的單位。

類型：string

有效值：Seconds、Microseconds、Milliseconds、Bytes、Kilobytes、、MegabytesGigabytesTerabytesBits、Kilobits、Megabits、、Gigabits、TerabitsPercent、CountBytes/Second、Kilobytes/Second、、、、Megabytes/Second、Gigabytes/SecondTerabytes/SecondBits/SecondKilobits/Second、、 Megabits/Second Gigabits/Second Terabits/Second Count/Second None

預設為 None。

注意

套用至 CloudWatch PutMetricData API 的所有配額都會套用至您使用此元件發佈的指標。下列配額特別重要：

API 承載的 40 KB 限制
每一 API 請求 20 個指標
PutMetricData API 每秒 150 筆交易 (TPS)

如需詳細資訊，請參閱《CloudWatch 使用者指南》中的 CloudWatch 服務配額。 CloudWatch

範例範例輸入


{
  "request": {
    "namespace": "Greengrass",
    "metricData": {
      "metricName": "latency",
      "dimensions": [
        {
          "name": "hostname",
          "value": "test_hostname"
        }
      ],
      "timestamp": 1539027324,
      "value": 123.0,
      "unit": "Seconds"
    }
  }
}

輸出資料

此元件預設會將回應發佈為下列本機發佈/訂閱主題的輸出資料。如需如何在自訂元件中訂閱此主題訊息的詳細資訊，請參閱發佈/訂閱本機訊息。

您可以選擇將此元件設定為發佈至 MQTT 主題，方法是將PubSubToIoTCore組態參數設定為 true。如需在自訂元件中訂閱 MQTT 主題訊息的詳細資訊，請參閱發佈/訂閱 AWS IoT Core MQTT 訊息。

注意

根據預設，元件版本 2.0.x 會將回應發佈為 MQTT 主題上的輸出資料。您必須在舊版訂閱路由器元件的組態subject中，將主題指定為。

預設主題： cloudwatch/metric/put/status

範例範例輸出：成功

回應包含指標資料的命名空間，以及 CloudWatch 回應中的 RequestId 欄位。


{
  "response": {
    "cloudwatch_rid": "70573243-d723-11e8-b095-75ff2EXAMPLE",
    "namespace": "Greengrass",
    "status": "success"
  }
}

範例範例輸出：失敗


{
  "response" : {
    "namespace": "Greengrass",
    "error": "InvalidInputException",
    "error_message": "cw metric is invalid",
    "status": "fail"
  }
}

注意

如果元件偵測到可以重試的錯誤，例如連線錯誤，它會在下一個批次中重試發佈。

授權

此元件包含下列第三方軟體/授權：

適用於 Python (Boto3) 的 AWS SDK/Apache License 2.0
botocore/Apache License 2.0
dateutil/PSF License
docutils/BSD 授權、GNU 一般公有授權 (GPL)、Python 軟體基金會授權、公有網域
jmespath/MIT License
s3transfer/Apache License 2.0
urllib3/MIT License

此元件根據 Greengrass 核心軟體授權合約發行。

本機日誌檔案

此元件使用以下日誌檔案。

檢視此元件的日誌

在核心裝置上執行下列命令，以即時檢視此元件的日誌檔案。將 /greengrass/v2或 C：\greengrass\v2 取代為 AWS IoT Greengrass 根資料夾的路徑。
Linux
```
sudo tail -f /greengrass/v2/logs/aws.greengrass.Cloudwatch.log
```
Windows (PowerShell)
```
Get-Content C:\greengrass\v2\logs\aws.greengrass.Cloudwatch.log -Tail 10 -Wait
```

變更記錄

下表說明每個版本元件的變更。

v4.x - v3.x

版本	變更
4.0.0	新功能 `UseInstaller` 組態現在預設為 `false`。
3.2.0	新功能新增 Greengrass nucleus lite 的配方支援
3.1.0	錯誤修正和改善新增對 HTTPS 網路代理組態的支援。如需詳細資訊，請參閱連線至連接埠 443 或透過網路代理及讓核心裝置信任 HTTPS 代理。
3.0.0	此版本的 CloudWatch 指標元件預期組態參數與 2.x 版不同。如果您使用 2.x 版的非預設組態，而且想要從 v2.x 升級到 v3.x，則必須更新元件的組態。如需詳細資訊，請參閱 CloudWatch 指標元件組態。新功能新增對執行 Windows 之核心裝置的支援。將元件類型從 Lambda 元件變更為一般元件。此元件現在不再依賴舊版訂閱路由器元件來建立訂閱。新增`InputTopic`組態參數，以指定元件訂閱接收訊息的主題。新增`OutputTopic`組態參數，以指定元件發佈狀態回應的主題。新增`PubSubToIoTCore`組態參數，以指定是否發佈和訂閱 AWS IoT Core MQTT 主題。新增新的`UseInstaller`組態參數，可讓您選擇性地停用安裝元件相依性的安裝指令碼。錯誤修正和改善新增對輸入資料中重複時間戳記的支援。

v2.x

版本	變更
2.1.8	針對 Greengrass nucleus 2.13.0 版更新版本。
2.1.3	針對 Greengrass nucleus 2.11.0 版更新版本。
2.1.2	針對 Greengrass nucleus 2.7.0 版更新版本。
2.1.1	針對 Greengrass nucleus 2.6.0 版更新版本。
2.1.0	新功能新增對 HTTPS 網路代理組態的支援。如需詳細資訊，請參閱連線至連接埠 443 或透過網路代理及讓核心裝置信任 HTTPS 代理。
2.0.8	錯誤修正和改善新增對輸入資料中重複時間戳記的支援。針對 Greengrass nucleus 2.5.0 版更新版本。
2.0.7	針對 Greengrass nucleus 2.4.0 版更新版本。
2.0.6	針對 Greengrass nucleus 2.3.0 版更新版本。
2.0.5	針對 Greengrass nucleus 2.2.0 版更新版本。
2.0.4	針對 Greengrass nucleus 2.1.0 版更新版本。
2.0.3	初始版本。

另請參閱

《Amazon CloudWatch 使用者指南》中的使用 Amazon CloudWatch 指標
Amazon CloudWatch API 參考中的 PutMetricData

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

用戶端裝置身分驗證

AWS IoT Device Defender

CloudWatch 指標

注意

主題

版本

Type

作業系統

要求

注意

重要

端點和連接埠

相依性

Configuration

注意

注意

範例範例：組態合併更新

注意

注意

範例範例：組態合併更新

注意

注意

注意

範例範例：組態合併更新 （容器模式）

範例範例：組態合併更新 （無容器模式）

輸入資料

注意

注意

注意

注意

範例範例輸入

輸出資料

注意

範例範例輸出：成功

範例範例輸出：失敗

注意

授權

本機日誌檔案

檢視此元件的日誌

變更記錄

另請參閱

範例範例：組態合併更新（容器模式）

範例範例：組態合併更新（無容器模式）