AWS IoT Greengrass Version 1 est entré dans la phase de durée de vie prolongée le 30 juin 2023. Pour plus d'informations, consultez la politique de AWS IoT Greengrass V1 maintenance. Après cette date, AWS IoT Greengrass V1 ne publiera pas de mises à jour fournissant des fonctionnalités, des améliorations, des corrections de bogues ou des correctifs de sécurité. Les appareils qui fonctionnent AWS IoT Greengrass V1 sous tension ne seront pas perturbés et continueront à fonctionner et à se connecter au cloud. Nous vous recommandons vivement de migrer vers AWS IoT Greengrass Version 2, qui ajoute de nouvelles fonctionnalités importantes et prend en charge des plateformes supplémentaires.

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.

Collecte de données de télémétrie sur l'état du système à partir des appareilsAWS IoT Greengrass principaux

Les données de télémétrie sur l'état du système sont des données de diagnostic qui peuvent vous aider à surveiller les performances des opérations critiques sur vos appareils principaux Greengrass. L'agent de télémétrie du noyau Greengrass collecte des données de télémétrie locales et les publie sur Amazon EventBridge sans nécessiter d'interaction avec le client. Les appareils principaux publient des données de télémétrie dans EventBridge la mesure du possible. Par exemple, les appareils principaux peuvent ne pas fournir de données de télémétrie lorsqu'ils sont hors ligne.

Vous pouvez créer des projets et des applications pour récupérer, analyser, transformer et générer des rapports de télémétrie à partir de vos appareils de périphérie. Les experts du domaine, tels que les ingénieurs de procédés, peuvent utiliser ces applications pour mieux comprendre l'état de santé de la flotte.

Pour garantir le bon fonctionnement des composants de pointe de Greengrass,AWS IoT Greengrass utilise les données à des fins de développement et d'amélioration de la qualité. Cette fonctionnalité permet également de définir des fonctionnalités de pointe nouvelles et améliorées. AWS IoT Greengrassne conserve les données de télémétrie que pendant sept jours au maximum.

Cette fonctionnalité est disponible dans le logicielAWS IoT Greengrass Core v1.11.0 et est activée par défaut pour tous les cœurs Greengrass, y compris les cœurs existants. Vous commencez automatiquement à recevoir des données dès que vous passez au logicielAWS IoT Greengrass Core v1.11.0 ou version ultérieure.

Pour plus d'informations sur l'accès ou la gestion des données de télémétrie publiées ou sur la gestion de données de télémétrie publiées, consultezS'abonner pour recevoir des données de télémétrie.

L'agent de télémétrie collecte et publie les mesures système suivantes.

Configuration des paramètres de télémétrie

La télémétrie Greengrass utilise les paramètres suivants :

Vous pouvez activer ou désactiver la fonction de télémétrie pour un périphérique Greengrass Core. AWS IoT Greengrassutilise des ombres pour gérer la configuration de la télémétrie. Vos modifications prennent effet immédiatement lorsque le noyau est connecté àAWS IoT Core.

L'agent de télémétrie publie des données à l'aide du protocole MQTT avec un niveau de qualité de service (QoS) de 0. Cela signifie qu'il ne confirme pas la livraison et ne tente pas à nouveau de publier. Les messages de télémétrie partagent une connexion MQTT avec d'autres messages pour les abonnements auxquels ils sont destinésAWS IoT Core.

Outre les coûts de liaison de données, le transfert de données du noyau vers leAWS IoT Core serveur est gratuit. Cela est dû au fait que l'agent publie dans une rubriqueAWS réservée. Toutefois, selon votre cas d'utilisation, vous pouvez encourir des frais lorsque vous recevez ou traitez les données.

Prérequis

Les exigences suivantes s'appliquent lorsque vous configurez les paramètres de télémétrie :

Configuration des paramètres de télémétrie (console)

Ce qui suit montre comment mettre à jour les paramètres de télémétrie d'un noyau Greengrass dans laAWS IoT Greengrass console.

Les modifications prennent effet au moment de l'exécution. Vous n'avez pas besoin de déployer le groupe.

Configurer les paramètres de télémétrie (CLI)

Dans l'AWS IoT GreengrassAPI, l'TelemetryConfigurationobjet représente les paramètres de télémétrie d'un noyau Greengrass. Cet objet fait partie de l'RuntimeConfigurationobjet associé au noyau. Vous pouvez utiliser l'AWS IoT GreengrassAPI ouAWS CLI leAWS SDK pour gérer la télémétrie Greengrass. Les exemples de cette section utilisent leAWS CLI.

TelemetryConfiguration objet

L'TelemetryConfigurationobjet a les propriétés suivantes :

S'abonner pour recevoir des données de télémétrie

Vous pouvez créer des règles dans Amazon EventBridge qui définissent la manière de traiter les données de télémétrie publiées à partir de l'appareil principal Greengrass. Lorsqu'il EventBridge reçoit les données, il appelle les actions cibles définies dans vos règles. Vous pouvez, par exemple, créer des règles d'événement pour envoyer des notifications, stocker des informations sur les événements, prendre des mesures correctives ou appeler d'autres événements.

