CloudWatch -Metriken - AWS IoT Greengrass

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.

CloudWatch -Metriken

Die Amazon- CloudWatch Metrikkomponente (aws.greengrass.Cloudwatch) veröffentlicht benutzerdefinierte Metriken von Greengrass-Core-Geräten in Amazon CloudWatch. Die Komponente ermöglicht es Komponenten, CloudWatch Metriken zu veröffentlichen, mit denen Sie die Umgebung des Greengrass-Kerngeräts überwachen und analysieren können. Weitere Informationen finden Sie unter Verwenden von Amazon CloudWatch-Metriken im Amazon- CloudWatch Benutzerhandbuch.

Um eine CloudWatch Metrik mit dieser Komponente zu veröffentlichen, veröffentlichen Sie eine Nachricht in einem Thema, in dem diese Komponente abonniert wird. Standardmäßig abonniert diese Komponente das cloudwatch/metric/put lokale Veröffentlichungs-/Abonnementthema. Sie können bei der Bereitstellung dieser Komponente andere Themen angeben, einschließlich AWS IoT Core MQTT-Themen.

Diese Komponente stapelt Metriken, die sich im selben Namespace befinden, und veröffentlicht sie CloudWatch in regelmäßigen Abständen in .

Anmerkung

Diese Komponente bietet ähnliche Funktionen wie der CloudWatch Metrik-Konnektor in AWS IoT Greengrass V1. Weitere Informationen finden Sie unter CloudWatch Metrics Connector im AWS IoT Greengrass V1-Entwicklerhandbuch.

Versionen

Diese Komponente hat die folgenden Versionen:

  • 3.1.x

  • 3.0.x

  • 2.1.x

  • 2.0.x

Informationen zu Änderungen in jeder Version der Komponente finden Sie im Änderungsprotokoll .

Typ

v3.x

Diese Komponente ist eine generische Komponente (aws.greengrass.generic). Der Greengrass-Kern führt die Lebenszyklusskripte der Komponente aus.

v2.x

Diese Komponente ist eine Lambda-Komponente (aws.greengrass.lambda). Der Greengrass-Kern führt die Lambda-Funktion dieser Komponente mit der Lambda-Launcher-Komponente aus.

Weitere Informationen finden Sie unter Komponententypen.

Betriebssystem

v3.x

Diese Komponente kann auf -Core-Geräten installiert werden, auf denen die folgenden Betriebssysteme ausgeführt werden:

  • Linux

  • Windows

v2.x

Diese Komponente kann nur auf Linux-Core-Geräten installiert werden.

Voraussetzungen

Für diese Komponente gelten die folgenden Anforderungen:

3.x
  • Python Version 3.7 ist auf dem Core-Gerät installiert und der PATH-Umgebungsvariablen hinzugefügt.

  • Die Greengrass-Geräterolle muss die cloudwatch:PutMetricData Aktion zulassen, wie in der folgenden Beispiel-IAM-Richtlinie gezeigt.

    { "Version": "2012-10-17", "Statement": [ { "Action": [ "cloudwatch:PutMetricData" ], "Effect": "Allow", "Resource": "*" } ] }

    Weitere Informationen finden Sie in der Amazon CloudWatch-Berechtigungsreferenz im Amazon- CloudWatch Benutzerhandbuch.

