Émetteur de télémétrie Nucleus - AWS IoT Greengrass

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.

Émetteur de télémétrie Nucleus

Le composant émetteur de télémétrie Nucleus (aws.greengrass.telemetry.NucleusEmitter) collecte les données de télémétrie relatives à l'état du système et les publie en permanence sur un sujet local et un sujet. AWS IoT Core MQTT Ce composant vous permet de recueillir les données télémétriques du système en temps réel sur vos principaux appareils Greengrass. Pour plus d'informations sur l'agent de télémétrie Greengrass qui publie les données de télémétrie du système sur Amazon, consultez. EventBridge Collectez les données de télémétrie relatives à l'état du système à partir des principaux appareils AWS IoT Greengrass

Par défaut, le composant émetteur de télémétrie Nucleus publie les données de télémétrie toutes les 60 secondes sur la rubrique locale de publication/d'abonnement suivante.

$local/greengrass/telemetry

Le composant émetteur de télémétrie Nucleus ne publie pas dans un AWS IoT Core MQTT sujet par défaut. Vous pouvez configurer ce composant pour qu'il soit publié dans une AWS IoT Core MQTT rubrique lorsque vous le déployez. L'utilisation d'une MQTT rubrique pour publier des données sur le AWS Cloud est soumise à une AWS IoT Core tarification.

AWS IoT Greengrass fournit plusieurs composants communautaires pour vous aider à analyser et à visualiser les données de télémétrie localement sur votre appareil principal à l'aide d'InfluxDB et Grafana. Ces composants utilisent les données de télémétrie du composant émetteur du noyau. Pour plus d'informations, consultez le README composant éditeur InfluxDB.

Versions

Les versions de ce composant sont les suivantes :

  • 1,0 x

Type

Ce composant est un composant de plugin (aws.greengrass.plugin). Le noyau Greengrass exécute ce composant dans la même machine virtuelle Java (JVM) que le noyau. Le noyau redémarre lorsque vous modifiez la version de ce composant sur le périphérique principal.

Ce composant utilise le même fichier journal que le noyau Greengrass. Pour de plus amples informations, veuillez consulter AWS IoT GreengrassJournaux de surveillance.

Pour de plus amples informations, veuillez consulter Types de composants.

Système d’exploitation

Ce composant peut être installé sur les appareils principaux qui exécutent les systèmes d'exploitation suivants :

  • Linux

  • Windows

Dépendances

Lorsque vous déployez un composant, il déploie AWS IoT Greengrass également des versions compatibles de ses dépendances. Cela signifie que vous devez satisfaire aux exigences relatives au composant et à toutes ses dépendances pour réussir le déploiement du composant. Cette section répertorie les dépendances des versions publiées de ce composant et les contraintes de version sémantiques qui définissent les versions des composants pour chaque dépendance. Vous pouvez également consulter les dépendances de chaque version du composant dans la AWS IoT Greengrass console. Sur la page de détails du composant, recherchez la liste des dépendances.

1.0.9

Le tableau suivant répertorie les dépendances pour la version 1.0.9 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,4,0 <2,14,0 Stricte
1.0.8

Le tableau suivant répertorie les dépendances pour la version 1.0.8 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,4,0 <2,13,0 Stricte
1.0.7

Le tableau suivant répertorie les dépendances pour la version 1.0.7 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,4,0 <2,12,0 Stricte
1.0.6

Le tableau suivant répertorie les dépendances pour la version 1.0.6 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,4,0 <2,11,0 Stricte
1.0.5

Le tableau suivant répertorie les dépendances pour la version 1.0.5 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,4,0 <2,1,0 Stricte
1.0.4

Le tableau suivant répertorie les dépendances pour la version 1.0.4 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,4,0 <2,9,0 Stricte
1.0.3

Le tableau suivant répertorie les dépendances pour la version 1.0.3 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,4,0 <2,8,0 Stricte
1.0.2

Le tableau suivant répertorie les dépendances pour la version 1.0.2 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,4,0 <2,7,0 Stricte
1.0.1