Événement de télémétrie

L'événement de changement d'état de déploiement incluant les données de télémétrie utilise le format suivant :

{
    "version": "0",
    "id": "f70f943b-9ae2-e7a5-fec4-4c22178a3e6a",
    "detail-type": "Greengrass Telemetry Data",
    "source": "aws.greengrass",
    "account": "123456789012",
    "time": "2020-07-28T20:45:53Z",
    "region": "us-west-1",
    "resources": [],
    "detail": {
        "ThingName": "CoolThing",
        "Schema": "2020-06-30",
        "ADP": [
            {
                "TS": 123231546,
                "NS": "StreamManager",
                "M": [
                    {
                        "N": "BytesAppended|BytesUploadedToKinesis",
                        "Sum": 11,
                        "U": "Bytes"
                    }
                ]
            },
            {
                "TS": 123231546,
                "NS": "StreamManager",
                "M": [
                    {
                        "N": "BytesAppended|BytesUploadedToS3ExportTaskExecutor",
                        "Sum": 11,
                        "U": "Bytes"
                    }
                ]
            },
            {
                "TS": 123231546,
                "NS": "StreamManager",
                "M": [
                    {
                        "N": "BytesAppended|BytesUploadedToHTTP",
                        "Sum": 11,
                        "U": "Bytes"
                    }
                ]
            },
            {
                "TS": 123231546,
                "NS": "StreamManager",
                "M": [
                    {
                        "N": "BytesAppended|BytesUploadedToIoTAnalytics",
                        "Sum": 11,
                        "U": "Bytes"
                    }
                ]
            },
            {
                "TS": 123231546,
                "NS": "StreamManager",
                "M": [
                    {
                        "N": "BytesAppended|BytesUploadedToIoTSiteWise",
                        "Sum": 11,
                        "U": "Bytes"
                    }
                ]
            },
            {
                "TS": 123231546,
                "NS": "arn:aws:lambda:us-west-1:123456789012:function:my-function",
                "M": [
                    {
                        "N": "LambdaTimeout",
                        "Sum": 15,
                        "U": "Count"
                    }
                ]
            },
            {
                "TS": 123231546,
                "NS": "CloudSpooler",
                "M": [
                    {
                        "N": "DroppedMessageCount",
                        "Sum": 15,
                        "U": "Count"
                    }
                ]
            },
            {
                "TS": 1593727692,
                "NS": "SystemMetrics",
                "M": [
                    {
                        "N": "SystemMemUsage",
                        "Sum": 11.23,
                        "U": "Megabytes"
                    },
                    {
                        "N": "CpuUsage",
                        "Sum": 35.63,
                        "U": "Percent"
                    },
                    {
                        "N": "TotalNumberOfFDs",
                        "Sum": 416,
                        "U": "Count"
                    }
                ]
            },
            {
                "TS": 1593727692,
                "NS": "arn:aws:lambda:us-west-1:123456789012:function:my-function",
                "M": [
                    {
                        "N": "LambdaOutOfMemory",
                        "Sum": 12,
                        "U": "Count"
                    },
                    {
                        "N": "LambdaUngracefullyKilled",
                        "Sum": 100,
                        "U": "Count"
                    },
                    {
                        "N": "LambdaError",
                        "Sum": 7,
                        "U": "Count"
                    }
                ]
            }
        ]
    }
}

LeADP tableau contient une liste de points de données agrégés qui possèdent les propriétés suivantes :

Conditions préalables à la création de EventBridge règles

Avant de créer une EventBridge règle pourAWS IoT Greengrass, vous devez procéder comme suit :

Pour plus d'informations, consultez Qu'est-ce qu'Amazon EventBridge ? et Démarrez avec Amazon EventBridge dans le Guide de EventBridge l'utilisateur Amazon.

Création d'une règle d'événement pour obtenir des données de télémétrie (console)

Suivez les étapes suivantes pourAWS Management Console créer une EventBridge règle qui reçoit les données de télémétrie publiées par le noyau Greengrass. Cela permet aux serveurs web, aux adresses e-mail et aux autres abonnés à la rubrique de répondre à l'événement. Pour plus d'informations, consultez la section Création d'une EventBridge règle qui se déclenche lors d'un événement à partir d'uneAWS ressource du Guide de EventBridge l'utilisateur Amazon.

Création d'une règle d'événement pour obtenir des données de télémétrie (CLI)

Suivez les étapes suivantes pourAWS CLI créer une EventBridge règle qui reçoit les données de télémétrie publiées par le noyau Greengrass. Cela permet aux serveurs web, aux adresses e-mail et aux autres abonnés à la rubrique de répondre à l'événement.

Pour plus d'informations, consultez la section Événements et modèles d'événements EventBridge dans le Guide de EventBridge l'utilisateur Amazon.

Résolution des problèmesAWS IoT Greengrass de télémétrie

Consultez les informations suivantes pour essayer de résoudre les problèmes liés à la configuration de laAWS IoT Greengrass télémétrie.

Erreur : la réponse contient "ConfigurationStatus« :"OutOfSync "après avoir exécuté la get-thing-runtime-configuration commande

Des solutions :