Telemetrie-Emitter

Die Kerntelemetrie-Emitterkomponente (aws.greengrass.telemetry.NucleusEmitter) sammelt Telemetriedaten zum Systemzustand und veröffentlicht sie kontinuierlich in einem lokalen Thema und einem AWS IoT Core MQTT-Thema. Mit dieser Komponente können Sie Echtzeit-Systemtelemetrie auf Ihren Greengrass-Core-Geräten erfassen. Informationen zum Greengrass-Telemetrieagenten, der Systemtelemetriedaten in Amazon veröffentlicht EventBridge, finden Sie unter Erfassen von Telemetriedaten zum Systemstatus von -AWS IoT GreengrassCore-Geräten.

Standardmäßig veröffentlicht die Komponente des Telemetrie-Emitters alle 60 Sekunden Telemetriedaten im folgenden lokalen Veröffentlichungs-/Abonnementthema.

$local/greengrass/telemetry

Die Kerntelemetrie-Emitterkomponente veröffentlicht standardmäßig nicht zu 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. Die Verwendung eines MQTT-Themas zum Veröffentlichen von Daten in der AWS Cloud unterliegt den AWS IoT Core Preisen .

AWS IoT Greengrass bietet mehrere Community-Komponenten, mit denen Sie Telemetriedaten mithilfe von InfluxDB und Grafana lokal auf Ihrem Core-Gerät analysieren und visualisieren können. Diese Komponenten verwenden Telemetriedaten aus der Kern-Emitterkomponente. Weitere Informationen finden Sie in der README für die Herausgeberkomponente von InfluxDB.

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 Kern aus. Der Kern 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 AWS IoT Greengrass auch kompatible Versionen ihrer Abhängigkeiten bereit. 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 und 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 Abhängigkeiten.

Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zum Komponentenrezept .

Konfiguration

Diese Komponente bietet die folgenden Konfigurationsparameter, die Sie anpassen können, wenn Sie die Komponente bereitstellen.

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

Ausgabedaten

Diese Komponente veröffentlicht Telemetriemetriken als JSON-Array im folgenden Thema.

Lokales Thema: $local/greengrass/telemetry

Optional können Sie auch Telemetriemetriken in 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 Kern-Emitter veröffentlicht die folgenden Metriken:

Verwendung

Um Telemetriedaten des Systemzustands zu verwenden, können Sie benutzerdefinierte Komponenten erstellen, die die Themen abonnieren, zu denen der Kern-Emitter die Telemetriedaten veröffentlicht, und bei Bedarf auf diese Daten reagieren. Da die Kern-Emitter-Komponente die Möglichkeit bietet, Telemetriedaten in einem lokalen Thema zu veröffentlichen, können Sie dieses Thema abonnieren und die veröffentlichten Daten verwenden, um lokal auf Ihrem Core-Gerät zu handeln. Das Core-Gerät kann dann auf Telemetriedaten reagieren, auch wenn es über eine eingeschränkte 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 streamenAWS Cloud. Weitere Informationen zum Erstellen einer solchen Komponente finden Sie unter Lokale Nachrichten veröffentlichen/abonnieren und Erstellen Sie benutzerdefinierte Komponenten, die Stream Manager verwenden.

Lokale Protokolldatei

Diese Komponente verwendet dieselbe Protokolldatei wie die Greengrass-Kernkomponente.

Änderungsprotokoll

In der folgenden Tabelle werden die Änderungen in jeder Version der Komponente beschrieben.