Avis de fin de support : le 7 octobre 2026, AWS le support de. AWS IoT Greengrass Version 1 Après le 7 octobre 2026, vous ne pourrez plus accéder aux AWS IoT Greengrass V1 ressources. Pour plus d'informations, rendez-vous sur [Migrer depuis AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html). Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # CloudWatch Connecteur Metrics Le [connecteur CloudWatch ](connectors.md) Metrics publie sur Amazon des métriques personnalisées provenant des appareils Greengrass. CloudWatch Le connecteur fournit une infrastructure centralisée pour publier CloudWatch des métriques, que vous pouvez utiliser pour surveiller et analyser l'environnement principal de Greengrass et agir en fonction des événements locaux. Pour plus d'informations, consultez la section [Utilisation CloudWatch des métriques Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) dans le *guide de CloudWatch l'utilisateur Amazon*. Ce connecteur reçoit les données des métriques en tant que messages MQTT. Le connecteur regroupe les métriques qui se trouvent dans le même espace de noms et les publie à CloudWatch intervalles réguliers. Ce connecteur est disponible dans les versions suivantes. | Version | 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` | Pour obtenir des informations sur les changements apportés aux versions, veuillez consulter le [Journal des modifications](#cloudwatch-metrics-connector-changelog). ## Exigences Ce connecteur possède les critères suivants : ------ #### [ Version 3 - 5 ] + AWS IoT Greengrass Logiciel de base v1.9.3 ou version ultérieure. + [Python](https://www.python.org/) version 3.7 ou 3.8 installé sur le périphérique principal et ajouté à la variable d'environnement PATH. **Note** Pour utiliser Python 3.8, exécutez la commande suivante pour créer un lien symbolique entre le dossier d'installation par défaut de Python 3.7 et les fichiers binaires Python 3.8 installés. ``` sudo ln -s path-to-python-3.8/python3.8 /usr/bin/python3.7 ``` Ceci configure votre appareil de sorte qu'il réponde aux exigence de Python pour AWS IoT Greengrass. + Le [rôle de groupe Greengrass](group-role.md) est configuré pour autoriser l'`cloudwatch:PutMetricData`action, comme illustré dans l'exemple de politique Gestion des identités et des accès AWS (IAM) suivant. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "Stmt1528133056761", "Action": [ "cloudwatch:PutMetricData" ], "Effect": "Allow", "Resource": "*" } ] } ``` ------ Pour l'exigence de rôle de groupe, vous devez configurer le rôle de manière à accorder les autorisations requises et à vous assurer que le rôle a été ajouté au groupe. Pour plus d’informations, consultez [Gestion du rôle de groupe Greengrass (console)](group-role.md#manage-group-role-console) ou [Gestion du rôle de groupe Greengrass (interface de ligne de commande)](group-role.md#manage-group-role-cli). Pour plus d'informations sur CloudWatch les autorisations, consultez la [référence CloudWatch des autorisations Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html) dans le *guide de l'utilisateur IAM*. ------ #### [ Versions 1 - 2 ] + AWS IoT Greengrass Logiciel principal v1.7 ou version ultérieure. + [Python](https://www.python.org/) version 2.7 installé sur le périphérique principal et ajouté à la variable d'environnement PATH. + Le [rôle de groupe Greengrass](group-role.md) est configuré pour autoriser l'`cloudwatch:PutMetricData`action, comme illustré dans l'exemple de politique Gestion des identités et des accès AWS (IAM) suivant. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "Stmt1528133056761", "Action": [ "cloudwatch:PutMetricData" ], "Effect": "Allow", "Resource": "*" } ] } ``` ------ Pour l'exigence de rôle de groupe, vous devez configurer le rôle de manière à accorder les autorisations requises et à vous assurer que le rôle a été ajouté au groupe. Pour plus d’informations, consultez [Gestion du rôle de groupe Greengrass (console)](group-role.md#manage-group-role-console) ou [Gestion du rôle de groupe Greengrass (interface de ligne de commande)](group-role.md#manage-group-role-cli). Pour plus d'informations sur CloudWatch les autorisations, consultez la [référence CloudWatch des autorisations Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html) dans le *guide de l'utilisateur IAM*. ------ ## Paramètres du connecteur Ce connecteur fournit les paramètres suivants : ------ #### [ Versions 4 - 5 ] `PublishInterval` Le nombre maximum de secondes à attendre avant de publier les métriques par lot pour un espace de nom donné. La valeur maximale est 900. Pour configurer le connecteur afin qu'il publie les métriques au fur et à mesure qu'elles sont reçues (sans traitement par lot), spécifiez 0. Le connecteur publie CloudWatch après avoir reçu 20 métriques dans le même espace de noms ou après l'intervalle spécifié. Le connecteur ne garantit pas l'ordre de publier des événements. Nom d'affichage dans la AWS IoT console : **Intervalle de publication** Nécessaire : `true` Type : `string` Valeurs valides : `0 - 900` Modèle valide : `[0-9]|[1-9]\d|[1-9]\d\d|900` `PublishRegion` Le Région AWS vers lequel publier CloudWatch les statistiques. Cette valeur remplace la région de métriques Greengrass par défaut. Elle est obligatoire uniquement lors de la publication de métriques entre régions. Nom d'affichage dans la AWS IoT console : **Région de publication** Nécessaire : `false` Type : `string` Modèle valide : `^$|([a-z]{2}-[a-z]+-\d{1})` `MemorySize` La mémoire (en Ko) à allouer au connecteur. Nom affiché dans la AWS IoT console : **Taille de la mémoire** Nécessaire : `true` Type : `string` Modèle valide : `^[0-9]+$` `MaxMetricsToRetain` Nombre maximal de métriques sur tous les espaces de noms à enregistrer en mémoire avant qu'elles ne soient remplacées par de nouvelles métriques. La valeur minimale est de 2000. Cette limite s'applique lorsqu'il n'y a aucune connexion à Internet et que le connecteur démarre pour mettre en tampon les métriques à publier ultérieurement. Lorsque le tampon est plein, les métriques les plus anciennes sont remplacées par de nouvelles métriques. Les métriques d'un espace de nom donné sont remplacées uniquement par des métriques du même espace de nom. Les métriques ne sont pas enregistrées si le processus hôte du connecteur est interrompu. Par exemple, cette interruption peut se produire pendant le déploiement du groupe ou lorsque le périphérique redémarre. Nom affiché dans la AWS IoT console : **nombre maximum de mesures à conserver** Nécessaire : `true` Type : `string` Modèle valide : `^([2-9]\d{3}|[1-9]\d{4,})$` `IsolationMode` Mode [conteneurisation](connectors.md#connector-containerization) de ce connecteur. La valeur par défaut est`GreengrassContainer`, ce qui signifie que le connecteur s'exécute dans un environnement d'exécution isolé à l'intérieur du AWS IoT Greengrass conteneur. Le paramètre de conteneurisation par défaut pour le groupe ne s'applique pas aux connecteurs. Nom affiché dans la AWS IoT console : **mode d'isolation du conteneur** Nécessaire : `false` Type : `string` Valeurs valides : `GreengrassContainer` ou `NoContainer` Modèle valide : `^NoContainer$|^GreengrassContainer$` ------ #### [ Versions 1 - 3 ] `PublishInterval` Le nombre maximum de secondes à attendre avant de publier les métriques par lot pour un espace de nom donné. La valeur maximale est 900. Pour configurer le connecteur afin qu'il publie les métriques au fur et à mesure qu'elles sont reçues (sans traitement par lot), spécifiez 0. Le connecteur publie CloudWatch après avoir reçu 20 métriques dans le même espace de noms ou après l'intervalle spécifié. Le connecteur ne garantit pas l'ordre de publier des événements. Nom d'affichage dans la AWS IoT console : **Intervalle de publication** Nécessaire : `true` Type : `string` Valeurs valides : `0 - 900` Modèle valide : `[0-9]|[1-9]\d|[1-9]\d\d|900` `PublishRegion` Le Région AWS vers lequel publier CloudWatch les statistiques. Cette valeur remplace la région de métriques Greengrass par défaut. Elle est obligatoire uniquement lors de la publication de métriques entre régions. Nom d'affichage dans la AWS IoT console : **Région de publication** Nécessaire : `false` Type : `string` Modèle valide : `^$|([a-z]{2}-[a-z]+-\d{1})` `MemorySize` La mémoire (en Ko) à allouer au connecteur. Nom affiché dans la AWS IoT console : **Taille de la mémoire** Nécessaire : `true` Type : `string` Modèle valide : `^[0-9]+$` `MaxMetricsToRetain` Nombre maximal de métriques sur tous les espaces de noms à enregistrer en mémoire avant qu'elles ne soient remplacées par de nouvelles métriques. La valeur minimale est de 2000. Cette limite s'applique lorsqu'il n'y a aucune connexion à Internet et que le connecteur démarre pour mettre en tampon les métriques à publier ultérieurement. Lorsque le tampon est plein, les métriques les plus anciennes sont remplacées par de nouvelles métriques. Les métriques d'un espace de nom donné sont remplacées uniquement par des métriques du même espace de nom. Les métriques ne sont pas enregistrées si le processus hôte du connecteur est interrompu. Par exemple, cette interruption peut se produire pendant le déploiement du groupe ou lorsque le périphérique redémarre. Nom affiché dans la AWS IoT console : **nombre maximum de mesures à conserver** Nécessaire : `true` Type : `string` Modèle valide : `^([2-9]\d{3}|[1-9]\d{4,})$` ------ ### Exemple de création de connecteur (AWS CLI) La commande CLI suivante crée un `ConnectorDefinition` avec une version initiale contenant le connecteur CloudWatch Metrics. ``` 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" } } ] }' ``` Dans la AWS IoT Greengrass console, vous pouvez ajouter un connecteur depuis la page **Connecteurs** du groupe. Pour de plus amples informations, veuillez consulter [Mise en route avec les connecteurs Greengrass (console)](connectors-console.md). ## Données d’entrée Ce connecteur accepte les métriques relatives à un sujet MQTT et les publie sur. CloudWatch Les messages d'entrée doivent être au format JSON. **Filtre de rubrique dans l'abonnement** `cloudwatch/metric/put` **Propriétés des messages** `request` Informations sur la métrique dans ce message. L'objet de la demande contient les données de métrique à publier dans CloudWatch. Les valeurs métriques doivent répondre aux spécifications de l'[https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)API. Seules les propriétés `namespace`, `metricData.metricName` et `metricData.value` sont obligatoires. Nécessaire : `true` Type : `object` qui inclut les propriétés suivantes : `namespace` L'espace de noms défini par l'utilisateur pour les données métriques de cette demande. CloudWatch utilise des espaces de noms comme conteneurs pour les points de données métriques. Vous ne pouvez pas spécifier un espace de noms commençant par la chaîne `AWS/` réservée. Nécessaire : `true` Type : `string` Modèle valide : `[^:].*` `metricData` Les données pour la métrique. Nécessaire : `true` Type : `object` qui inclut les propriétés suivantes : `metricName` Le nom de la métrique. Nécessaire : `true` Type : `string` `dimensions` Les dimensions qui sont associées à la métrique. Les dimensions fournissent des informations supplémentaires sur la métrique et ses données. Une métrique peut définir jusqu'à 10 dimensions. Ce connecteur inclut automatiquement une dimension nommée`coreName`, dont la valeur est le nom du noyau. Nécessaire : `false` Type : `array` d'objets de dimension qui incluent les propriétés suivantes : `name` Nom de la dimension. Nécessaire : `false` Type : `string` `value` Valeur de la dimension. Nécessaire : `false` Type : `string` `timestamp` Heure à laquelle les données métriques ont été reçues, exprimée en nombre de secondes écoulées depuis`Jan 1, 1970 00:00:00 UTC`. Si cette valeur n'est pas spécifiée, le connecteur utilise l'heure à laquelle il a reçu le message. Nécessaire : `false` Type : `timestamp` Si vous utilisez entre les versions 1 et 4 de ce connecteur, nous vous recommandons de récupérer l'horodatage séparément pour chaque métrique lorsque vous envoyez plusieurs métriques à partir d'une seule source. N'utilisez pas de variable pour enregistrer l'horodatage. `value` Valeur de la métrique. CloudWatch rejette les valeurs trop petites ou trop grandes. Ces valeurs doivent être dans la plage de `8.515920e-109` à `1.174271e+108` (Base 10) ou `2e-360` à `2e360` (Base 2). Les valeurs spéciales (par exemple, `NaN`, `+Infinity`, `-Infinity`) ne sont pas prises en charge. Nécessaire : `true` Type : `double` `unit` Unité de la métrique. Nécessaire : `false` Type : `string` Valeurs valides : `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` Restrictions Toutes les limites imposées par l' CloudWatch [https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)API s'appliquent aux métriques lors de l'utilisation de ce connecteur. Les limites suivantes sont particulièrement importantes : + Limite de 40 Ko pour la charge utile d'API + 20 métriques par requête d'API + 150 transactions par seconde (TPS) pour l'API `PutMetricData` Pour plus d'informations, consultez [CloudWatch les limites](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_limits.html) dans le *guide de CloudWatch l'utilisateur Amazon*. **Exemple d'entrée** ``` { "request": { "namespace": "Greengrass", "metricData": { "metricName": "latency", "dimensions": [ { "name": "hostname", "value": "test_hostname" } ], "timestamp": 1539027324, "value": 123.0, "unit": "Seconds" } } } ``` ## Données de sortie Ce connecteur publie des informations d'état sous forme de données de sortie dans une rubrique MQTT. **Filtre de rubrique dans l'abonnement** `cloudwatch/metric/put/status` **Exemple de sortie : réussite** La réponse inclut l'espace de noms des données métriques et le `RequestId` champ de la CloudWatch réponse. ``` { "response": { "cloudwatch_rid":"70573243-d723-11e8-b095-75ff2EXAMPLE", "namespace": "Greengrass", "status":"success" } } ``` **Exemple de sortie : échec** ``` { "response" : { "namespace": "Greengrass", "error": "InvalidInputException", "error_message":"cw metric is invalid", "status":"fail" } } ``` Si le connecteur détecte une erreur réessayable (par exemple, des erreurs de connexion), il réessaie de publier dans le lot suivant. ## Exemple d'utilisation Suivez les étapes de haut niveau suivantes pour configurer un exemple de fonction Lambda en Python 3.7 que vous pouvez utiliser pour tester le connecteur. **Note** Si vous utilisez d'autres environnements d'exécution Python, vous pouvez créer un lien symbolique entre Python3.x et Python 3.7. Les rubriques [Démarrer avec les connecteurs (console)](connectors-console.md) et [Démarrer avec les connecteurs (CLI)](connectors-cli.md) contiennent des étapes détaillées qui vous montrent comment configurer et déployer un exemple de connecteur Twilio Notifications. 1. Veillez à répondre aux [conditions requises](#cloudwatch-metrics-connector-req) pour le connecteur. Pour l'exigence de rôle de groupe, vous devez configurer le rôle de manière à accorder les autorisations requises et à vous assurer que le rôle a été ajouté au groupe. Pour plus d’informations, consultez [Gestion du rôle de groupe Greengrass (console)](group-role.md#manage-group-role-console) ou [Gestion du rôle de groupe Greengrass (interface de ligne de commande)](group-role.md#manage-group-role-cli). 1. Créez et publiez une fonction Lambda qui envoie des données d'entrée au connecteur. Enregistrez l'[exemple de code](#cloudwatch-metrics-connector-usage-example) en tant que fichier PY. Téléchargez et décompressez le [SDK AWS IoT Greengrass de base pour Python](lambda-functions.md#lambda-sdks-core). Ensuite, créez un package zip contenant le fichier PY et le dossier `greengrasssdk` au niveau racine. Ce package zip est le package de déploiement vers lequel vous effectuez le téléchargement AWS Lambda. Après avoir créé la fonction Lambda de Python 3.7, publiez une version de la fonction et créez un alias. 1. Configurez votre groupe Greengrass. 1. Ajoutez la fonction Lambda par son alias (recommandé). Configurez le cycle de vie Lambda comme étant de longue durée (ou dans `"Pinned": true` la CLI). 1. Ajoutez le connecteur et configurez ses [paramètres](#cloudwatch-metrics-connector-param). 1. Ajoutez des abonnements qui permettent au connecteur de recevoir des [données d'entrée](#cloudwatch-metrics-connector-data-input) et d'envoyer des [données de sortie](#cloudwatch-metrics-connector-data-output) sur des filtres de rubrique pris en charge. + Définissez la fonction Lambda comme source, le connecteur comme cible et utilisez un filtre de rubrique d'entrée compatible. + Définissez le connecteur en tant que source, AWS IoT Core en tant que cible et utilisez un filtre de rubrique de sortie pris en charge. Vous utilisez cet abonnement pour afficher les messages d'état dans la AWS IoT console. 1. Déployez le groupe. 1. Dans la AWS IoT console, sur la page **Test**, abonnez-vous à la rubrique relative aux données de sortie pour consulter les messages d'état provenant du connecteur. L'exemple de fonction Lambda a une longue durée de vie et commence à envoyer des messages immédiatement après le déploiement du groupe. Lorsque vous avez terminé les tests, vous pouvez définir le cycle de vie Lambda à la demande (ou `"Pinned": false` dans la CLI) et déployer le groupe. Cela empêche la fonction d'envoyer des messages. ### Exemple L'exemple suivant de fonction Lambda envoie un message d'entrée au connecteur. ``` 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 ``` ## Licences Le connecteur CloudWatch Metrics inclut les logiciels/licences tiers suivants : + [AWS SDK pour Python (Boto3)](https://pypi.org/project/boto3/)/Licence Apache 2.0 + [botocore](https://pypi.org/project/botocore/)/Licence Apache 2.0 + [dateutil](https://pypi.org/project/python-dateutil/1.4/)/Licence PSF + [docutils](https://pypi.org/project/docutils/)/Licence BSD, licence GPL (General Public License) GNU, licence Python Software Foundation, domaine public + [jmespath](https://pypi.org/project/jmespath/)/Licence MIT + [s3transfer](https://pypi.org/project/s3transfer/)/Licence Apache 2.0 + [urllib3](https://pypi.org/project/urllib3/)/Licence MIT Ce connecteur est publié dans le cadre du contrat de [licence logicielle Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Journal des modifications Le tableau suivant décrit les modifications apportées à chaque version du connecteur. | Version | Modifications | | --- | --- | | 5 | Correctif pour ajouter la prise en charge des horodatages dupliqués dans les données d'entrée. | | 4 | Ajout du paramètre `IsolationMode` pour configurer le mode de conteneurisation du connecteur. | | 3 | Mise à niveau de l'environnement d'exécution Lambda vers Python 3.7, ce qui modifie les exigences d'exécution. | | 2 | Correctif pour réduire la journalisation excessive. | | 1 | Première version. | Un groupe Greengrass ne peut contenir qu'une seule version du connecteur à la fois. Pour de plus amples informations sur la mise à niveau d'une version de connecteur, veuillez consulter [Mise à niveau des versions du connecteur](connectors.md#upgrade-connector-versions). ## Consultez aussi + [Intégrer à des services et protocoles à l'aide de connecteurs Greengrass](connectors.md) + [Mise en route avec les connecteurs Greengrass (console)](connectors-console.md) + [Démarrage avec les connecteurs Greengrass (CLI)](connectors-cli.md) + [Utilisation des CloudWatch métriques Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) dans le *guide de CloudWatch l'utilisateur Amazon* + [ PutMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)dans le *Amazon CloudWatch API Reference*