Nucleus-Telemetrie-Sender

Die Nucleus-Telemetrie-Emitter-Komponente (aws.greengrass.telemetry.NucleusEmitter) sammelt Telemetriedaten zur Systemintegrität und veröffentlicht sie kontinuierlich zu einem lokalen Thema und einem Thema. AWS IoT Core MQTT Mit dieser Komponente können Sie Systemtelemetrie in Echtzeit auf Ihren Greengrass-Kerngeräten erfassen. Informationen zum Greengrass-Telemetrie-Agenten, der Systemtelemetrie-Daten auf Amazon EventBridge veröffentlicht, finden Sie unter. Erfassen von Telemetriedaten zum Systemstatus von -AWS IoT GreengrassCore-Geräten

Standardmäßig veröffentlicht die Nucleus-Telemetrie-Emitter-Komponente alle 60 Sekunden Telemetriedaten unter dem folgenden lokalen Veröffentlichungs-/Abonnement-Thema.

$local/greengrass/telemetry

Die Nucleus-Telemetrie-Emitter-Komponente veröffentlicht standardmäßig keine Beiträge zu einem Thema. AWS IoT Core MQTT Sie können diese Komponente so konfigurieren, dass sie bei der Bereitstellung zu einem AWS IoT Core MQTT Thema veröffentlicht. Die Verwendung eines MQTT Themas zur Veröffentlichung von Daten in der AWS Cloud ist AWS IoT Core kostenpflichtig.

AWS IoT Greengrass bietet mehrere Community-Komponenten, mit denen Sie Telemetriedaten mithilfe von InfluxDB und Grafana lokal auf Ihrem Kerngerät analysieren und visualisieren können. Diese Komponenten verwenden Telemetriedaten von der Nukleus-Emitter-Komponente. Weitere Informationen finden Sie in der README InfluxDB-Publisher-Komponente.

Versionen

Diese Komponente hat die folgenden Versionen:

Typ

Diese Komponente ist eine Plugin-Komponente (aws.greengrass.plugin). Der Greengrass-Kern führt diese Komponente in derselben Java Virtual Machine (JVM) wie der Nucleus aus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Core-Gerät ändern.

Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Kern. Weitere Informationen finden Sie unter Überwachen von AWS IoT Greengrass Protokollen.

Weitere Informationen finden Sie unter Komponententypen.

Betriebssystem

Abhängigkeiten

Wenn Sie eine Komponente bereitstellen, stellt sie AWS IoT Greengrass auch kompatible Versionen ihrer Abhängigkeiten bereit. Das bedeutet, dass Sie die Anforderungen für die Komponente und all ihre Abhängigkeiten erfüllen müssen, um die Komponente erfolgreich bereitstellen zu können. In diesem Abschnitt werden die Abhängigkeiten für die veröffentlichten Versionen dieser Komponente sowie die semantischen Versionseinschränkungen aufgeführt, die die Komponentenversionen für jede Abhängigkeit definieren. Sie können auch die Abhängigkeiten für jede Version der Komponente in der AWS IoT Greengrass Konsole anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der Abhängigkeiten.

Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.

Konfiguration

Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.

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

Ausgabedaten

Diese Komponente veröffentlicht Telemetrie-Metriken als JSON Array zum folgenden Thema.

Lokales Thema: $local/greengrass/telemetry

Sie können optional auch Telemetriemetriken zu einem AWS IoT Core MQTT Thema veröffentlichen. Weitere Informationen zu den Themen finden Sie unter den MQTTThemen im AWS IoT Core Entwicklerhandbuch.

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

Der Nukleus-Emitter veröffentlicht die folgenden Metriken:

Verwendung

Um Telemetriedaten zur Systemintegrität zu verwenden, können Sie benutzerdefinierte Komponenten erstellen, die die Themen abonnieren, zu denen der Nucleus-Emitter die Telemetriedaten veröffentlicht, und bei Bedarf auf diese Daten reagieren. Da die Nucle-Emitter-Komponente die Möglichkeit bietet, Telemetriedaten zu einem lokalen Thema zu veröffentlichen, können Sie dieses Thema abonnieren und die veröffentlichten Daten verwenden, um lokal auf Ihrem Kerngerät zu agieren. Das Core-Gerät kann dann auf Telemetriedaten reagieren, selbst wenn es nur über eine begrenzte Konnektivität zur Cloud verfügt.

Sie können beispielsweise eine Komponente konfigurieren, die das $local/greengrass/telemetry Thema auf Telemetriedaten überwacht, und die Daten an die Stream-Manager-Komponente senden, um Ihre Daten an die zu streamen. AWS Cloud Weitere Hinweise zum Erstellen einer solchen Komponente finden Sie unter Lokale Nachrichten veröffentlichen/abonnieren und. Erstellen Sie benutzerdefinierte Komponenten, die den Stream-Manager verwenden

Lokale Protokolldatei

Diese Komponente verwendet dieselbe Protokolldatei wie die Greengrass Nucleus-Komponente.

Änderungsprotokoll

In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.