2.x
  • Ihr Core-Gerät muss die Anforderungen erfüllen, um Lambda-Funktionen auszuführen. Wenn Sie möchten, dass das Core-Gerät containerisierte Lambda-Funktionen ausführt, muss das Gerät die Voraussetzungen dafür erfüllen. Weitere Informationen finden Sie unter Anforderungen an die Lambda-Funktion.

  • Python Version 3.7 ist auf dem Core-Gerät installiert und der PATH-Umgebungsvariablen hinzugefügt.

  • Die Greengrass-Geräterolle muss die cloudwatch:PutMetricData Aktion zulassen, wie in der folgenden Beispiel-IAM-Richtlinie gezeigt.

    { "Version": "2012-10-17", "Statement": [ { "Action": [ "cloudwatch:PutMetricData" ], "Effect": "Allow", "Resource": "*" } ] }

    Weitere Informationen finden Sie in der Amazon CloudWatch-Berechtigungsreferenz im Amazon- CloudWatch Benutzerhandbuch.

  • Um Ausgabedaten von dieser Komponente zu erhalten, müssen Sie das folgende Konfigurationsupdate für die Legacy-Abonnement-Routerkomponente (aws.greengrass.LegacySubscriptionRouter) zusammenführen, wenn Sie diese Komponente bereitstellen. Diese Konfiguration gibt das Thema an, in dem diese Komponente Antworten veröffentlicht.

    Legacy subscription router v2.1.xLegacy subscription router v2.0.x
    Legacy subscription router v2.1.x
    { "subscriptions": { "aws-greengrass-cloudwatch": { "id": "aws-greengrass-cloudwatch", "source": "component:aws.greengrass.Cloudwatch", "subject": "cloudwatch/metric/put/status", "target": "cloud" } } }
    Legacy subscription router v2.0.x
    { "subscriptions": { "aws-greengrass-cloudwatch": { "id": "aws-greengrass-cloudwatch", "source": "arn:aws:lambda:region:aws:function:aws-greengrass-cloudwatch:version", "subject": "cloudwatch/metric/put/status", "target": "cloud" } } }
    • Ersetzen Sie region durch die AWS-Region , die Sie verwenden.

    • Ersetzen Sie Version durch die Version der Lambda-Funktion, die diese Komponente ausführt. Um die Version der Lambda-Funktion zu finden, müssen Sie das Rezept für die Version dieser Komponente anzeigen, die Sie bereitstellen möchten. Öffnen Sie die Detailseite dieser Komponente in der AWS IoT Greengrass Konsole und suchen Sie nach dem Schlüssel-Wert-Paar der Lambda-Funktion. Dieses Schlüssel-Wert-Paar enthält den Namen und die Version der Lambda-Funktion.

    Wichtig

    Sie müssen die Lambda-Funktionsversion auf dem Legacy-Abonnement-Router jedes Mal aktualisieren, wenn Sie diese Komponente bereitstellen. Dadurch wird sichergestellt, dass Sie die richtige Lambda-Funktionsversion für die von Ihnen bereitgestellte Komponentenversion verwenden.

    Weitere Informationen finden Sie unter Erstellen von Bereitstellungen.

Endpunkte und Ports

Diese Komponente muss in der Lage sein, ausgehende Anfragen an die folgenden Endpunkte und Ports auszuführen, zusätzlich zu den für den grundlegenden Betrieb erforderlichen Endpunkten und Ports. Weitere Informationen finden Sie unter Zulassen von Gerätedatenverkehr über einen Proxy oder eine Firewall.

Endpunkt Port Erforderlich Beschreibung

monitoring.region.amazonaws.com

443 Ja

Laden Sie CloudWatch Metriken hoch.

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.

3.0.0 - 3.1.0

In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 3.0.0 bis 3.1.0 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Abhängigkeitstyp
Greengrass-Kern >=2.0.0 <3.0.0 Weich
Token-Exchange-Service >=0.0.0 Hart
2.1.2 and 2.1.3

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

-Abhängigkeit Kompatible Versionen Abhängigkeitstyp
Greengrass-Kern >=2.0.0 <2.8.0 Hart
Lambda-Launcher ^2.0.0 Hart
Lambda-Laufzeiten ^2.0.0 Weich
Token-Exchange-Service ^2.0.0 Hart
2.1.1

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

-Abhängigkeit Kompatible Versionen Abhängigkeitstyp
Greengrass-Kern >=2.0.0 <2.7.0 Hart
Lambda-Launcher ^2.0.0 Hart
Lambda-Laufzeiten ^2.0.0 Weich
Token-Exchange-Service ^2.0.0 Hart
2.0.8 - 2.1.0

In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.8 bis 2.1.0 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Abhängigkeitstyp
Greengrass-Kern >=2.0.0 <2.6.0 Hart
Lambda-Launcher ^2.0.0 Hart
Lambda-Laufzeiten ^2.0.0 Weich
Token-Exchange-Service ^2.0.0 Hart
2.0.7

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

-Abhängigkeit Kompatible Versionen Abhängigkeitstyp
Greengrass-Kern >=2.0.0 <2.5.0 Hart
Lambda-Launcher ^2.0.0 Hart
Lambda-Laufzeiten ^2.0.0 Weich
Token-Exchange-Service ^2.0.0 Hart
2.0.6

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

