Émetteur de télémétrie Nucleus

Le composant émetteur de télémétrie du noyau (aws.greengrass.telemetry.NucleusEmitter) rassemble les données télémétriques relatives à l'état du système et les publie en permanence sur un sujet local et un sujet MQTT. AWS IoT Core Ce composant vous permet de recueillir des données télémétriques 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 des données de télémétrie toutes les 60 secondes sur la rubrique locale suivante. publish/subscribe

$local/greengrass/telemetry

Le composant émetteur de télémétrie Nucleus ne publie pas dans une rubrique AWS IoT Core MQTT par défaut. Vous pouvez configurer ce composant pour qu'il soit publié dans une rubrique AWS IoT Core MQTT lorsque vous le déployez. L'utilisation d'une rubrique MQTT 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 pour le composant éditeur InfluxDB.

Versions

Les versions de ce composant sont les suivantes :

Type

Ce composant est un composant de plug-in (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 Greengrass Journaux de surveillance.

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

Système d’exploitation

Dépendances

Lorsque vous déployez un composant, déploie AWS IoT Greengrass également des versions compatibles de ses dépendances. Cela signifie que vous devez répondre aux exigences relatives au composant et à toutes ses dépendances pour pouvoir le déployer avec succès. Cette section répertorie les dépendances pour les 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 pour chaque version du composant dans la AWS IoT Greengrass console. Sur la page des détails des composants, recherchez la liste des dépendances.

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

Configuration

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

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

Données de sortie

Ce composant publie des mesures de télémétrie sous forme de tableau JSON sur la rubrique suivante.

Thème local : $local/greengrass/telemetry

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

[
  {
    "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
  }
]

L'émetteur Nucleus publie les métriques suivantes :

Usage

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 dans lesquelles l'émetteur principal publie les données de télémétrie et qui réagissent à ces données selon les besoins. Comme le composant émetteur Nucleus offre la possibilité de publier des données de télémétrie sur une rubrique locale, vous pouvez vous abonner à cette rubrique et utiliser les données publiées pour agir localement sur votre périphérique principal. L'appareil principal peut alors réagir aux données de télémétrie même lorsqu'il dispose d'une connectivité limitée au cloud.

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

Fichier journal local

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

Journal des modifications

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