Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Nucleus-Telemetrie-Sender
<a name="nucleus-emitter-component"></a>

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 MQTT-Thema. AWS IoT Core 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. [Erfassung von Telemetriedaten zur Systemintegrität von AWS IoT Greengrass Kerngeräten](telemetry.md)

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-Topics zur Veröffentlichung von Daten in der AWS Cloud ist kostenpflichtig AWS IoT Core .](https://aws.amazon.com/iot-core/pricing/)

<a name="greengrass-software-catalog-influxdb-telemetry-publisher"></a>AWS IoT Greengrass bietet mehrere [Community-Komponenten](greengrass-software-catalog.md), 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-Datei für die InfluxDB-Publisher-Komponente.](https://github.com/awslabs/aws-greengrass-labs-telemetry-influxdbpublisher)

**Topics**
+ [Versionen](#nucleus-emitter-component-versions)
+ [Typ](#nucleus-emitter-component-type)
+ [Betriebssystem](#nucleus-emitter-component-os-support)
+ [Abhängigkeiten](#nucleus-emitter-component-dependencies)
+ [Konfiguration](#nucleus-emitter-component-configuration)
+ [Ausgabedaten](#nucleus-emitter-component-output-data)
+ [Usage](#nucleus-emitter-component-usage)
+ [Lokale Protokolldatei](#nucleus-emitter-component-log-file)
+ [Änderungsprotokoll](#nucleus-emitter-component-changelog)

## Versionen
<a name="nucleus-emitter-component-versions"></a>

Diese Komponente hat die folgenden Versionen:
+ 1.0.x

## Typ
<a name="nucleus-emitter-component-type"></a>

<a name="public-component-type-plugin-para1"></a>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](greengrass-nucleus-component.md) aus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Core-Gerät ändern.

<a name="public-component-type-plugin-para2"></a>Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Kern. Weitere Informationen finden Sie unter [AWS IoT Greengrass Protokolle überwachen](monitor-logs.md).

<a name="public-component-type-more-information"></a>Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).

## Betriebssystem
<a name="nucleus-emitter-component-os-support"></a>

Diese Komponente kann auf Kerngeräten installiert werden, auf denen die folgenden Betriebssysteme ausgeführt werden:
+ Linux
+ Windows

## Abhängigkeiten
<a name="nucleus-emitter-component-dependencies"></a>

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](#nucleus-emitter-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.

------
#### [ 1.0.12 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.12 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,4,0 <2,17,0 | Weich | 

------
#### [ 1.0.11 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.11 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) |  >=2,4,0 <2,16,0  | Hart | 

------
#### [ 1.0.10 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.10 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) |  >=2,4,0 <2,15,0  | Hart | 

------
#### [ 1.0.9 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.9 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) |  >=2.4.0 <2.14.0  | Hart | 

------
#### [ 1.0.8 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.8 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) |  >=2,4,0 <2,13,0  | Hart | 

------
#### [ 1.0.7 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.7 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) |  >=2.4.0 <2.12.0  | Hart | 

------
#### [ 1.0.6 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.6 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) |  >=2.4.0 <2.11.0  | Hart | 

------
#### [ 1.0.5 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.5 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) |  >=2.4.0 <2.10.0  | Hart | 

------
#### [ 1.0.4 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.4 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) |  >=2,4,0 <2,9,0  | Hart | 

------
#### [ 1.0.3 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.3 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) |  >=2,4,0 <2,8,0  | Hart | 

------
#### [ 1.0.2 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.2 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) |  >=2,4,0 <2,7,0  | Hart | 

------
#### [ 1.0.1 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.1 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) |  >=2,4,0 <2,6,0  | Hart | 

------
#### [ 1.0.0 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.0 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) |  >=2,4,0 <2,5,0  | Hart | 

------

[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Konfiguration
<a name="nucleus-emitter-component-configuration"></a>

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

`pubSubPublish`  
(Optional) Definiert, ob Telemetriedaten zum `$local/greengrass/telemetry` Thema veröffentlicht werden sollen. Unterstützte Werte sind `true` und `false`.  
Standard: `true`

`mqttTopic`  
(Optional) Das AWS IoT Core MQTT-Thema, zu dem diese Komponente Telemetriedaten veröffentlicht.  
Setzen Sie diesen Wert auf das AWS IoT Core MQTT-Thema, in dem Sie Telemetriedaten veröffentlichen möchten. Wenn dieser Wert leer ist, veröffentlicht der Nucle-Emitter keine Telemetriedaten auf dem. AWS Cloud  
[Die Verwendung eines MQTT-Themas zur Veröffentlichung von Daten auf der AWS Cloud ist kostenpflichtig.AWS IoT Core](https://aws.amazon.com/iot-core/pricing/)
Standard: `""`

`telemetryPublishIntervalMs`  
(Optional) Der Zeitraum (in Millisekunden), zwischen dem die Komponente Telemetriedaten veröffentlicht. Wenn Sie diesen Wert niedriger als den unterstützten Mindestwert festlegen, verwendet die Komponente stattdessen den Mindestwert.  
Niedrigere Veröffentlichungsintervalle führen zu einer höheren CPU-Auslastung auf Ihrem Kerngerät. Wir empfehlen, mit dem Standard-Veröffentlichungsintervall zu beginnen und es an die CPU-Auslastung Ihres Geräts anzupassen.
Minimum: `500`  
Standard: `60000`

**Example Beispiel: Aktualisierung zur Zusammenführung von Konfigurationen**  
Das folgende Beispiel zeigt ein Beispiel für ein Update zur Zusammenführung von Konfigurationen, das die Veröffentlichung von Telemetriedaten für das `$local/greengrass/telemetry` Thema und das `greengrass/myTelemetry` AWS IoT Core MQTT-Thema alle 5 Sekunden ermöglicht.  

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

## Ausgabedaten
<a name="nucleus-emitter-component-output-data"></a>

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

**Lokales Thema:** `$local/greengrass/telemetry`

Sie können sich optional dafür entscheiden, auch Telemetrie-Metriken zu einem AWS IoT Core MQTT-Thema zu veröffentlichen. *Weitere Informationen zu den Themen finden Sie unter [MQTT-Themen im AWS IoT Core Developer](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) Guide.*

**Example Beispiel für Daten**  

```
[
  {
    "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
  }
]
```<a name="telemetry-json-array-config"></a>

Das Ausgabe-Array enthält eine Liste von Metriken mit den folgenden Eigenschaften:

`A`  
Der Aggregationstyp für die Metrik.   
Für die `CpuUsage` Metrik ist diese Eigenschaft auf gesetzt, `Average` da der veröffentlichte Wert der Metrik der durchschnittlichen CPU-Auslastung seit dem letzten Veröffentlichungsereignis entspricht.  
Bei allen anderen Metriken aggregiert der Nucleus-Emitter den Metrikwert nicht, und diese Eigenschaft ist auf `Count` gesetzt.

`N`  
Name der Metrik.

`NS`  
Metrik-Namespace

`TS`  
Der Zeitstempel, zu dem die Daten erfasst wurden.

`U`  
Die Einheit des metrischen Werts.

`V`  
Der -Metrikwert 

Der Nukleus-Emitter veröffentlicht die folgenden Metriken:


| Name | Description | 
| --- | --- | 
|  **System (System)**  | 
|  `SystemMemUsage`  |  Die Menge an Speicher, die derzeit von allen Anwendungen auf dem Greengrass-Core-Gerät verwendet wird, einschließlich des Betriebssystems.  | 
|  `CpuUsage`  |  Die Menge an CPU, die derzeit von allen Anwendungen auf dem Greengrass-Core-Gerät verwendet wird, einschließlich des Betriebssystems.  | 
|  `TotalNumberOfFDs`  |  Die Anzahl der Dateideskriptoren, die vom Betriebssystem des Greengrass-Core-Geräts gespeichert werden. Ein Dateideskriptor identifiziert eindeutig eine geöffnete Datei.  | 
|  **Grüngraskern**  | 
|  `NumberOfComponentsRunning`  |  Die Anzahl der Komponenten, die auf dem Greengrass-Core-Gerät ausgeführt werden.  | 
|  `NumberOfComponentsErrored`  |  Die Anzahl der Komponenten, die sich auf dem Greengrass-Core-Gerät im Fehlerstatus befinden.  | 
|  `NumberOfComponentsInstalled`  |  Die Anzahl der Komponenten, die auf dem Greengrass-Core-Gerät installiert sind.  | 
|  `NumberOfComponentsStarting`  |  Die Anzahl der Komponenten, die auf dem Greengrass-Core-Gerät gestartet werden.  | 
|  `NumberOfComponentsNew`  |  Die Anzahl der Komponenten, die auf dem Greengrass-Core-Gerät neu sind.  | 
|  `NumberOfComponentsStopping`  |  Die Anzahl der Komponenten, die auf dem Greengrass-Core-Gerät gestoppt werden.  | 
|  `NumberOfComponentsFinished`  |  Die Anzahl der Komponenten, die auf dem Greengrass-Core-Gerät fertiggestellt wurden.  | 
|  `NumberOfComponentsBroken`  |  Die Anzahl der Komponenten, die auf dem Greengrass-Core-Gerät defekt sind.  | 
|  `NumberOfComponentsStateless`  |  Die Anzahl der Komponenten, die auf dem Greengrass-Core-Gerät zustandslos sind.  | 

## Usage
<a name="nucleus-emitter-component-usage"></a>

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](ipc-publish-subscribe.md) und. [Erstellen Sie benutzerdefinierte Komponenten, die den Stream-Manager verwenden](use-stream-manager-in-custom-components.md)

## Lokale Protokolldatei
<a name="nucleus-emitter-component-log-file"></a>

Diese Komponente verwendet dieselbe Protokolldatei wie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Um die Protokolle dieser Komponente einzusehen**
+ Führen Sie den folgenden Befehl auf dem Kerngerät aus, um die Protokolldatei dieser Komponente in Echtzeit anzuzeigen. Ersetzen Sie `/greengrass/v2` oder *C:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Änderungsprotokoll
<a name="nucleus-emitter-component-changelog"></a>

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


|  **Version**  |  **Änderungen**  | 
| --- | --- | 
|  1.0.13  |  Aktualisiert die Komponentenversion für die Version 2.17.0 von Greengrass Nucleus.  | 
|  1.0.12  |  Die Version wurde für die Version 2.16.0 von Greengrass Nucleus aktualisiert.  | 
|  1.0.11  | Die Version wurde für die Version 2.15.0 von Greengrass Nucleus aktualisiert. | 
|  1.0.10  | Die Version wurde für die Version 2.14.0 von Greengrass Nucleus aktualisiert. | 
|  1.0.9  | Die Version wurde für die Version 2.13.0 von Greengrass Nucleus aktualisiert. | 
|  1.0.8  | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. | 
|  1.0.7  | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. | 
|  1.0.6  | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. | 
|  1.0.5  | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. | 
|  1.0.4  | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. | 
|  1.0.3  |  Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert.  | 
|  1.0.2  |  Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert.  | 
|  1.0.1  |  Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert.  | 
|  1.0.0  |  Erste Version  |