-Abhängigkeit Kompatible Versionen Abhängigkeitstyp
Greengrass-Kern >=2.0.0 <2.4.0 Hart
Lambda-Launcher ^2.0.0 Hart
Lambda-Laufzeiten ^2.0.0 Weich
Token-Exchange-Service ^2.0.0 Hart
2.0.5

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

-Abhängigkeit Kompatible Versionen Abhängigkeitstyp
Greengrass-Kern >=2.0.0 <2.3.0 Hart
Lambda-Launcher ^2.0.0 Hart
Lambda-Laufzeiten ^2.0.0 Weich
Token-Exchange-Service ^2.0.0 Hart
2.0.4

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

-Abhängigkeit Kompatible Versionen Abhängigkeitstyp
Greengrass-Kern >=2.0.0 <2.2.0 Hart
Lambda-Launcher ^2.0.0 Hart
Lambda-Laufzeiten ^2.0.0 Weich
Token-Exchange-Service ^2.0.0 Hart
2.0.3

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

-Abhängigkeit Kompatible Versionen Abhängigkeitstyp
Greengrass-Kern >=2.0.3 <2.1.0 Hart
Lambda-Launcher >=1.0.0 Hart
Lambda-Laufzeiten >=1.0.0 Weich
Token-Exchange-Service >=1.0.0 Hart

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

Konfiguration

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

v3.x
PublishInterval

(Optional) Die maximale Anzahl von Sekunden, die gewartet werden muss, bevor die Komponente Batch-Metriken für einen bestimmten Namespace veröffentlicht. Um die Komponente so zu konfigurieren, dass Metriken veröffentlicht werden, sobald sie sie empfangen, d. h. ohne Stapelverarbeitung, geben Sie an0.

Die Komponente veröffentlicht in , CloudWatch nachdem sie 20 Metriken im selben Namespace oder nach dem von Ihnen angegebenen Intervall erhalten hat.

Anmerkung

Die Komponente gibt nicht die Reihenfolge an, in der Ereignisse veröffentlicht werden.

Dieser Wert kann maximal 900 Sekunden betragen.

Standard: 10 Sekunden

MaxMetricsToRetain

(Optional) Die maximale Anzahl von Metriken für alle Namespaces, die im Speicher gespeichert werden sollen, bevor die Komponente sie durch neuere Metriken ersetzt.

Dieses Limit gilt, wenn das Core-Gerät keine Verbindung zum Internet hat, sodass die Komponente die Metriken puffert, um sie später zu veröffentlichen. Wenn der Puffer voll ist, ersetzt die Komponente die ältesten Metriken durch neuere. Metriken in einem bestimmten Namespace ersetzen nur Metriken im selben Namespace.

Anmerkung

Wenn der Host-Prozess für die Komponente unterbrochen wird, speichert die Komponente keine Metriken. Dies kann beispielsweise während einer Bereitstellung oder beim Neustart des Core-Geräts geschehen.

Dieser Wert muss mindestens 2 000 Metriken betragen.

Standard: 5 000 Metriken

InputTopic

