サポート終了通知: 2026 年 10 月 7 日、 AWS はサポートを終了します AWS IoT Greengrass Version 1。2026 年 10 月 7 日以降、 AWS IoT Greengrass V1 リソースにアクセスできなくなります。詳細については、[「 からの移行 AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html)」を参照してください。 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # CloudWatch Metrics コネクタ CloudWatch Metrics [コネクタ](connectors.md)は、Greengrass デバイスのカスタムメトリクスを Amazon CloudWatch に発行します。このコネクタでは、CloudWatch メトリクスの発行に一元管理型のインフラストラクチャを使用して、Greengrass Core 環境をモニタリングおよび分析し、ローカルのイベントに対処できます。詳細については、「Amazon CloudWatch ユーザーガイド」の「[Amazon CloudWatch メトリクスを使用する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)」を参照してください。 このコネクタには MQTT メッセージとしてメトリクスデータが送信されます。また、コネクタは、同じ名前空間にあるメトリクスをバッチにまとめて、定期的に CloudWatch に発行します。 このコネクタには、次のバージョンがあります。 | バージョン | ARN | | --- | --- | | 5 | `arn:aws:greengrass:{{region}}::/connectors/CloudWatchMetrics/versions/5` | | 4 | `arn:aws:greengrass:{{region}}::/connectors/CloudWatchMetrics/versions/4` | | 3 | `arn:aws:greengrass:{{region}}::/connectors/CloudWatchMetrics/versions/3` | | 2 | `arn:aws:greengrass:{{region}}::/connectors/CloudWatchMetrics/versions/2` | | 1 | `arn:aws:greengrass:{{region}}::/connectors/CloudWatchMetrics/versions/1` | バージョンの変更については、「[Changelog](#cloudwatch-metrics-connector-changelog)」を参照してください。 ## 要件 このコネクタには以下の要件があります。 ------ #### [ Version 3 - 5 ] + AWS IoT Greengrass Core ソフトウェア v1.9.3 以降。 + [Python](https://www.python.org/) バージョン 3.7 または 3.8 が Core デバイスにインストールされ、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 グループロール](group-role.md)に AWS Identity and Access Management (IAM) ポリシーが追加されている。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "Stmt1528133056761", "Action": [ "cloudwatch:PutMetricData" ], "Effect": "Allow", "Resource": "*" } ] } ``` ------ グループロール要件では、必要なアクセス許可を付与するようにロールを設定し、ロールがグループに追加されていることを確認する必要があります。詳細については、[Greengrass グループロールの管理 (コンソール)](group-role.md#manage-group-role-console)または[Greengrass グループロールの管理 (CLI)](group-role.md#manage-group-role-cli)を参照してください。 Amazon CloudWatch のアクセス許可の詳細については「IAM ユーザーガイド」の「[Amazon CloudWatch の許可リファレンス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html)」を参照してください。 ------ #### [ Versions 1 - 2 ] + AWS IoT Greengrass Core ソフトウェア v1.7 以降。 + [Python](https://www.python.org/) バージョン 2.7 が Core デバイスにインストールされ、PATH 環境変数に追加されている。 + 以下の例に示すように、`cloudwatch:PutMetricData` アクションを許可する [Greengrass グループロール](group-role.md)に AWS Identity and Access Management (IAM) ポリシーが追加されている。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "Stmt1528133056761", "Action": [ "cloudwatch:PutMetricData" ], "Effect": "Allow", "Resource": "*" } ] } ``` ------ グループロール要件では、必要なアクセス許可を付与するようにロールを設定し、ロールがグループに追加されていることを確認する必要があります。詳細については、[Greengrass グループロールの管理 (コンソール)](group-role.md#manage-group-role-console)または[Greengrass グループロールの管理 (CLI)](group-role.md#manage-group-role-cli)を参照してください。 Amazon CloudWatch のアクセス許可の詳細については「IAM ユーザーガイド」の「[Amazon CloudWatch の許可リファレンス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html)」を参照してください。 ------ ## コネクタパラメータ このコネクタには、以下のパラメータが用意されています。 ------ #### [ 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` CloudWatch メトリクス AWS リージョン を投稿する 。この値は、デフォルトの Greengrass メトリクスリージョンを上書きします。クロスリージョンメトリクスをポストする場合にのみ必要です。 AWS IoT コンソールの表示名: **Publish region** 必須: `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` このコネクタの[コンテナ化](connectors.md#connector-containerization)モード。デフォルトは です。つまり`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` CloudWatch メトリクス AWS リージョン を投稿する 。この値は、デフォルトの Greengrass メトリクスリージョンを上書きします。クロスリージョンメトリクスをポストする場合にのみ必要です。 AWS IoT コンソールの表示名: **Publish region** 必須: `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 コマンドは、CloudWatch Metrics コネクタを含む初期バージョンで `ConnectorDefinition` を作成します。 ``` 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 コネクタの開始方法 (コンソール)](connectors-console.md)」を参照してください。 ## 入力データ このコネクタは、MQTT トピックのメトリクスを受け取り、それを CloudWatch に発行します。入力メッセージは JSON 形式である必要があります。 **サブスクリプションのトピックフィルター** `cloudwatch/metric/put` **メッセージのプロパティ** `request` このメッセージのメトリクスに関する情報。 リクエストオブジェクトには、CloudWatch に発行するメトリクスデータが含まれています。メトリクス値は、[https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html) API の仕様を満たしている必要があります。`namespace`、`metricData.metricName`、および `metricData.value` プロパティのみが必須です。 必須: `true` 型: 以下のプロパティを含む `object`。 `namespace` このリクエスト内のメトリクスデータのユーザー定義による名前空間。CloudWatch はメトリクスデータポイントのコンテナとして名前空間を使用します。 予約された文字列 `AWS/` で始まる名前空間を指定することはできません。 必須: `true` 型: `string` 有効なパターン: `[^:].*` `metricData` メトリクスのデータ。 必須: `true` 型: 以下のプロパティを含む `object`。 `metricName` メトリクスの名前。 必須: `true` 型: `string` `dimensions` メトリクスに関連付けられたディメンション。ディメンションは、メトリクスとそのデータに関する追加情報を提供します。1 つのメトリクスでは、最大 10 個のディメンションを定義できます。 このコネクタには `coreName` という名前のディメンションが必ず含まれ、そのコアの名前を値に持ちます。 必須: `false` タイプ: 以下のプロパティを含むディメンションオブジェクトの `array`。 `name` ディメンション名。 必須: `false` 型: `string` `value` ディメンション値 必須: `false` 型: `string` `timestamp` メトリクスデータが受信された時刻。`Jan 1, 1970 00:00:00 UTC` からの秒数で表されます。この値を省略すると、コネクタはメッセージを受信した時刻を使用します。 必須: `false` 型: `timestamp` このコネクタのバージョン 1 から 4 を使用する場合は、1 つのソースから複数のメトリックを送信するときに、メトリックごとに個別にタイムスタンプを取得することをお勧めします。変数を使用してタイムスタンプを保存しないでください。 `value` メトリクスの値。 CloudWatch は小さすぎる値または大きすぎる値を拒否します。値は `8.515920e-109` から `1.174271e+108` (基数 10)、または `2e-360` から `2e360` (基数 2) の範囲内であることが必要です。特殊な値 (`NaN`、`+Infinity`、`-Infinity` など) はサポートされていません。 必須: `true` 型: `double` `unit` メトリクスの単位。 必須: `false` 型: `string` 有効な値: `Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None` 制限 このコネクタを使用すると、CloudWatch [https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html) API によって課せられるすべての制限がメトリクスに適用されます。以下の制限が特に重要です。 + API ペイロードに適用される 40 KB の制限 + API リクエストごとに 20 個のメトリクス + `PutMetricData` API の 150 トランザクション/秒 (TPS) 詳細については、「Amazon CloudWatch ユーザーガイド」の「[CloudWatch の制限](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_limits.html)」を参照してください。 **入力例** ``` { "request": { "namespace": "Greengrass", "metricData": { "metricName": "latency", "dimensions": [ { "name": "hostname", "value": "test_hostname" } ], "timestamp": 1539027324, "value": 123.0, "unit": "Seconds" } } } ``` ## 出力データ このコネクタは、MQTT トピックの出力データとしてステータス情報を発行します。 **サブスクリプションのトピックフィルター** `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 3.7 Lambda 関数の例を設定するには、次のステップ (概要) を使用します。 **注記** 他の Python ランタイムを使用する場合は、Python 3.x から Python 3.7 へのシンボリックリンクを作成します。 「[コネクタの使用を開始する (コンソール)](connectors-console.md)」および「[コネクタの使用を開始する (CLI)](connectors-cli.md)」トピックには、Twilio 通知コネクタの例を設定およびデプロイする方法を示す詳細なステップが含まれています。 1. コネクタの[要件](#cloudwatch-metrics-connector-req)を満たしていることを確認します。 グループロール要件では、必要なアクセス許可を付与するようにロールを設定し、ロールがグループに追加されていることを確認する必要があります。詳細については、[Greengrass グループロールの管理 (コンソール)](group-role.md#manage-group-role-console)または[Greengrass グループロールの管理 (CLI)](group-role.md#manage-group-role-cli)を参照してください。 1. 入力データをコネクタに送信する Lambda 関数を作成して発行します。 [サンプルコード](#cloudwatch-metrics-connector-usage-example)を PY ファイルとして保存します。[AWS IoT Greengrass Core SDK for Python](lambda-functions.md#lambda-sdks-core) をダウンロードして解凍します。次に、PY ファイルとルートレベルの `greengrasssdk` フォルダを含む zip パッケージを作成します。この zip パッケージは、 AWS Lambdaにアップロードするデプロイパッケージです。 Python 3.7 Lambda 関数を作成したら、関数バージョンを公開し、エイリアスを作成します。 1. Greengrass グループを設定します。 1. エイリアスで Lambda 関数を追加します (推奨)。Lambda ライフサイクルを長期間有効に (または CLI で `"Pinned": true` に) 設定します。 1. コネクタを追加し、その[パラメータ](#cloudwatch-metrics-connector-param)を設定します。 1. コネクタが[入力データ](#cloudwatch-metrics-connector-data-input)を受信し、サポートされているトピックフィルターで[出力データ](#cloudwatch-metrics-connector-data-output)を送信できるようにするサブスクリプションを追加します。 + Lambda 関数をソースに、コネクタをターゲットに設定し、サポートされている入力トピックフィルターを使用します。 + コネクタをソースとして、 AWS IoT Core をターゲットとして設定し、サポートされている出力トピックフィルターを使用します。このサブスクリプションを使用して、 AWS IoT コンソールでステータスメッセージを表示します。 1. グループをデプロイします。 1. AWS IoT コンソールの**テスト**ページで、出力データトピックをサブスクライブして、コネクタからのステータスメッセージを表示します。この例の Lambda 関数は長期間有効であり、グループがデプロイされた直後にメッセージの送信を開始します。 テストが終了したら、Lambda ライフサイクルをオンデマンドに (または CLI で `"Pinned": false` に) 設定して、グループをデプロイできます。これにより、関数がメッセージの送信を停止します。 ### 例 次の例では、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 Metrics コネクタには、以下のサードパーティーのソフトウェアおよびライセンスが含まれています。 + [AWS SDK for Python (Boto3)](https://pypi.org/project/boto3/)/Apache License 2.0 + [botocore](https://pypi.org/project/botocore/)/Apache License 2.0 + [dateutil](https://pypi.org/project/python-dateutil/1.4/)/PSF ライセンス + [docutils](https://pypi.org/project/docutils/)/BSD ライセンス、GNU 一般パブリックライセンス (GPL)、Python Software Foundation ライセンス、パブリックドメイン + [jmespath](https://pypi.org/project/jmespath/)/MIT ライセンス + [s3transfer](https://pypi.org/project/s3transfer/)/Apache License 2.0 + [urllib3](https://pypi.org/project/urllib3/)/MIT ライセンス このコネクタは、[Greengrass Core ソフトウェアライセンス契約](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)に従ってリリースされます。 ## 変更ログ 次の表に、コネクタの各バージョンにおける変更点を示します。 | バージョン | 変更 | | --- | --- | | 5 | 入力データでの重複するタイムスタンプに対応するように修正。 | | 4 | コネクタのコンテナ化モードを設定するための `IsolationMode` パラメータが追加されました。 | | 3 | Lambda ランタイムを Python 3.7 にアップグレードしたことで、ランタイム要件が変更。 | | 2 | 過剰なログ記録を減らすための修正。 | | 1 | 初回リリース。 | Greengrass グループには、一度に 1 つのバージョンのコネクタしか含めることができません。コネクタのバージョンのアップグレードについては、「[コネクタのバージョンのアップグレード](connectors.md#upgrade-connector-versions)」を参照してください。 ## 関連情報 + [Greengrass コネクタを使用したサービスおよびプロトコルとの統合](connectors.md) + [Greengrass コネクタの開始方法 (コンソール)](connectors-console.md) + [Greengrass コネクタの開始方法 (CLI)](connectors-cli.md) + 「Amazon CloudWatch ユーザーガイド」の「[Amazon CloudWatch メトリクスの使用](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)」 + 「Amazon CloudWatch API Reference」(Amazon CloudWatch API リファレンス) の「[PutMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)」