Le tableau suivant répertorie les dépendances pour la version 1.0.1 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,4,0 <2,6,0 Stricte
1.0.0

Le tableau suivant répertorie les dépendances pour la version 1.0.0 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,4,0 <2,5,0 Stricte

Pour plus d'informations sur les dépendances des composants, consultez la référence de la recette des composants.

Configuration

Ce composant fournit les paramètres de configuration suivants que vous pouvez personnaliser lorsque vous déployez le composant.

pubSubPublish

(Facultatif) Définit s'il faut publier des données de télémétrie dans le $local/greengrass/telemetry sujet. Les valeurs prises en charge sont true et false.

Par défaut : true

mqttTopic

(Facultatif) AWS IoT Core MQTT Rubrique dans laquelle ce composant publie les données de télémétrie.

Définissez cette valeur sur le AWS IoT Core MQTT sujet sur lequel vous souhaitez publier les données de télémétrie. Lorsque cette valeur est vide, l'émetteur du noyau ne publie pas les données de télémétrie dans le. AWS Cloud

Note

L'utilisation d'une MQTT rubrique pour publier des données sur le AWS Cloud est soumise à une AWS IoT Core tarification.

Par défaut : ""

telemetryPublishIntervalMs

(Facultatif) Durée (en millisecondes) entre laquelle le composant publie les données de télémétrie. Si vous définissez cette valeur en dessous de la valeur minimale prise en charge, le composant utilise la valeur minimale à la place.

Note

Des intervalles de publication plus courts se traduisent par une CPU utilisation accrue sur votre appareil principal. Nous vous recommandons de commencer par l'intervalle de publication par défaut et de l'ajuster en fonction de l'CPUutilisation de votre appareil.

Minimum : 500

Par défaut : 60000

Exemple : mise à jour de la fusion de configurations

L'exemple suivant montre un exemple de mise à jour de fusion de configuration qui permet de publier des données de télémétrie toutes les 5 secondes sur le $local/greengrass/telemetry sujet et le greengrass/myTelemetry AWS IoT Core MQTT sujet.

{ "pubSubPublish": "true", "mqttTopic": "greengrass/myTelemetry", "telemetryPublishIntervalMs": 5000 }

Données de sortie

Ce composant publie les métriques de télémétrie sous forme de JSON tableau sur le sujet suivant.

Sujet local : $local/greengrass/telemetry

Vous pouvez éventuellement choisir de publier également les mesures de télémétrie dans une AWS IoT Core MQTT rubrique. Pour plus d'informations sur les sujets, consultez MQTTles rubriques du Guide du AWS IoT Core développeur.