(Optional) Das Thema, das die Komponente abonniert, um Nachrichten zu empfangen. Wenn Sie true für angebenPubSubToIoTCore, können Sie in diesem Thema MQTT-Platzhalter (+ und #) verwenden.

Standard: cloudwatch/metric/put

OutputTopic

(Optional) Das Thema, zu dem die Komponente Statusantworten veröffentlicht.

Standard: cloudwatch/metric/put/status

PubSubToIoTCore

(Optional) Zeichenfolgenwert, der definiert, ob AWS IoT Core MQTT-Themen veröffentlicht und abonniert werden sollen. Unterstützte Werte sind true und false.

Standard: false

UseInstaller

(Optional) Boolescher Wert, der definiert, ob das Installationsskript in dieser Komponente verwendet werden soll, um die SDK-Abhängigkeiten dieser Komponente zu installieren.

Setzen Sie diesen Wert auf , false wenn Sie ein benutzerdefiniertes Skript zum Installieren von Abhängigkeiten verwenden möchten, oder wenn Sie Laufzeitabhängigkeiten in ein vorgefertigtes Linux-Image aufnehmen möchten. Um diese Komponente zu verwenden, müssen Sie die folgenden Bibliotheken, einschließlich aller Abhängigkeiten, installieren und sie dem Standard-Greengrass-Systembenutzer zur Verfügung stellen.

Standard: true

PublishRegion

(Optional) Die AWS-Region , in der CloudWatch Metriken veröffentlicht werden sollen. Dieser Wert überschreibt die Standardregion für das Core-Gerät. Dieser Parameter ist nur für regionsübergreifende Metriken erforderlich.

accessControl

(Optional) Das Objekt, das die Autorisierungsrichtlinie enthält, die es der Komponente ermöglicht, die angegebenen Themen zu veröffentlichen und zu abonnieren. Wenn Sie benutzerdefinierte Werte für InputTopic und angebenOutputTopic, müssen Sie die Ressourcenwerte in diesem Objekt aktualisieren.

Standard:

{ "aws.greengrass.ipc.pubsub": { "aws.greengrass.Cloudwatch:pubsub:1": { "policyDescription": "Allows access to subscribe to input topics.", "operations": [ "aws.greengrass#SubscribeToTopic" ], "resources": [ "cloudwatch/metric/put" ] }, "aws.greengrass.Cloudwatch:pubsub:2": { "policyDescription": "Allows access to publish to output topics.", "operations": [ "aws.greengrass#PublishToTopic" ], "resources": [ "cloudwatch/metric/put/status" ] } }, "aws.greengrass.ipc.mqttproxy": { "aws.greengrass.Cloudwatch:mqttproxy:1": { "policyDescription": "Allows access to subscribe to input topics.", "operations": [ "aws.greengrass#SubscribeToIoTCore" ], "resources": [ "cloudwatch/metric/put" ] }, "aws.greengrass.Cloudwatch:mqttproxy:2": { "policyDescription": "Allows access to publish to output topics.", "operations": [ "aws.greengrass#PublishToIoTCore" ], "resources": [ "cloudwatch/metric/put/status" ] } } }
Beispiel: Aktualisierung der Konfigurationszusammenführung
{ "PublishInterval": 0, "PubSubToIoTCore": true }
v2.x
Anmerkung

Die Standardkonfiguration dieser Komponente enthält Lambda-Funktionsparameter. Wir empfehlen Ihnen, nur die folgenden Parameter zu bearbeiten, um diese Komponente auf Ihren Geräten zu konfigurieren.

lambdaParams

Ein Objekt, das die Parameter für die Lambda-Funktion dieser Komponente enthält. Dieses Objekt enthält die folgenden Informationen:

EnvironmentVariables

Ein Objekt, das die Parameter der Lambda-Funktion enthält. Dieses Objekt enthält die folgenden Informationen:

PUBLISH_INTERVAL

(Optional) Die maximale Anzahl von Sekunden, die gewartet werden muss, bevor die Komponente Batch-Metriken für einen bestimmten Namespace veröffentlicht. Um die Komponente so zu konfigurieren, dass Metriken veröffentlicht werden, sobald sie sie empfangen, d. h. ohne Stapelverarbeitung, geben Sie an0.

Die Komponente veröffentlicht in , CloudWatch nachdem sie 20 Metriken im selben Namespace oder nach dem von Ihnen angegebenen Intervall erhalten hat.

Anmerkung

Die Komponente garantiert nicht die Reihenfolge, in der Ereignisse veröffentlicht werden.

Dieser Wert kann maximal 900 Sekunden betragen.

Standard: 10 Sekunden

MAX_METRICS_TO_RETAIN

(Optional) Die maximale Anzahl von Metriken für alle Namespaces, die im Speicher gespeichert werden sollen, bevor die Komponente sie durch neuere Metriken ersetzt.

Dieses Limit gilt, wenn das Core-Gerät keine Verbindung zum Internet hat, sodass die Komponente die Metriken puffert, um sie später zu veröffentlichen. Wenn der Puffer voll ist, ersetzt die Komponente die ältesten Metriken durch neuere. Metriken in einem bestimmten Namespace ersetzen nur Metriken im selben Namespace.

Anmerkung

Wenn der Host-Prozess für die Komponente unterbrochen wird, speichert die Komponente keine Metriken. Dies kann beispielsweise während einer Bereitstellung oder beim Neustart des Core-Geräts geschehen.

Dieser Wert muss mindestens 2 000 Metriken betragen.

Standard: 5 000 Metriken

PUBLISH_REGION

(Optional) Die AWS-Region , in der CloudWatch Metriken veröffentlicht werden sollen. Dieser Wert überschreibt die Standardregion für das Core-Gerät. Dieser Parameter ist nur für regionsübergreifende Metriken erforderlich.

containerMode

(Optional) Der Containerisierungsmodus für diese Komponente. Wählen Sie aus den folgenden Optionen aus:

  • NoContainer – Die Komponente wird nicht in einer isolierten Laufzeitumgebung ausgeführt.

  • GreengrassContainer – Die Komponente wird in einer isolierten Laufzeitumgebung innerhalb des AWS IoT Greengrass Containers ausgeführt.

Standard: GreengrassContainer

containerParams

(Optional) Ein Objekt, das die Containerparameter für diese Komponente enthält. Die Komponente verwendet diese Parameter, wenn Sie GreengrassContainer für angebencontainerMode.

Dieses Objekt enthält die folgenden Informationen:

memorySize

(Optional) Die Speichermenge (in Kilobyte), die der Komponente zugewiesen werden soll.

Der Standardwert ist 64 MB (65.535 KB).

pubsubTopics

(Optional) Ein Objekt, das die Themen enthält, in denen die Komponente den Empfang von Nachrichten abonniert. Sie können jedes Thema angeben und angeben, ob die Komponente MQTT-Themen von AWS IoT Core oder lokale Veröffentlichungs-/Abonnementthemen abonniert.

Dieses Objekt enthält die folgenden Informationen:

0 – Dies ist ein Array-Index als Zeichenfolge.

Ein Objekt, das die folgenden Informationen enthält:

type

(Optional) Der Typ des Veröffentlichungs-/Abonnement-Messagings, den diese Komponente zum Abonnieren von Nachrichten verwendet. Wählen Sie aus den folgenden Optionen aus:

  • PUB_SUB — Abonnieren Sie lokale Veröffentlichen/Abonnement-Nachrichten. Wenn Sie diese Option wählen, darf das Thema keine MQTT-Platzhalter enthalten. Weitere Informationen zum Senden von Nachrichten von einer benutzerdefinierten Komponente, wenn Sie diese Option angeben, finden Sie unter Lokale Nachrichten veröffentlichen/abonnieren.

  • IOT_CORE – Abonnieren Sie AWS IoT Core MQTT-Nachrichten. Wenn Sie diese Option wählen, kann das Thema MQTT-Platzhalter enthalten. Weitere Informationen zum Senden von Nachrichten von benutzerdefinierten Komponenten, wenn Sie diese Option angeben, finden Sie unter MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core.

Standard: PUB_SUB

topic

(Optional) Das Thema, das die Komponente abonniert, um Nachrichten zu empfangen. Wenn Sie IotCore für angebentype, können Sie in diesem Thema MQTT-Platzhalter (+ und #) verwenden.

Beispiel: Aktualisierung der Konfigurationszusammenführung (Container-Modus)
{ "containerMode": "GreengrassContainer" }
Beispiel: Aktualisierung der Konfigurationszusammenführung (kein Containermodus)
{ "containerMode": "NoContainer" }

Eingabedaten

Diese Komponente akzeptiert Metriken zum folgenden Thema und veröffentlicht die Metriken in CloudWatch. Standardmäßig abonniert diese Komponente lokale Veröffentlichungs-/Abonnementnachrichten. Weitere Informationen zum Veröffentlichen von Nachrichten in dieser Komponente aus Ihren benutzerdefinierten Komponenten finden Sie unter Lokale Nachrichten veröffentlichen/abonnieren.

Ab Komponentenversion v3.0.0 können Sie diese Komponente optional so konfigurieren, dass sie ein MQTT-Thema abonniert, indem Sie den PubSubToIoTCore Konfigurationsparameter auf setzentrue. Weitere Informationen zum Veröffentlichen von Nachrichten in einem MQTT-Thema in Ihren benutzerdefinierten Komponenten finden Sie unter MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core.

Standardthema: cloudwatch/metric/put

Die Nachricht akzeptiert die folgenden Eigenschaften. Eingabenachrichten müssen im JSON-Format vorliegen.

request

Die Metrik in dieser Nachricht.

Das Anforderungsobjekt enthält die metrischen Daten, die an CloudWatch veröffentlicht werden sollen. Die Metrikwerte müssen den Spezifikationen der PutMetricData Operation entsprechen.

Typ: object, der die folgenden Informationen enthält:

namespace

Der benutzerdefinierte Namespace für die Metrikdaten in dieser Anforderung. CloudWatch verwendet Namespaces als Container für Metrikdatenpunkte.

Anmerkung

Sie können keinen Namespace angeben, der mit der reservierten Zeichenfolge beginntAWS/.

Typ: string

Gültiges Muster: [^:].*

metricData

Die Daten für die Metrik.

Typ: object, der die folgenden Informationen enthält:

metricName

Name der Metrik.

Typ: string

value

Der Wert für die Metrik.

Anmerkung

CloudWatch lehnt Werte ab, die zu klein oder zu groß sind. Der Wert muss zwischen 8.515920e-109 und 1.174271e+108 (Base 10) oder 2e-360 und 2e360 (Base 2) liegen. unterstützt CloudWatch keine speziellen Werte wie NaN, +Infinityund -Infinity.

Typ: double

dimensions

(Optional) Die Dimensionen für die Metrik. Dimensionen liefern zusätzliche Informationen über die Metrik und ihre Daten. Eine Metrik kann bis zu 10 Dimensionen definieren.

Diese Komponente enthält automatisch eine Dimension mit dem Namen coreName, wobei der Wert der Name des Core-Geräts ist.

Typ: array der Objekte, die jeweils die folgenden Informationen enthalten:

name

(Optional) Der Dimensionsname.

Typ: string

value

(Optional) Der Dimensionswert.

Typ: string

timestamp

(Optional) Die Zeit, zu der die Metrikdaten empfangen wurden, ausgedrückt in Sekunden in Unix-Epochenzeit.

Standardmäßig ist dies der Zeitpunkt, zu dem die Komponente die Nachricht empfängt.

Typ: double

Anmerkung

Wenn Sie zwischen den Versionen 2.0.3 und 2.0.7 dieser Komponente verwenden, empfehlen wir, den Zeitstempel für jede Metrik separat abzurufen, wenn Sie mehrere Metriken aus einer einzigen Quelle senden. Verwenden Sie keine Variable, um den Zeitstempel zu speichern.

unit

(Optional) Die Einheit der Metrik.

Typ: string

Gültige Werte: Seconds, Microseconds, MillisecondsBytes, Kilobytes, MegabytesGigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, , Gigabytes/Second, , Terabytes/Second, Kilobits/Second, Bits/Second, Megabits/Second, , , Gigabits/Second, , , Terabits/Second, Count/Second, None

Standardeinstellung: None.

Anmerkung

Alle Kontingente, die für die CloudWatch PutMetricData API gelten, gelten für Metriken, die Sie mit dieser Komponente veröffentlichen. Die folgenden Kontingente sind besonders wichtig:

  • Limit von 40 KB für die API-Nutzlast

  • 20 Metriken pro API-Anforderung

  • 150 Transaktionen pro Sekunde (TPS) für die PutMetricData-API

Weitere Informationen finden Sie unter -CloudWatch Servicekontingente im CloudWatch -Benutzerhandbuch.

Beispieleingabe
{ "request": { "namespace": "Greengrass", "metricData": { "metricName": "latency", "dimensions": [ { "name": "hostname", "value": "test_hostname" } ], "timestamp": 1539027324, "value": 123.0, "unit": "Seconds" } } }

Ausgabedaten

Diese Komponente veröffentlicht Antworten standardmäßig als Ausgabedaten zum folgenden lokalen Veröffentlichungs-/Abonnementthema. Weitere Informationen zum Abonnieren von Nachrichten zu diesem Thema in Ihren benutzerdefinierten Komponenten finden Sie unter Lokale Nachrichten veröffentlichen/abonnieren.

Sie können diese Komponente optional für die Veröffentlichung in einem MQTT-Thema konfigurieren, indem Sie den PubSubToIoTCore Konfigurationsparameter auf setzentrue. Weitere Informationen zum Abonnieren von Nachrichten zu einem MQTT-Thema in Ihren benutzerdefinierten Komponenten finden Sie unter MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core.

Anmerkung

Komponentenversionen 2.0.x veröffentlichen Antworten standardmäßig als Ausgabedaten für ein MQTT-Thema. Sie müssen das Thema als subject in der Konfiguration für die Legacy-Abonnement-Routerkomponente angeben.

Standardthema: cloudwatch/metric/put/status

Beispielausgabe: Erfolg

Die Antwort enthält den Namespace der Metrikdaten und das RequestId Feld aus der CloudWatch Antwort.

{ "response": { "cloudwatch_rid": "70573243-d723-11e8-b095-75ff2EXAMPLE", "namespace": "Greengrass", "status": "success" } }
Beispielausgabe: Fehler
{ "response" : { "namespace": "Greengrass", "error": "InvalidInputException", "error_message": "cw metric is invalid", "status": "fail" } }
Anmerkung

Wenn die Komponente einen Fehler erkennt, der erneut versucht werden kann, z. B. einen Verbindungsfehler, wiederholt sie die Veröffentlichung im nächsten Batch.

Lizenzen

Diese Komponente umfasst die folgende Software/Lizenzierung von Drittanbietern:

Diese Komponente wird gemäß dem Greengrass Core Software License Agreement veröffentlicht.

Lokale Protokolldatei

Diese Komponente verwendet die folgende Protokolldatei.

Linux
/greengrass/v2/logs/aws.greengrass.Cloudwatch.log
Windows
C:\greengrass\v2\logs\aws.greengrass.Cloudwatch.log
So zeigen Sie die Protokolle dieser Komponente an
  • Führen Sie den folgenden Befehl auf dem Core-Gerät aus, um die Protokolldatei dieser Komponente in Echtzeit anzuzeigen. Ersetzen Sie /greengrass/v2 oder C:\greengrass\v2 durch den Pfad zum AWS IoT Greengrass Stammordner.

    Linux
    sudo tail -f /greengrass/v2/logs/aws.greengrass.Cloudwatch.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.greengrass.Cloudwatch.log -Tail 10 -Wait

Änderungsprotokoll

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

v3.x

Version

Änderungen

3.1.0

Fehlerbehebungen und Verbesserungen

3.0.0

Diese Version der CloudWatch Metrikkomponente erwartet andere Konfigurationsparameter als Version 2.x. Wenn Sie eine nicht standardmäßige Konfiguration für Version 2.x verwenden und ein Upgrade von v2.x auf v3.x durchführen möchten, müssen Sie die Konfiguration der Komponente aktualisieren. Weitere Informationen finden Sie unter CloudWatch Konfiguration der Metrikkomponente .

Neue Features
  • Fügt Unterstützung für -Core-Geräte hinzu, auf denen Windows ausgeführt wird.

  • Ändert den Komponententyp von einer Lambda-Komponente in eine generische Komponente. Diese Komponente hängt jetzt nicht mehr von der Legacy-Abonnement-Routerkomponente ab, um Abonnements zu erstellen.

  • Fügt einen neuen InputTopic Konfigurationsparameter hinzu, um das Thema anzugeben, das die Komponente abonniert, um Nachrichten zu empfangen.

  • Fügt einen neuen OutputTopic Konfigurationsparameter hinzu, um das Thema anzugeben, zu dem die Komponente Statusantworten veröffentlicht.

  • Fügt einen neuen PubSubToIoTCore Konfigurationsparameter hinzu, um anzugeben, ob AWS IoT Core MQTT-Themen veröffentlicht und abonniert werden sollen.

  • Fügt den neuen UseInstaller Konfigurationsparameter hinzu, mit dem Sie optional das Installationsskript deaktivieren können, das Komponentenabhängigkeiten installiert.

Fehlerbehebungen und Verbesserungen

Fügt Unterstützung für doppelte Zeitstempel in Eingabedaten hinzu.

v2.x

Version

Änderungen

2.1.3

Version für Greengrass-Kern Version 2.11.0 aktualisiert.

2.1.2

Version für Greengrass-Kern Version 2.7.0 aktualisiert.

2.1.1

Version für Greengrass-Kern Version 2.6.0 aktualisiert.

2.1.0

Neue Features

2.0.8

Fehlerbehebungen und Verbesserungen
  • Fügt Unterstützung für doppelte Zeitstempel in Eingabedaten hinzu.

  • Version für Greengrass-Kern Version 2.5.0 aktualisiert.

2.0.7

Version für Greengrass-Kern Version 2.4.0 aktualisiert.

2.0.6

Version für Greengrass-Kern Version 2.3.0 aktualisiert.

2.0.5

Version für Greengrass-Kern Version 2.2.0 aktualisiert.

2.0.4

Version für Greengrass-Kern Version 2.1.0 aktualisiert.

2.0.3

Erste Version

Weitere Informationen finden Sie auch unter