Kerntelemetrie-Emitter

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

Standardmäßig veröffentlicht die Nucleus-Telemetrie-Emitter-Komponente alle 60 Sekunden Telemetriedaten zum folgenden lokalen Thema. publish/subscribe

$local/greengrass/telemetry

Die Nucleus-Telemetrie-Emitter-Komponente veröffentlicht standardmäßig nicht in einem AWS IoT Core MQTT-Thema. Sie können diese Komponente so konfigurieren, dass sie bei der Bereitstellung in einem AWS IoT Core MQTT-Thema veröffentlicht wird. Die Verwendung eines MQTT-Themas zur Veröffentlichung von Daten auf dem AWS Cloud unterliegt AWS IoT Core der Preisgestaltung.

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 der Nucleusemitter-Komponente. Weitere Informationen finden Sie in der README-Datei für die InfluxDB-Publisher-Komponente.

Versionen

Diese Komponente hat die folgenden Versionen:

Typ

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

Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Nucleus. Weitere Informationen finden Sie unter AWS IoT Greengrass Protokolle überwachen.

Weitere Informationen finden Sie unter Komponententypen.

Betriebssystem

Abhängigkeiten

Wenn Sie eine Komponente bereitstellen, werden AWS IoT Greengrass auch kompatible Versionen ihrer Abhängigkeiten bereitgestellt. Das bedeutet, dass Sie die Anforderungen für die Komponente und alle ihre Abhängigkeiten erfüllen müssen, um die Komponente erfolgreich bereitzustellen. 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 die Abhängigkeiten für jede Version der Komponente auch 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 Komponentenrezeptreferenz.

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 Telemetriemetriken 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 Themen finden Sie unter MQTT-Themen 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 Nucleus-Emitter veröffentlicht die folgenden Metriken:

Usage

Um Telemetriedaten zum Systemstatus 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 Nucleus-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 Hauptgerät zu agieren. Das Kerngerät kann dann auf Telemetriedaten reagieren, auch wenn es nur über eine eingeschränkte Konnektivität zur Cloud verfügt.

Sie können beispielsweise eine Komponente konfigurieren, die beim $local/greengrass/telemetry Thema auf Telemetriedaten wartet, und die Daten an die Stream-Manager-Komponente senden, um Ihre Daten an die zu streamen. AWS Cloud Weitere Informationen 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.