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. # Erfassung von Telemetriedaten zur Systemintegrität von AWS IoT Greengrass Kerngeräten Telemetriedaten zur Systemintegrität sind Diagnosedaten, die Ihnen helfen können, die Leistung kritischer Operationen auf Ihren Greengrass-Kerngeräten zu überwachen. Sie können Projekte und Anwendungen erstellen, um Telemetriedaten von Ihren Edge-Geräten abzurufen, zu analysieren, zu transformieren und zu melden. Branchenexperten, wie z. B. Verfahrenstechniker, können diese Anwendungen nutzen, um Einblicke in den Zustand der Flotte zu gewinnen. Sie können die folgenden Methoden verwenden, um Telemetriedaten von Ihren Greengrass-Core-Geräten zu sammeln: + **Nucleus-Telemetrie-Emitter-Komponente** — Die [Nucleus-Telemetrie-Emitter-Komponente](nucleus-emitter-component.md) (`aws.greengrass.telemetry.NucleusEmitter`) auf einem Greengrass-Core-Gerät veröffentlicht standardmäßig Telemetriedaten zum Thema. `$local/greengrass/telemetry` Sie können die zu diesem Thema veröffentlichten Daten verwenden, um lokal auf Ihrem Core-Gerät zu agieren, auch wenn Ihr Gerät nur über eingeschränkte Konnektivität zur Cloud verfügt. Optional können Sie die Komponente auch so konfigurieren, dass Telemetriedaten in einem AWS IoT Core MQTT-Thema Ihrer Wahl veröffentlicht werden. Sie müssen die Nucle-Emitter-Komponente auf einem Kerngerät bereitstellen, um Telemetriedaten zu veröffentlichen. Mit der Veröffentlichung von Telemetriedaten zum lokalen Thema sind keine Kosten verbunden. [Die Verwendung eines MQTT-Themas zur Veröffentlichung von Daten im AWS Cloud ist jedoch kostenpflichtig.AWS IoT Core](https://aws.amazon.com/iot-core/pricing/) 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) + **Telemetrieagent** — Der Telemetrieagent auf Greengrass-Core-Geräten sammelt lokale Telemetriedaten und veröffentlicht sie an Amazon, EventBridge ohne dass eine Kundeninteraktion erforderlich ist. Kerngeräte veröffentlichen Telemetriedaten nach EventBridge bestem Wissen und Gewissen. Beispielsweise können Core-Geräte Telemetriedaten möglicherweise nicht liefern, wenn sie offline sind. Die Telemetrie-Agent-Funktion ist standardmäßig für alle Greengrass-Core-Geräte aktiviert. Sie beginnen automatisch mit dem Empfang von Daten, sobald Sie ein Greengrass-Core-Gerät eingerichtet haben. Abgesehen von den Kosten für die Datenverbindung AWS IoT Core ist die Datenübertragung vom Kerngerät zum Gerät kostenlos. Das liegt daran, dass der Agent zu einem AWS reservierten Thema veröffentlicht. Abhängig von Ihrem Anwendungsfall können jedoch Kosten anfallen, wenn Sie die Daten erhalten oder verarbeiten. **Anmerkung** Amazon EventBridge ist ein Eventbus-Service, mit dem Sie Ihre Anwendungen mit Daten aus einer Vielzahl von Quellen verbinden können, z. B. mit Greengrass-Kerngeräten. Weitere Informationen finden Sie unter [Was ist Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) im * EventBridge Amazon-Benutzerhandbuch*. Um sicherzustellen, dass die AWS IoT Greengrass Core-Software ordnungsgemäß funktioniert, werden die Daten für Entwicklungs- und Qualitätsverbesserungszwecke AWS IoT Greengrass verwendet. Diese Funktion hilft auch bei der Entwicklung neuer und verbesserter Edge-Funktionen. AWS IoT Greengrass speichert Telemetriedaten für bis zu sieben Tage. In diesem Abschnitt wird beschrieben, wie der Telemetrieagent konfiguriert und verwendet wird. Informationen zur Konfiguration der Nucleus-Telemetrie-Emitter-Komponente finden Sie unter. [Nucleus-Telemetrie-Sender](nucleus-emitter-component.md) **Topics** + [Telemetrie-Metriken](#telemetry-metrics) + [Konfigurieren Sie die Einstellungen des Telemetrie-Agents](#configure-telemetry-agent-settings) + [Abonnieren Sie Telemetriedaten in EventBridge](#subscribe-for-telemetry-data) ## Telemetrie-Metriken In der folgenden Tabelle werden die Metriken beschrieben, die vom Telemetrieagent veröffentlicht werden. | 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. | | **Authentifizierung auf Clientgeräten** — Für diese Funktion ist Version 2.4.0 oder höher der Authentifizierungskomponente für das Clientgerät erforderlich. | | `VerifyClientDeviceIdentity.Success` | Gibt an, wie oft überprüft wurde, ob die Identität des Client-Geräts erfolgreich war. | | `VerifyClientDeviceIdentity.Failure` | Gibt an, wie oft bei der Überprüfung, ob die Identität des Client-Geräts fehlgeschlagen ist, fehlgeschlagen ist. | | `AuthorizeClientDeviceActions.Success` | Gibt an, wie oft das Client-Gerät autorisiert wurde, angeforderte Aktionen auszuführen. | | `AuthorizeClientDeviceActions.Failure` | Gibt an, wie oft das Client-Gerät nicht autorisiert ist, angeforderte Aktionen auszuführen. | | `GetClientDeviceAuthToken.Success` | Gibt an, wie oft das Client-Gerät erfolgreich authentifiziert wurde. | | `GetClientDeviceAuthToken.Failure` | Gibt an, wie oft das Client-Gerät nicht authentifiziert werden kann. | | `SubscribeToCertificateUpdates.Success` | Die Anzahl der erfolgreichen Abonnements für Zertifikatsupdates. | | `SubscribeToCertificateUpdates.Failure` | Die Anzahl der erfolglosen Versuche, Zertifikatsaktualisierungen zu abonnieren. | | `ServiceError` | Die Anzahl der unbehandelten internen Fehler bei der Authentifizierung auf dem Client-Gerät. | | **Stream-Manager** — Für diese Funktion ist Version 2.7.0 oder höher der Greengrass Nucleus-Komponente erforderlich. | | `BytesAppended` | Die Anzahl der Datenbytes, die an den Stream-Manager angehängt wurden. | | `BytesUploadedToIoTAnalytics` | Die Anzahl der Datenbytes, die der Stream-Manager in AWS IoT Analytics Kanäle exportiert. | | `BytesUploadedToKinesis` | Die Anzahl der Datenbytes, die Stream Manager in Streams in Amazon Kinesis Data Streams exportiert. | | `BytesUploadedToIoTSiteWise` | Die Anzahl der Datenbytes, in die Stream Manager in AWS IoT SiteWise Asset-Eigenschaften exportiert. | | `BytesUploadedToS3` | Die Anzahl der Datenbytes, die der Stream-Manager in Objekte in Amazon S3 exportiert. | | **Systemmetriken** — Für diese Funktion ist Version 2.15.0 oder höher der Greengrass Nucleus-Komponente erforderlich. | | `CPUArchitecture` | Architektur der Zentraleinheit des Geräts. | | `Family` | Gerätebetriebssystemfamilie (nur Windows). | | `KernelVersion` | Version des Gerätekernels (nur Unix). | | `KnowledgeBaseArticles` | Knowledge Base-Artikel, die auf einem Gerät installiert sind (nur Windows). | | `OSBuildMajor` | Haupt-Buildnummer der Betriebssystemversion (nur Windows). | | `OSBuildMinor` | Untergeordnete Buildnummer der Betriebssystemversion (nur Windows). | | `OSName` | Name des Betriebssystems des Geräts. | | `OSVersion` | Marketingversion des Gerätebetriebssystems. | ## Konfigurieren Sie die Einstellungen des Telemetrie-Agents Der Telemetrieagent verwendet die folgenden Standardeinstellungen: + Der Telemetrieagent aggregiert jede Stunde Telemetriedaten. + Der Telemetrieagent veröffentlicht alle 24 Stunden eine Telemetriemeldung. Der Telemetrieagent veröffentlicht Daten mithilfe des MQTT-Protokolls mit einer QoS-Stufe (Quality of Service) von 0, was bedeutet, dass er weder die Zustellung bestätigt noch versucht, die Veröffentlichung zu wiederholen. Telemetrienachrichten teilen sich eine MQTT-Verbindung mit anderen Nachrichten für Abonnements, die dafür bestimmt sind. AWS IoT Core Abgesehen von den Kosten für die Datenverbindung AWS IoT Core ist der Datentransfer vom Core zum Core kostenlos. Das liegt daran, dass der Agent zu einem AWS reservierten Thema veröffentlicht. Abhängig von Ihrem Anwendungsfall können jedoch Kosten anfallen, wenn Sie die Daten erhalten oder verarbeiten. Sie können die Telemetrie-Agent-Funktion für jedes Greengrass Core-Gerät aktivieren oder deaktivieren. Sie können auch die Intervalle konfigurieren, in denen das Kerngerät Daten aggregiert und veröffentlicht. Um Telemetrie zu konfigurieren, passen Sie den [Telemetriekonfigurationsparameter](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-telemetry) an, wenn Sie die [Greengrass](greengrass-nucleus-component.md) Nucleus-Komponente bereitstellen. ## Abonnieren Sie Telemetriedaten in EventBridge Sie können in Amazon Regeln erstellen EventBridge , die definieren, wie Telemetriedaten verarbeitet werden, die vom Telemetrie-Agenten auf dem Greengrass-Core-Gerät veröffentlicht wurden. Wenn es die Daten EventBridge empfängt, ruft es die in Ihren Regeln definierten Zielaktionen auf. Sie können beispielsweise Ereignisregeln erstellen, die Benachrichtigungen senden, Ereignisinformationen speichern, Korrekturmaßnahmen ergreifen oder andere Ereignisse auslösen. ### Telemetrieereignisse Telemetrieereignisse verwenden das folgende Format. ``` { "version": "0", "id": "a09d303e-2f6e-3d3c-a693-8e33f4fe3955", "detail-type": "Greengrass Telemetry Data", "source": "aws.greengrass", "account": "123456789012", "time": "2020-11-30T20:45:53Z", "region": "us-east-1", "resources": [], "detail": { "ThingName": "MyGreengrassCore", "Schema": "2020-07-30", "ADP": [ { "TS": 1602186483234, "NS": "SystemMetrics", "M": [ { "N": "TotalNumberOfFDs", "Sum": 6447.0, "U": "Count" }, { "N": "CpuUsage", "Sum": 15.458333333333332, "U": "Percent" }, { "N": "SystemMemUsage", "Sum": 10201.0, "U": "Megabytes" } ] }, { "TS": 1602186483234, "NS": "GreengrassComponents", "M": [ { "N": "NumberOfComponentsStopping", "Sum": 0.0, "U": "Count" }, { "N": "NumberOfComponentsStarting", "Sum": 0.0, "U": "Count" }, { "N": "NumberOfComponentsBroken", "Sum": 0.0, "U": "Count" }, { "N": "NumberOfComponentsFinished", "Sum": 1.0, "U": "Count" }, { "N": "NumberOfComponentsInstalled", "Sum": 0.0, "U": "Count" }, { "N": "NumberOfComponentsRunning", "Sum": 7.0, "U": "Count" }, { "N": "NumberOfComponentsNew", "Sum": 0.0, "U": "Count" }, { "N": "NumberOfComponentsErrored", "Sum": 0.0, "U": "Count" }, { "N": "NumberOfComponentsStateless", "Sum": 0.0, "U": "Count" } ] }, { "TS": 1602186483234, "NS": "aws.greengrass.ClientDeviceAuth", "M": [ { "N": "VerifyClientDeviceIdentity.Success", "Sum": 3.0, "U": "Count" }, { "N": "VerifyClientDeviceIdentity.Failure", "Sum": 1.0, "U": "Count" }, { "N": "AuthorizeClientDeviceActions.Success", "Sum": 20.0, "U": "Count" }, { "N": "AuthorizeClientDeviceActions.Failure", "Sum": 5.0, "U": "Count" }, { "N": "GetClientDeviceAuthToken.Success", "Sum": 5.0, "U": "Count" }, { "N": "GetClientDeviceAuthToken.Failure", "Sum": 2.0, "U": "Count" }, { "N": "SubscribeToCertificateUpdates.Success", "Sum": 10.0, "U": "Count" }, { "N": "SubscribeToCertificateUpdates.Failure", "Sum": 1.0, "U": "Count" }, { "N": "ServiceError", "Sum": 3.0, "U": "Count" } ] }, { "TS": 1602186483234, "NS": "aws.greengrass.StreamManager", "M": [ { "N": "BytesAppended", "Sum": 157745524.0, "U": "Bytes" }, { "N": "BytesUploadedToIoTAnalytics", "Sum": 149012.0, "U": "Bytes" }, { "N": "BytesUploadedToKinesis", "Sum": 12192.0, "U": "Bytes" }, { "N": "BytesUploadedToIoTSiteWise", "Sum": 13321.0, "U": "Bytes" }, { "N": "BytesUploadedToS3", "Sum": 12213.0, "U": "Bytes" } ] } { "TS": 1750104449426, "NS": "SystemMetrics", "M": [ { "N": "KernelVersion", "Sum": 1, "U": "6.1.140-154.222.amzn2023.x86_64" }, { "N": "OSVersion", "Sum": 1, "U": "2023.7.20250609" }, { "N": "OSName", "Sum": 1, "U": "Amazon Linux" }, { "N": "CPUArchitecture", "Sum": 1, "U": "Broadwell (Server)" }, ] } ] } } ``` Das `ADP` Array enthält eine Liste von aggregierten Datenpunkten mit den folgenden Eigenschaften: `TS` Der Zeitstempel, zu dem die Daten gesammelt wurden. `NS` Metrik-Namespace `M` Die Liste der Metriken. Eine Metrik enthält die folgenden Eigenschaften: `N` Name der Metrik. `Sum` Die Summe der Werte der Metrik in diesem Telemetrieereignis. `U` Die Einheit des metrischen Werts. Weitere Informationen zu den jeweiligen Metriken finden Sie unter [Telemetrie-Metriken](#telemetry-metrics). ### Voraussetzungen für die Erstellung von EventBridge Regeln Bevor Sie eine EventBridge Regel für erstellen AWS IoT Greengrass, sollten Sie Folgendes tun: + Machen Sie sich mit Ereignissen, Regeln und Zielen in vertraut EventBridge. + Erstellen und konfigurieren Sie die [Ziele](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-targets.html), die durch Ihre EventBridge Regeln aufgerufen werden. Regeln können viele Arten von Zielen aufrufen, z. B. Amazon Kinesis Kinesis-Streams, AWS Lambda Funktionen, Amazon SNS SNS-Themen und Amazon SQS SQS-Warteschlangen. Ihre EventBridge Regel und die zugehörigen Ziele müssen sich dort befinden, AWS-Region wo Sie Ihre Greengrass-Ressourcen erstellt haben. Weitere Informationen finden Sie unter [Dienstendpunkte und Kontingente](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html) in der. *Allgemeine AWS-Referenz* Weitere Informationen finden Sie unter [Was ist Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) und [Erste Schritte mit Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-getting-set-up.html) im * EventBridge Amazon-Benutzerhandbuch*. ### Erstellen Sie eine Ereignisregel zum Abrufen von Telemetriedaten (Konsole) Verwenden Sie die folgenden Schritte, um mithilfe der eine EventBridge Regel AWS-Managementkonsole zu erstellen, die vom Greengrass-Core-Gerät veröffentlichte Telemetriedaten empfängt. Auf diese Weise können Webserver, E-Mail-Adressen und andere Themenabonnenten auf das Ereignis reagieren. Weitere Informationen finden Sie im * EventBridge Amazon-Benutzerhandbuch* unter [Erstellen einer EventBridge Regel, die bei einem Ereignis von einer AWS Ressource ausgelöst](https://docs.aws.amazon.com/eventbridge/latest/userguide/create-eventbridge-rule.html) wird. 1. Öffnen Sie die [ EventBridgeAmazon-Konsole](https://console.aws.amazon.com/events/) und wählen Sie **Regel erstellen**. 1. Geben Sie unter **Name and description (Name und Beschreibung)** einen Namen und eine Beschreibung für die Regel ein. 1. Konfigurieren Sie unter **Define pattern (Muster definieren)** das Regelmuster. 1. Wählen Sie **Event pattern (Ereignismuster)** aus. 1. Wählen Sie **Pre-defined pattern by service (Vordefiniertes Muster nach Service)**aus. 1. Wählen Sie für **Service provider** (Serviceanbieter) die Option **AWS** aus. 1. Wählen Sie für **Service-Name** die Option **Greengrass**aus. 1. Wählen Sie als **Ereignistyp** **Greengrass Telemetry Data** aus. 1. Behalten Sie unter **Select event bus (Ereignisbus auswählen)** die standardmäßigen Ereignisbusoptionen bei. 1. Konfigurieren Sie unter **Select targets (Ziele auswählen)** das Ziel. Das folgende Beispiel verwendet eine Amazon SQS SQS-Warteschlange, Sie können jedoch auch andere Zieltypen konfigurieren. 1. Wählen Sie für **Target** die Option **SQS-Warteschlange** aus. 1. Wählen Sie für **Queue\$1** Ihre Zielwarteschlange aus. 1. Definieren Sie unter **Tags - optional** Tags für die Regel oder lassen Sie die Felder leer. 1. Wählen Sie **Erstellen** aus. ### Erstellen Sie eine Ereignisregel zum Abrufen von Telemetriedaten (CLI) Verwenden Sie die folgenden Schritte, um mithilfe der eine EventBridge Regel AWS CLI zu erstellen, die Telemetriedaten empfängt, die von Greengrass-Core-Geräten veröffentlicht wurden. Auf diese Weise können Webserver, E-Mail-Adressen und andere Themenabonnenten auf das Ereignis reagieren. 1. Erstellen Sie die Regel. + *thing-name*Ersetzen Sie es durch den Dingnamen des Kerngeräts. ------ #### [ Linux or Unix ] ``` aws events put-rule \ --name MyGreengrassTelemetryEventRule \ --event-pattern "{\"source\": [\"aws.greengrass\"], \"detail\": {\"ThingName\": [\"thing-name\"]}}" ``` ------ #### [ Windows Command Prompt (CMD) ] ``` aws events put-rule ^ --name MyGreengrassTelemetryEventRule ^ --event-pattern "{\"source\": [\"aws.greengrass\"], \"detail\": {\"ThingName\": [\"thing-name\"]}}" ``` ------ #### [ PowerShell ] ``` aws events put-rule ` --name MyGreengrassTelemetryEventRule ` --event-pattern "{\"source\": [\"aws.greengrass\"], \"detail\": {\"ThingName\": [\"thing-name\"]}}" ``` ------ Eigenschaften, die aus dem Muster weggelassen werden, werden ignoriert. 1. Fügen Sie das Thema als Regelziel hinzu. Im folgenden Beispiel wird Amazon SQS verwendet, Sie können jedoch auch andere Zieltypen konfigurieren. + *queue-arn*Ersetzen Sie es durch den ARN Ihrer Amazon SQS SQS-Warteschlange. ------ #### [ Linux or Unix ] ``` aws events put-targets \ --rule MyGreengrassTelemetryEventRule \ --targets "Id"="1","Arn"="queue-arn" ``` ------ #### [ Windows Command Prompt (CMD) ] ``` aws events put-targets ^ --rule MyGreengrassTelemetryEventRule ^ --targets "Id"="1","Arn"="queue-arn" ``` ------ #### [ PowerShell ] ``` aws events put-targets ` --rule MyGreengrassTelemetryEventRule ` --targets "Id"="1","Arn"="queue-arn" ``` ------ **Anmerkung** Damit Amazon EventBridge Ihre Zielwarteschlange aufrufen kann, müssen Sie Ihrem Thema eine ressourcenbasierte Richtlinie hinzufügen. Weitere Informationen finden Sie unter [Amazon SQS SQS-Berechtigungen](https://docs.aws.amazon.com/eventbridge/latest/userguide/resource-based-policies-eventbridge.html#sqs-permissions) im * EventBridge Amazon-Benutzerhandbuch*. Weitere Informationen finden Sie unter [Ereignisse und Ereignismuster EventBridge im EventBridge ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html) *Amazon-Benutzerhandbuch*.