Exemple de données
[ { "A": "Average", "N": "CpuUsage", "NS": "SystemMetrics", "TS": 1627597331445, "U": "Percent", "V": 26.21981271562346 }, { "A": "Count", "N": "TotalNumberOfFDs", "NS": "SystemMetrics", "TS": 1627597331445, "U": "Count", "V": 7316 }, { "A": "Count", "N": "SystemMemUsage", "NS": "SystemMetrics", "TS": 1627597331445, "U": "Megabytes", "V": 10098 }, { "A": "Count", "N": "NumberOfComponentsStarting", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsInstalled", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsStateless", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsStopping", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsBroken", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsRunning", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 7 }, { "A": "Count", "N": "NumberOfComponentsErrored", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsNew", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsFinished", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 2 } ]

Le tableau de sortie contient une liste de métriques possédant les propriétés suivantes :

A

Type d'agrégation pour la métrique.

Pour la CpuUsage métrique, cette propriété est définie sur Average car la valeur publiée de la métrique est le montant CPU d'utilisation moyen depuis le dernier événement de publication.

Pour toutes les autres mesures, l'émetteur du noyau n'agrège pas la valeur de la métrique, et cette propriété est définie sur. Count

N

Le nom de la métrique.

NS

L'espace de noms de la métrique.

TS

Horodatage du moment où les données ont été collectées.

U

Unité de la valeur métrique.

V

Valeur de la métrique .

L'émetteur du noyau publie les métriques suivantes :

Name (Nom) Description

Système

SystemMemUsage

La quantité de mémoire actuellement utilisée par toutes les applications du périphérique principal de Greengrass, y compris le système d'exploitation.

CpuUsage

La quantité CPU actuellement utilisée par toutes les applications du périphérique principal de Greengrass, y compris le système d'exploitation.

TotalNumberOfFDs

Nombre de descripteurs de fichiers stockés par le système d'exploitation du périphérique principal Greengrass. Un descripteur de fichier identifie de manière unique un fichier ouvert.

Noyau de Greengrass

NumberOfComponentsRunning

Le nombre de composants qui s'exécutent sur le périphérique principal de Greengrass.

NumberOfComponentsErrored

Nombre de composants présentant un état d'erreur sur le périphérique principal de Greengrass.

NumberOfComponentsInstalled

Le nombre de composants installés sur le périphérique principal de Greengrass.

NumberOfComponentsStarting

Le nombre de composants qui démarrent sur le périphérique principal de Greengrass.

NumberOfComponentsNew

Le nombre de composants nouveaux sur le périphérique principal de Greengrass.

NumberOfComponentsStopping

Le nombre de composants qui s'arrêtent sur le périphérique principal de Greengrass.

NumberOfComponentsFinished

Le nombre de composants terminés sur le périphérique principal Greengrass.

NumberOfComponentsBroken

Le nombre de composants cassés sur le périphérique principal de Greengrass.

NumberOfComponentsStateless

Le nombre de composants qui sont apatrides sur le périphérique principal de Greengrass.

Utilisation

Pour utiliser les données de télémétrie relatives à l'état du système, vous pouvez créer des composants personnalisés qui s'abonnent aux rubriques sur lesquelles l'émetteur du noyau publie les données de télémétrie, et qui réagissent à ces données selon les besoins. Le composant Nucleus Emitter offrant la possibilité de publier des données de télémétrie sur un sujet local, vous pouvez vous abonner à ce sujet et utiliser les données publiées pour agir localement sur votre appareil principal. L'appareil principal peut alors réagir aux données de télémétrie même lorsque sa connectivité au cloud est limitée.

Par exemple, vous pouvez configurer un composant qui écoute les données de télémétrie sur le $local/greengrass/telemetry sujet et envoie les données au composant du gestionnaire de flux pour qu'il diffuse vos données vers le. AWS Cloud Pour plus d'informations sur la création d'un tel composant, reportez-vous Publier/souscrire des messages locaux aux sections etCréez des composants personnalisés qui utilisent le gestionnaire de flux.

Fichier journal local

Ce composant utilise le même fichier journal que le composant Greengrass nucleus.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
Pour consulter les journaux de ce composant
  • Exécutez la commande suivante sur le périphérique principal pour afficher le fichier journal de ce composant en temps réel. Remplacer /greengrass/v2 ou C:\greengrass\v2 avec le chemin d'accès au dossier AWS IoT Greengrass racine.

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Journal des modifications

Le tableau suivant décrit les modifications apportées à chaque version du composant.

Version

Modifications

1.0.9

Version mise à jour pour la version 2.13.0 de Greengrass Nucleus.

1.0.8

Version mise à jour pour la version 2.12.0 de Greengrass Nucleus.

1.0.7

Version mise à jour pour la version 2.11.0 de Greengrass Nucleus.

1.0.6

Version mise à jour pour la version 2.10.0 de Greengrass Nucleus.

1.0.5

Version mise à jour pour la version 2.9.0 de Greengrass Nucleus.

1.0.4

Version mise à jour pour la version 2.8.0 de Greengrass Nucleus.

1.0.3

Version mise à jour pour la version 2.7.0 de Greengrass Nucleus.

1.0.2

Version mise à jour pour la version 2.6.0 de Greengrass Nucleus.

1.0.1

Version mise à jour pour la version 2.5.0 de Greengrass Nucleus.

1.0.0

Première version.